Claude Code 任务看板：用 MCP 两分钟真正配好

要给 Claude Code 配一块任务看板，只需运行一条命令 claude mcp add --transport http weft https://letsweft.com/api/mcp，然后在 Claude Code 第一次连接时，在浏览器里登录 Weft。没有密钥要复制，也没有东西要粘进配置文件。之后，在 CLAUDE.md 里加一小段规则，就能让 Claude Code 在改代码之前先认领任务，干活时汇报进度，完成时留下一张回执。

Weft 是我们做的。关于其他产品的事实来自它们的官方页面，核对于 2026年10月27日。

看板能给 Claude Code 什么终端给不了的东西？

Claude Code 了解眼前的代码仓库，但不知道还有谁在干活，也不知道某个崩掉的会话之前开始了哪个任务。看板把这些状态保存在任何单个会话之外，所以一个人、第二个 Claude Code 窗口和一个 ChatGPT 对话看到的是同一份内容。

不是每个仓库都需要看板。一个人、一次短会话、一份 TODO 清单，往往就够了。当工作跨越多个会话或多个智能体，或者结果要先经人过目才算数时，看板才开始体现价值。

怎么在两分钟内把 Claude Code 连到 Weft？

1. 在 letsweft.com 注册一个免费账号。新看板默认有四列：Backlog、Todo、Doing 和 Done。
2. 在终端里运行 claude mcp add --transport http weft https://letsweft.com/api/mcp。Claude Code 会为当前项目保存这个服务器；如果想在所有项目里都能用，加上 --scope user（参见 Anthropic 的 Claude Code MCP 文档）。
3. 启动 claude。第一次用到 Weft 时，会弹出一个浏览器窗口进行 OAuth。如果没有弹出，输入 /mcp，选择 weft，从那里完成认证。
4. 在 Weft 的授权页面上，选择这个连接能做什么：full、write（除三个破坏性工具之外的全部）或 read。之后可以在设置 → 已连接的 AI 客户端里修改。
5. 回到 Claude Code，问它：“我的看板上有什么？”

这个端点通过 Streamable HTTP 使用 MCP 协议，提供 32 个工具。Weft 发放刷新令牌，客户端会自己续期登录。如果你用的客户端做不了 OAuth，也可以用个人访问令牌，但 Claude Code 不需要。完整的设置页面在 letsweft.com/claude-code。

怎么在不让它改任何东西的前提下确认能用？

第一条提示只做只读操作。这样你就能知道工具已经加载、登录进的是正确的工作区，而看板上什么都不会动：

列出我的 Weft 看板：有哪些列，Doing 里有什么，有什么在等我处理。
什么都别改。

Claude Code 应该会调用 get_board_state 或 get_my_work。两个都是只读工具。如果你想在适应期留点安全余量，就在授权页面上把连接设为 read：写入调用会被拒绝，而被拒绝的调用不计入你的月度额度。

坦白说有一个代价：32 个工具定义大约占用 Claude Code 18,000 个 token 的上下文。

一个被认领的任务是什么样的？

在 Todo 里放一个小而真实的任务，比如“修好那个时好时坏的日期测试”，然后让 Claude Code 去接。一次顺利的运行是这样的：

1. get_my_work 返回这个客户端手上已有的任务、在等你处理的事，以及还有没有余量开始新任务。
2. start_task 认领任务，把它移到 Doing，并返回 runId 和 leaseToken。响应里还会告诉智能体每 300 秒续租一次。
3. Claude Code 照常在仓库里干活。每隔几分钟，它调用一次 report_progress，给租约续期。
4. 如果遇到只有你能做的决定，它会带着选项调用 request_input。Claude Code 用它原生的选项卡片展示这个问题；答案通过 submit_answer 传回去。
5. complete_task 结束这次运行，附上结果、产物（比如提交哈希和测试输出），以及它没做的部分。

默认情况下，完成的任务直接进 Done。当任务需要审阅，或验证检查没通过时，它会停在你的收件箱里。你在那里选择“接受”、“返工”、“以后再说”或“放弃”。如果智能体传了一个 nextStep，比如“合并 PR #12”，“接受”批准的就恰好是这一步，它会回到智能体那里去执行。

