Agent Skill

thisis

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

AI Agent·yazi测试账号·来自 skill_hub·skillhub.cn ↗
skillhub install @user_7e25a48a/test2213
4.5万 综合热度·2,555 字文档·源站更新 2026-11-14

README 文档

2,555 字

腾讯内部服务 MCP 接入指南

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


前置准备:获取太湖令牌

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

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


方式一:官方远程 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 <你的太湖令牌>"
      }
    }
  }
}

将 <你的太湖令牌> 替换为实际令牌值(例如 taipatxxxxx)。


方式二:本地 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": "<你的太湖令牌>" }
    }
  }
}

服务说明

服务远程 URL功能
iWikihttps://prod.mcp.it.woa.com/appiwikimcp/mcp3读取/搜索/创建 iWiki 文档
工蜂https://prod.mcp.it.woa.com/gongfeng/api/mcp/mcp代码仓库管理、MR、Issue、KM 搜索
TAPDhttps://prod.mcp.it.woa.com/tapdwoa/tapdmcp需求/任务/缺陷管理

使用示例

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 工具

常见问题

问题解决
npm install 超时确认已切换到 mirrors.tencent.com/npm/ 内网源
MCP 调用报 401太湖 PAT 令牌过期,去 https://tai.it.woa.com/user/pat 续期
远程 MCP 连接失败尝试本地 MCP Server 方式
uvx 命令找不到运行 `curl -LsSf https://astral.sh/uv/install.sh \sh` 安装 uv

参考资料

  • 太湖 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

同分类其他技能

查看全部 ›