腾讯内部服务 MCP 接入

解决什么问题

智能体要读取 iWiki 文档、查询 TAPD 需求、管理 工蜂 仓库或 MR 时，通常还要解决内部认证、MCP 端点和服务能力边界三个问题。这份指南把接入路径拆成可执行配置：先拿到太湖 PAT，再按推荐或备选方式注册 MCP。

技能如何工作

核心流程围绕 太湖令牌 与 MCP 配置：

• 在 https://tai.it.woa.com/user/pat 创建个人令牌，令牌形如 tai_pat_xxxxx，且只显示一次。
• 优先使用 官方远程 MCP：在 ~/.workbuddy/mcp.json 配置服务 URL 和 Bearer Token，无需本地依赖即可调用。
• 若远程端点不可用，可改用 本地 MCP Server 作为备选，适合远程连接失败或需要本地调试的场景。

覆盖的服务包括 iWiki 的读取、搜索和创建文档；工蜂 的代码仓库、MR、Issue 与 KM 搜索；TAPD 的需求、任务和缺陷管理。

适用边界与注意点

• 仅面向已具备腾讯内部服务权限的环境，令牌过期会导致 401，需要回到太湖令牌页续期。
• 本地方式涉及内网 npm 源与运行环境，uvx 缺失时需另行补齐 uv，但不属于远程 MCP 的必需条件。
• 不要把 PAT 写入公开仓库或日志；MCP 调用应使用 Bearer Token 并保持端点准确。