⚡ 配置生成器
选择客户端、填入 MCP 服务实际地址，自动生成全局 MCP 配置。
下方地址 127.0.0.1 是占位符——请替换为你的 MCP 服务实际地址！
本页所有配置 / 验证命令 / 完整指令中的
127.0.0.1 均需在实际使用时替换为真实 MCP 服务所在的主机 IP（如云服务器公网 IP、内网 IP 或本机回环地址）。
✓ 全局（所有项目可用）
写入位置
~/.codebuddy/.mcp.json
① 端点信息
4 个 MCP 端点（端口 9000），对接 BIP jiaofu1 测试环境。下表中 127.0.0.1 为占位地址，实际使用时替换为 MCP 服务所在主机 IP。
| 名称 | URL | 验证期望 serverInfo |
|---|
② 最重要的坑（配置前必读）
📌 环境说明：jiaofu1 测试环境（非生产）
本配置对应的 BIP 环境是
jiaofu1 测试环境（租户 kr1xgu5q）。所有通过这些 MCP 端点查询/操作的数据均为测试数据：单据、档案、报表等都是模拟的，不代表真实业务数据。适合用于：开发调试、接口验证、功能演示、Agent 能力测试。请勿用于任何真实业务操作。
4 个端点的 URL 路径里都带 /sse/，但实际协议是 MCP 新版 Streamable HTTP（protocolVersion 2025-03-26），不是旧版 SSE。 /sse/ 只是历史命名残留，不代表协议。
铁律（违反即 400 失败）
- 协议字段必须表明是 Streamable HTTP：WorkBuddy / Claude Code 用
"type": "http"；OpenClaw 用"transport": "streamable-http"（注意是 transport 不是 type）。 - 这是远程 HTTP 服务，不能用
command/args（stdio）形式配置。 - 服务无需鉴权（无 token、无 API Key）。
- 配成 SSE 会返回 400 Bad Request——这是唯一需要警惕的坑。
③ 执行步骤
1
确认客户端
配置为全局 MCP（所有项目可用），无需询问作用域。只需确认客户端类型：WorkBuddy / OpenClaw / Claude Code。若用户已在对话中说明，直接采用。
2
读取并合并现有配置（禁止覆盖）
这是硬要求：必须先读取目标配置，把 4 个 server 合并进现有配置，保留已有的其它 server。
- 文件式（WorkBuddy / Claude Code）：先 Read 目标文件，合并进
mcpServers，保留已有 server。不要 Write 整体覆盖。 - CLI 式（OpenClaw）：用
openclaw mcp set逐个添加，天然是合并语义。可先openclaw mcp list查重。 - 重复处理：同名且配置一致→告知"已配置过"；配置不同（旧地址/被误配成 SSE）→说明差异，以本指令为准覆盖并说明改动。
3
写入配置
使用上方「配置生成器」生成的内容，按客户端对应格式写入。不要改协议、不要改地址。
4
验证连通性
对 4 个端点逐一发 POST 请求验证（见下方验证区）。4 个端点都应返回 HTTP 200。
5
告知生效条件并总结
明确告知用户：需要重启客户端让 MCP 配置加载。重启后 4 个工具会出现在可用工具列表中。最后用表格总结：客户端类型、配置位置、4 个端点及各自验证结果（✅/❌）。
④ 连通性验证
对 4 个端点逐一 POST initialize 请求，期望全部返回 HTTP 200。
curl 验证模板（<endpoint> 依次替换为 4 个端点）
异常处理
- 400 Bad Request → 协议配错了（配成了 SSE）。回去检查协议字段：WorkBuddy/Claude Code 应是
type: http；OpenClaw 应是transport: streamable-http。 - 连接超时/拒绝 → 检查
127.0.0.1是否已替换为真实 MCP 服务地址、网络/防火墙是否放行 9000 端口。
📜 完整指令（给 Agent 用）
下面是完整可执行指令全文。AI Agent 读取本页后可直接按此执行。也可手动复制粘贴到任意客户端对话框。