TAPD MCP Server

tapd-mcp-server 可以把 TAPD 接入 Cursor / VS Code Copilot 等支持 MCP 的工具，让你在 IDE 对话里查询、分析和回填 TAPD bug / 需求。

你不需要 clone 仓库，也不需要手动安装依赖。配置好 MCP 后，客户端会通过 npx 自动拉取并启动服务。

功能概览

查询与分析

• 查询我负责的 bug、需求、迭代和需求关联测试用例。
• 获取 bug / 需求完整上下文，包括描述、复现步骤、评论、附件和图片链接。
• 让 Agent 基于 TAPD 上下文分析问题、生成修复建议或回填草稿。

创建与回填

• 经你确认后，创建 bug / 需求，或更新评论、状态、处理人。
• 使用 tapd_prd_analysis 生成需求宣讲前的简洁研发评估。

安全边界

• 查询类操作只读，不会修改 TAPD 数据。
• 创建、评论回填、状态更新、处理人更新都要求用户明确确认。
• 更新处理人前建议先搜索 TAPD 成员，避免重名或昵称误写。

配置方式

在 MCP 配置文件中添加以下内容，例如 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "mcpServers": {
    "TAPD MCP": {
      "command": "npx",
      "args": ["-y", "tapd-mcp-server"],
      "env": {
        "TAPD_ACCESS_TOKEN": "你的访问令牌"
      }
    }
  }
}

配置项说明

TAPD_ACCESS_TOKEN 是 TAPD 个人访问令牌，必填。获取路径：TAPD 个人设置 → 个人访问令牌。请只放在本机 MCP 配置里，不要提交到代码仓库。

本工具面向「一人负责多个项目」的场景，不再使用单一默认项目配置。列表查询（tapd_list_bugs / tapd_list_stories）不传 workspace_id 时会自动聚合你参与的所有项目并合并结果，每条结果标注所属项目；需要指定项目的操作（详情、写入、上传、按需求过滤等）必须传入 workspace_id——通常直接复用列表结果里的项目 ID，或先用 tapd_list_workspaces 查看你参与的项目。

| 变量 | 说明 | | --- | --- | | TAPD_ACCESS_TOKEN | TAPD access token，必填 |

使用示例

查询 bug

用户：

列出我名下待处理的 bug

Agent 会查询当前登录用户负责的 bug，并返回适合阅读的摘要。默认会聚合你参与的所有项目；结果中会标注每条 bug 所属项目，便于按项目跟进。你也可以继续要求按状态、标题、报告人、创建时间或关联需求过滤，或指定某个项目 ID 只查该项目。

分析并修复某个 bug

用户：

处理 123456

Agent 会先跨项目定位该 bug 所属项目（只给出 bug ID 时无需你提供项目 ID），再获取完整上下文——包括描述、复现步骤、评论、附件和图片链接，然后结合当前代码库给出问题定位和修改建议。是否修改代码由你确认。

多项目说明：详情、写入、上传等需要具体项目的操作都要求 workspace_id。Agent 通常会先用 tapd_list_bugs / tapd_list_stories（跨项目聚合）定位条目、拿到所属项目 ID，再调用这些工具；你也可以直接说明在哪个项目。

批量判断服务端归因并追加处理人

用户：

分析我名下待处理的 bug，哪些更像是服务端原因，并在处理人里添加服务端同学亚勇

Agent 会先查询 bug 详情，再根据现象、接口返回、复现步骤等信息判断疑似服务端问题。更新处理人前会先确认成员身份，最后经你确认后再写回 TAPD。

回填修复结果

用户：

帮我回填 123456 和 123457，对应的 commit 是 a1b2c3d 和 e4f5g6h

Agent 会生成 TAPD 回填草稿。你确认后，才会写入评论、状态或处理人变更。

需求宣讲前研发评估

用户：

使用 tapd_prd_analysis 分析需求 123456，生成需求宣讲前研发评估报告

支持 MCP Prompts 的客户端会自动获得 tapd_prd_analysis。Agent 会获取需求详情，按需查询需求变更、关联测试用例和关联 bug，并结合当前代码库输出简洁清晰的研发评估。

安全确认

• 查询类操作不会修改 TAPD 数据。
• 创建、回填评论、更新状态、更新处理人等写操作，都需要你在对话中明确确认。
• 更新处理人前，Agent 会先搜索并确认 TAPD 成员，避免根据中文名或重名信息误写。
• 处理人更新支持追加和替换。你说“添加、加上、补上”时会倾向追加；你说“改为、替换为、转给”时会倾向替换。

常见问题

运行 npx -y tapd-mcp-server 后没有输出

这是正常现象。tapd-mcp-server 是 stdio MCP Server，通常由 Cursor / VS Code Copilot 等 MCP 客户端启动和连接。

提示缺少项目 ID

列表查询（tapd_list_bugs / tapd_list_stories）不传项目 ID 时会自动跨项目聚合，通常无需提供。其余需要具体项目的操作（详情、写入、上传、按需求过滤等）必须提供 workspace_id：可直接复用列表查询结果里每条记录标注的项目 ID，或先用 tapd_list_workspaces 查看你参与的项目后再指定。

写入 TAPD 前会自动执行吗

不会。写操作必须经过你明确确认后才会执行。