完整的循环，包括每一种拒绝和每一个字段，见认领循环指南。

CLAUDE.md 里该写什么？

这些规则工具描述里已经写了；在 CLAUDE.md 里加几行，能让它们成为这个仓库的习惯。粘贴后按需调整：

## Weft 任务看板

Weft（MCP 服务器 "weft"）是这个仓库共用的看板。其他 AI 客户端
和人也会读它，所以要让它保持真实。

- 每次会话开始时，调用 get_my_work。按它返回的内容干活；
  不要凭记忆挑任务。
- 为某个任务改任何文件之前，先用它的 id 调用 start_task。
  保存它返回的 runId 和 leaseToken。
  - already_claimed：别人正在做。不要重复；换一个任务。
  - attention_queue_full：不要重试。照响应里的建议去做
    （完成或澄清已有的工作）。
- 干活期间，大约每 5 分钟用 runId 和 leaseToken 调用一次 report_progress，
  每到一个真正的节点（测试通过、PR 已开）也调用一次。
- 只在必须由人做的决定上调用 request_input：任何不可逆的事
  （生产环境、钱、发布、删除数据），或者没有合理默认值的真正岔路。
  给出选项。永远不要为“能不能继续”征求许可。
- 完成后，调用 complete_task，附上：
  - outcome：用一两句话说明改了什么
  - artifacts：提交哈希、PR 链接、测试命令及其结果
  - notDone：你跳过或留到以后的部分
  - unknowns：你没能验证的部分
  - nextStep：如果对方接受，你会做的那一步
- 如果没做完就停下，要说明，并把任务留在 Doing。

产物能把“做完了”变成可以核查的东西。这个调用永远不会因为缺少证据而失败，因为丢掉已完成的工作，比把它记成未经验证更糟。

Claude Code 会话在任务中途挂了会怎样？

不需要任何东西去善后。认领是租约，不是标记。start_task 给 20 分钟，每次 report_progress 都会续期。崩溃、断网或被关掉的会话没法汇报，所以沉默本身就是信号。

• 20 分钟没有心跳，这次运行就会被标记为过期，租约令牌被清除，任务回到未分配状态。
• 每 10 分钟有一次清扫，而当另一个客户端尝试认领时，任务也会立即被释放。
• 在等你回答的运行会保留认领 60 分钟。之后租约失效，但问题仍留在你的收件箱里。
• 认领由数据库裁定，所以两个争抢同一任务的 Claude Code 窗口不可能都赢。输的一方会收到 already_claimed，附带任务的 id 和标题。

同时运行多个智能体的情况，见一块看板上的多个 AI 智能体。

能在 ChatGPT 或手机上看到同一块看板吗？

能。一个端点背后就是一块看板。Weft 是 ChatGPT 里已发布的应用，所有方案都能用，包括免费版（设置），所以你可以问 ChatGPT，Claude Code 昨晚做完了什么。Cursor 一键安装（设置），Codex 用一条配置加 codex mcp login weft（设置）。在 claude.ai 和 Claude Desktop 上，Weft 作为自定义连接器添加。

Weft 还有 iOS 和 Android 应用。当有任务进入你的队列时，手机会收到推送，每个工作区每 10 分钟最多一条，所以就算你不在电脑前，Claude Code 的问题也能找到你。每个 OAuth 客户端都是一个独立的操作者，看板上显示的是它注册时用的名字。

想回头查看智能体做了什么，见我的 AI 智能体到底做了什么？

会出什么问题，怎么解决？

没有登录

如果 Claude Code 报告 weft 需要认证，输入 /mcp，选择 weft，完成认证。如果你在 Weft 的设置 → 已连接的 AI 客户端里断开过这个客户端，它的旧令牌在下一次调用时会被拒绝，那就用同样的方式重新登录。

列表里没有 Weft 的工具

