接入 MCP 服务¶
内部 MCP(PingCode、Axure LLM Wiki)经 MCPJungle 网关
czerp-team-mcp单端点接入;外部 MCP(Gitee/Notion/Figma/钉钉)按角色自配。详见plugins/czerp-mcp-bundle/。
1. 申请令牌¶
向团队负责人申请你的 MCPJungle 个人令牌(每人一个,勿公开分享)。
2. 接入内部网关(一行命令)¶
Claude Code:
claude mcp add --transport http --scope user czerp-team-mcp https://serion.cc/jungle/mcp \
--header "Authorization: Bearer <你的令牌>"
Codex:
export MCPJUNGLE_TOKEN="<你的令牌>" # Windows PowerShell: $env:MCPJUNGLE_TOKEN="<你的令牌>"
codex mcp add czerp-team-mcp --url https://serion.cc/jungle/mcp --bearer-token-env-var MCPJUNGLE_TOKEN
接入后即可用 PingCode(pingcode__*)与 Axure(axure-wiki__*)工具。细节见 internal-gateway.md。
3. 外部 MCP(按角色,自助)¶
| MCP | 谁 | 说明 |
|---|---|---|
| Gitee | 开发/测试/运维 | 个人 PAT;claude mcp add / codex mcp add 同理 |
| Notion | 产品经理 | integration token + 给页面 Add connection |
| Figma / 钉钉 | 产品/设计 | 按平台官方文档 |
4. 重启 / 验证¶
重启或刷新 Agent,提一句:"用 PingCode 拉一下 CZKB 02_5 开发环境说明",能返回内容即接入成功。
5. 故障排查¶
| 现象 | 解决 |
|---|---|
| MCP server failed to start | 看 Agent 日志;令牌/URL 是否正确 |
| 内部 MCP 401 / 看不到工具 | 网关未授权该工具组 → 找团队负责人 |
连不上 serion.cc 网关 |
网络 / VPN(按网关部署)/ 令牌失效 |
| Notion 401 | 未在 Notion 给 integration 添加 page connection |