1. 为什么我要把 TAPD MCP 接到 Craft 里TAPD MCP Server 是把腾讯 TAPD 的需求、迭代、缺陷等能力通过 MCPModel Context Protocol协议暴露给 AI 客户端的一套服务。简单说它让 AI 助手能直接读你的需求池、改负责人、生成迭代报告而不是你手动在页面上一条条点。它适合研发团队里的项目经理、技术负责人以及像我这样既要盯迭代又要写代码的人。我之前的痛点很具体迭代复盘靠人工筛。TAPD 页面上批量操作一次最多 100 条还没法叠加复杂过滤条件。比如「把迭代 X 下、开发人员是某人、优先级为中的需求负责人置空并打上离职标签」这种操作页面上得点半天还容易漏。更别提迭代结束后要写复盘报告、发企业微信群、再存一份到 Wiki纯手工流程走下来半小时起步。后来我把 TAPD MCP Server 装进腾讯云代码助手 Craft用对话式指令跑这些流程效率提升非常明显。但这里有个容易被忽略的环节Craft 的模型通道。如果模型请求不稳定MCP 工具调用到一半断了报告生成就会失败。我的做法是把 Craft 的模型 Key 走 TaoTokenBase URL 填https://taotoken.net/api这样模型请求统一走账通道稳定TAPD MCP 的返回结果也能顺利落库。这篇就按「Skill/MCP 视角」把整套配置和实战场景讲清楚你跟着做就能在对话框里跑通需求拆解、迭代监控、批量改负责人这些操作。2. 前置准备TaoToken Key 与 Craft 模型设置先说清楚 TaoToken 在这里的角色。它不是替代 Craft也不是替代 TAPD而是给 Craft 提供一个稳定的模型请求入口。你打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建账号后在控制台生成一把 API Key这把 Key 就是后面填进 Craft 模型设置里的凭证。创建 Key 的入口在控制台的 API Keys 页面路径是 https://taotoken.net/console/api-keys 。生成后复制保存注意别泄露。如果你还没决定用哪个模型可以先去模型对话页面 https://taotoken.net/models 看看当前支持的模型列表选一个适合工具调用Function Calling的模型因为 MCP 场景对模型的指令遵循和工具调用能力有要求。拿到 Key 之后打开 Craft 的模型设置。这里有两个字段要改字段填写内容说明Base URLhttps://taotoken.net/api注意不是官网首页链接也不要加/v1后缀API Key你在 TaoToken 控制台生成的 Key一把 Key 通用后续所有模型请求走这里注意Base URL 填错是最常见的坑。有人习惯性写成https://taotoken.net或者https://taotoken.net/v1都会导致请求 404 或鉴权失败。正确写法就是https://taotoken.net/api。填完之后Craft 的模型通道就通了。你可以先在 Craft 里发一句普通对话测试比如「你好帮我列三个迭代复盘的要点」能正常返回就说明模型通道没问题。这一步过了再往下装 TAPD MCP Server。3. 安装 TAPD MCP Server 并填入凭证Craft 里装 MCP Server 的入口在 MCP 市场。搜索「TAPD」就能找到 TAPD MCP Server点击安装。安装过程中需要填三个字段这三个字段是 TAPD MCP 能干活的前提第一个是 TAPD API 账号。这个在 TAPD 的开放平台里申请登录 TAPD 后进入「开放平台」或「API 设置」页面能看到你的 API 账号通常是一串数字或字母组合。第二个是 TAPD API 密钥。和账号配套生成注意密钥只在生成时显示一次复制保存好。如果丢了就重新生成旧密钥会失效。第三个是企业微信机器人 webhook URL。这个在企业微信群里添加机器人后获取路径是群设置 → 群机器人 → 添加机器人 → 复制 Webhook 地址。格式类似https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyxxxx。把这三个字段填进 TAPD MCP Server 的配置里保存。配置结构大致如下不同版本字段名可能略有差异以 Craft 界面为准{ mcpServers: { tapd: { command: npx, args: [-y, tapd/mcp-server], env: { TAPD_API_USER: 你的TAPD API账号, TAPD_API_PASSWORD: 你的TAPD API密钥, WECOM_WEBHOOK_URL: 你的企业微信机器人webhook } } } }提示如果你用的是 Craft 的图形化安装界面直接在对应输入框填值即可不需要手写 JSON。手写配置适合需要自定义启动参数的场景。装好之后Craft 的对话框里就能调用 TAPD 相关工具了。你可以先发一句「列出我当前参与的迭代」看它能不能返回数据。如果返回空或者报鉴权错误先检查 TAPD API 账号密钥是否正确以及账号是否有对应项目的权限。4. 实战对话式跑通迭代复盘与企微同步配置通了之后真正的价值在场景里。我按原文提到的几个场景结合 TaoToken 通道把可复制的指令写出来。4.1 AI 需求拆解一句话生成迭代和需求以前做一个 AI 诗歌生成小程序我得先构思功能、拉研发沟通技术细节、创建迭代、拆分需求、评估规模点、排期一天就过去了。现在在 Craft 里直接说帮我创建一个迭代名称叫「AI 诗歌生成小程序开发」 周期两周然后拆解出以下需求 1. 用户输入主题生成诗歌 2. 支持选择诗歌风格古风/现代/打油诗 3. 生成结果可保存为图片分享 4. 历史记录查看 每个需求给出规模点评估和优先级建议。Craft 会调用 TAPD MCP 的工具把迭代和需求创建好返回结果给你确认。如果对拆解不满意可以多轮对话调整比如「把第 3 个需求的优先级调高规模点改成 5」。4.2 迭代监控与风险预警迭代进行中我想看进度和未完成需求。指令查看迭代「AI 诗歌生成小程序开发」的进度 列出所有未完成的需求及其处理人。返回结果里如果有逾期风险接着发把未完成需求的处理人拉个群通知提醒他们及时跟进。TAPD MCP 会通过企业微信 webhook 发消息到群里。这一步依赖你前面填的 webhook URL如果没配通知就发不出去。4.3 自动生成迭代复盘报告并双端归档这是原文的核心场景也是我最常用的。迭代结束后在 Craft 里说生成迭代「AI 诗歌生成小程序开发」的复盘报告 内容包括完成需求数、未完成需求及原因、规模点统计、 风险回顾。生成后同步到企业微信群并存入 TAPD Wiki。模型请求经 TaoToken 统一走账返回结果后由 TAPD MCP 把报告存入 Wiki同时通过 webhook 发到企微群。整个过程你只需要在对话框里说一句话剩下的归档和通知自动完成。4.4 批量修改数据绕过页面 100 条限制TAPD 页面批量操作最多 100 条还没法叠加复杂条件。用 MCP 就没这个限制。比如将迭代「AI 诗歌生成小程序开发」下 优先级为「中」且开发人员是 ryanjhzheng 的需求 开发人员字段置空并打上标签「人员已离职」。这种复合条件在页面上很难操作但在对话框里一句话就能跑。TAPD MCP 会先查询符合条件的需求再批量更新字段和标签。5. 常见报错与排查配置和实战过程中我踩过几个坑列出来帮你省时间。报错一模型请求 401 或 403。大概率是 TaoToken Key 填错或过期。去控制台 https://taotoken.net/console/api-keys 重新生成一把替换 Craft 里的 Key。注意 Base URL 必须是https://taotoken.net/api不要带/v1。报错二TAPD MCP 返回鉴权失败。检查 TAPD API 账号和密钥是否匹配以及该账号是否有目标项目的访问权限。TAPD 的 API 权限是跟项目绑定的如果账号不在项目里查不到数据。报错三企业微信通知发不出去。检查 webhook URL 是否完整机器人是否还在群里。如果机器人被移出群webhook 会失效需要重新添加并更新配置。报错四MCP 工具调用超时。这种情况通常是模型通道不稳定。确认 Craft 的模型请求走的是 TaoToken 的 Base URL而不是其他不稳定的入口。如果持续超时可以换一个工具调用能力更强的模型试试。报错五批量修改没生效。检查过滤条件是否写得太宽泛导致匹配到大量需求触发限流。建议先加迭代范围缩小查询再执行修改。注意所有涉及批量修改的指令建议先让 Craft 返回「将要修改的需求列表」给你确认再执行更新。避免条件写错导致误改。6. 把 Key 和 MCP 串起来让流程真正跑通整套流程的核心就两件事一是 Craft 的模型通道走 TaoTokenBase URL 填https://taotoken.net/apiKey 在控制台生成二是 TAPD MCP Server 填好 TAPD API 账号密钥和企业微信 webhook。这两步做完需求拆解、迭代监控、批量改负责人、复盘报告归档这些场景都能在对话框里跑通。如果你主要做长期编码和 Agent 场景可以看看 Coding Plan https://taotoken.net/coding-plan 适合需要稳定模型通道的持续开发。接入文档在 https://taotoken.net/doc 里面有各客户端的配置示例。模型对话入口在 https://taotoken.net/models 可以先试几个模型看哪个工具调用更顺。我现在迭代复盘基本不打开 TAPD 页面了直接在 Craft 里说一句话报告生成、企微通知、Wiki 归档全自动。唯一要盯的就是模型通道别断所以 TaoToken 那把 Key 我一直留着。