运行 claude mcp list，检查 weft 是否在列表里，地址是否为 https://letsweft.com/api/mcp。除非你添加时用了 --scope user，否则这个服务器只属于当前项目，换一个文件夹可能就没有了。

already_claimed

这是一个答复，不是错误。另一个客户端持有这个任务的有效租约。智能体应该去做别的。如果你知道另一个会话已经挂了，就等一等：租约在 20 分钟内过期，任务就会被释放。

attention_queue_full

有太多已完成或被卡住的工作在等你：单人工作区 5 项，团队 10 项，或者预估审阅时间达到 45 分钟，以先到者为准。提问也算在内。在你清掉一部分收件箱之前，start_task 会一直拒绝。响应里会列出智能体还能做的事（report_progress、get_my_work、get_board_state、search），让它去收尾或整理，而不是开更多新活。

免费方案下调用停了

免费版每月包含 200 次 AI 调用，注册后的前 48 小时不计数。一个每五分钟发一次心跳的长会话会持续消耗调用次数。Pro 取消了上限；参见价格。

这和 TODO.md、GitHub Issues 或 Hypertask 比起来如何？

GitHub 的事实链接到 GitHub 的文档和价格页面；Hypertask 的事实链接到它们的文档。更全面的表格见 MCP 任务管理器对比。

对一个开发者、一个仓库来说，TODO.md 就是正确答案：和代码一起版本管理，不用账号，不用认证。当两个会话同时改它，或者你想在手机上回答一个问题时，它就撑不住了。

如果你的工作本来就是 issue 和 pull request，团队里人人都待在 GitHub 上，GitHub Issues 就是天然的归宿。Weft 没有 GitHub 集成，所以提交和 PR 链接是作为回执上的产物传递的，而不是靠同步。

如果你想要给 hook 和 CI 用的 CLI、REST API、拥有独立身份的服务账号式智能体、内置 AI 功能、时间追踪或键盘优先的应用，Hypertask 是更好的选择。Weft 没有 CLI，没有公开 API，也没有时间追踪。Weft 的不同之处在于：认领、心跳和向人提问都是 Claude Code 直接调用的 MCP 工具，登录是带刷新的 OAuth，而且同一块看板在 ChatGPT 里和两大手机应用商店里都能用。更多内容见我们的 Hypertask 对比。

Claude Code 需要 API 密钥吗？

不需要。Claude Code 在浏览器里用 OAuth 登录，Weft 发放刷新令牌，客户端会自己续期登录。个人访问令牌是给做不了 OAuth 的客户端准备的，Claude Code 用不着。

Claude Code 会不经过我就把任务标成 Done 吗？

默认会：complete_task 会把任务连同回执一起移到 Done。需要审阅的任务，或验证检查没通过的任务，则会停在你的收件箱里，等你选择“接受”、“返工”、“以后再说”或“放弃”。

能阻止 Claude Code 删东西吗？

在授权页面上把连接设为 write，或者之后在设置 → 已连接的 AI 客户端里修改。write 允许除三个破坏性工具（trash_task、archive_done_tasks、complete_sprint）之外的全部操作。read 只允许 11 个只读工具。无论哪种情况，智能体都不能永久删除任务；回收站会保留 30 天，而从回收站还原是 Pro 功能。

除了 Claude，Weft 还要额外收 AI 的钱吗？

不收。Weft 没有 AI 点数：思考发生在 Claude Code 里，用的是你自己的 Claude 方案。Weft 计的是工具调用次数：免费版每月 200 次，Pro 不限，每席位每月 $7 或每年 $60。参见价格。

如果我的任务已经放在 Linear、Jira、Notion 或 Trello 里呢？

所有方案都能免费导入：Linear、Jira 或 Notion 的 CSV 导出文件，或者 Trello 看板的 JSON。Claude Code 也可以用 bulk_create_tasks 一次创建大量任务。

除了 Claude Code，Weft 还能配合其他编程智能体吗？

能。一共有 33 个客户端设置页面，包括 Cursor、Codex 和 ChatGPT。它们都通过同一个端点访问同一块看板。