腾讯内部服务 MCP 接入指南

让任意智能体接入 TAPD、iWiki、工蜂三大内部服务的配置指南。

前置准备：获取太湖令牌

1. 访问 https://tai.it.woa.com/user/pat
2. 点击「创建个人令牌」
3. 复制生成的令牌（格式：tai_pat_xxxxx）

⚠️ 注意：令牌只显示一次，请妥善保存。

方式一：官方远程 MCP（推荐）

无需安装任何包，直接配置 URL + Bearer Token 即可使用。

MCP 配置

在 ~/.workbuddy/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "iwiki": {
      "url": "https://prod.mcp.it.woa.com/app_iwiki_mcp/mcp3",
      "headers": {
        "Authorization": "Bearer <你的太湖令牌>"
      }
    },
    "gongfeng": {
      "url": "https://prod.mcp.it.woa.com/gongfeng/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <你的太湖令牌>"
      }
    },
    "tapd": {
      "url": "https://prod.mcp.it.woa.com/tapdwoa/tapdmcp",
      "headers": {
        "Authorization": "Bearer <你的太湖令牌>"
      }
    }
  }
}

将 <你的太湖令牌> 替换为实际令牌值（例如 tai_pat_xxxxx）。

方式二：本地 MCP Server（备选）

如果远程 MCP 不可用，可以使用本地安装方式。

环境准备

# 1. 确认 Node.js >= 18
node -v

# 2. 切换 npm 到腾讯内网源（必须）
npm config set registry https://mirrors.tencent.com/npm/

# 3. 确认 uv 已安装（TAPD 需要）
which uv || curl -LsSf https://astral.sh/uv/install.sh | sh

安装 MCP Server 包

npm install -g @tencent/iwiki-mcp@latest
npm install -g @tencent/tgit-mcp-server@latest
# TAPD 通过 uvx 按需拉取，无需提前安装

MCP 配置

{
  "mcpServers": {
    "iwiki": {
      "command": "npx",
      "args": ["-y", "@tencent/iwiki-mcp@latest"],
      "env": { "IWIKI_TOKEN": "<你的太湖令牌>" }
    },
    "gongfeng": {
      "command": "npx",
      "args": ["-y", "@tencent/tgit-mcp-server@latest"],
      "env": { "TGIT_TOKEN": "<你的太湖令牌>" }
    },
    "tapd": {
      "command": "uvx",
      "args": ["mcp-server-tapd"],
      "env": { "TAPD_TOKEN": "<你的太湖令牌>" }
    }
  }
}

服务说明

使用示例

iWiki - 读取文档

用户：读取这个文档 https://iwiki.woa.com/p/4016401215
助手：调用 getDocument 工具，返回文档内容

TAPD - 查询需求

用户：查看这个需求 https://tapd.woa.com/tapd_fe/70135431/story/detail/1070135431133122643
助手：调用 stories_get 工具，返回需求详情

工蜂 - 查看 MR

用户：帮我看看工蜂项目 xxx 的 MR 列表
助手：调用 search_merge_request 工具

常见问题

参考资料

• 太湖 MCP 统一认证介绍：https://iwiki.woa.com/p/4016401215
• 太湖个人令牌管理：https://tai.it.woa.com/user/pat
• WorkBuddy MCP 配置文档：https://www.codebuddy.cn/docs/workbuddy/Overview

更新时间：2026-03-31