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 會發 refresh token，所以客戶端會自己續期登入。如果你用的客戶端不支援 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 用結果、產出物（例如 commit 雜湊值和測試輸出），以及它沒做的部分，結束這次執行。

預設情況下，完成的任務會直接進 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 分鐘、以及每個真正的檢查點（測試通過、開了 PR），
  用 runId 和 leaseToken 呼叫 report_progress。
- 只有在需要人做決定時才呼叫 request_input：任何不可逆的事
  （正式環境、金錢、發布、刪除資料），或沒有合理預設的真正岔路。
  要給選項。絕對不要問能不能繼續。
- 做完時，呼叫 complete_task，並附上：
  - outcome：用一兩句話說明改了什麼
  - artifacts：commit 雜湊值、PR 網址、測試指令和它的結果
  - notDone：你略過或留到之後的部分
  - unknowns：你無法驗證的部分
  - nextStep：如果對方接受，你會做的那一步
- 如果你沒做完就停下來，要說清楚，並把任務留在 Doing。

產出物把「做完了」變成你可以檢查的東西。這個呼叫永遠不會因為缺少證據而失敗，因為弄丟已完成的工作，比把它以未驗證的狀態記錄下來更糟。

Claude Code 的工作階段在任務做到一半時掛掉，會怎樣？

不需要任何東西去收拾殘局。認領是一份租約，不是一個旗標。start_task 給 20 分鐘，每次 report_progress 都會續約。當掉、斷網或被關掉的工作階段沒辦法回報，所以沉默本身就是訊號。

• 20 分鐘沒有心跳後，這次執行會被標為過期，租約權杖被清除，任務回到未指派狀態。
• 每 10 分鐘會掃一次；而當另一個客戶端嘗試認領它時，任務也會立刻被釋出。
• 在等你回答的執行會保留認領 60 分鐘。之後租約會失效，但問題仍然留在你的收件匣裡。
• 認領由資料庫裁定，所以兩個 Claude Code 視窗搶同一個任務時，不可能兩個都贏。輸的那個會拿到 already_claimed，附上任務的 id 和標題。

同時跑好幾個代理人的情況，請看多個 AI 代理人共用一塊看板。

我能從 ChatGPT 或手機看到同一塊看板嗎？

可以。它就是同一個端點背後的同一塊看板。Weft 是 ChatGPT 裡已上架的 App，所有方案都能用，包含免費版（設定），所以你可以問 ChatGPT，Claude Code 昨晚做完了什麼。Cursor 點一下就能安裝（設定），Codex 則用一筆設定加上 codex mcp login weft（設定）。在 claude.ai 和 Claude Desktop 上，Weft 是以自訂連接器加入的。

Weft 也有 iOS 和 Android App。當一個任務進到你的佇列，手機會收到推播，每個工作區每 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 是正確答案：跟程式碼一起做版本控管，不需要帳號，也不需要驗證。當兩個工作階段同時改它，或你想在手機上回答問題時，它就撐不住了。

當你的工作本來就是議題和 pull request，而團隊每個人都住在 GitHub 上時，GitHub Issues 就是自然的歸宿。Weft 沒有 GitHub 整合，所以 commit 和 PR 的連結是以產出物的形式附在收據上，而不是透過同步。

如果你想要給 hook 和 CI 用的 CLI、REST API、擁有自己身分的服務帳號型代理人、內建 AI 功能、時間追蹤或鍵盤優先的 App，Hypertask 是更好的選擇。Weft 沒有 CLI、沒有公開 API，也沒有時間追蹤。Weft 的不同之處在於：認領、心跳和向人提問都是 Claude Code 直接呼叫的 MCP 工具，登入是帶 refresh 的 OAuth，而且同一塊看板在 ChatGPT 裡、也在兩大手機商店裡。更多內容請看我們的 Hypertask 比較。

Claude Code 需要 API 金鑰嗎？

不需要。Claude Code 在瀏覽器裡用 OAuth 登入，而 Weft 會發 refresh token，所以客戶端會自己續期登入。個人存取權杖是給不支援 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 功能。

Weft 會在 Claude 之外另收 AI 的費用嗎？

不會。Weft 沒有 AI 額度：思考發生在 Claude Code 裡，用的是你自己的 Claude 方案。Weft 計算的是工具呼叫：免費版每月 200 次，Pro 不限，每席次每月 $7 或一年 $60。請看定價。

如果我的任務已經放在 Linear、Jira、Notion 或 Trello 裡呢？

所有方案都能免費匯入：Linear、Jira 或 Notion 的 CSV 匯出檔，或 JSON 格式的 Trello 看板。Claude Code 也可以用 bulk_create_tasks 一次建立很多任務。

除了 Claude Code，Weft 還能搭配其他寫程式的代理人嗎？

可以。共有 33 個客戶端設定頁面，包括 Cursor、Codex 和 ChatGPT。它們都透過同一個端點連到同一塊看板。