Claude Code のタスクボード: MCP で本当に2分で終わる設定

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 が知っているのは目の前のリポジトリで、ほかに誰が作業しているか、クラッシュしたセッションがどのタスクを始めていたかは知りません。ボードはその状態をどのセッションの外にも保つので、人も、2つ目の Claude Code のウィンドウも、ChatGPT のチャットも、同じものを見ます。

すべてのリポジトリに必要なわけではありません。1人で、短いセッション一回、TODO リスト一つで足りることも多いです。ボードが元を取り始めるのは、仕事が複数のセッションや複数のエージェントにまたがるとき、あるいは結果を人が見てからでないと完了と認められないときです。

Claude Code を2分で Weft につなぐには

1. letsweft.com で無料アカウントを作ります。新しいボードは Backlog、Todo、Doing、Done の4カラムで始まります。
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（破壊的な3つのツール以外すべて）、read のいずれかです。後から Settings → 接続中の 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トークンを使います。

確保されたタスク一つは、どんな流れになるか

小さくて本物のタスク、たとえば「不安定な日付のテストを直す」を 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 に進みます。タスクにレビューが必要なとき、あるいは検証チェックに落ちたときは、代わりにインボックスで止まります。そこで承認、差し戻し、あとで、取りやめのどれかを選びます。エージェントが「PR #12 をマージする」のような nextStep を渡していれば、承認はまさにその一歩を承認し、それがエージェントに戻って実行されます。

すべての拒否と項目を含むループの全体は、確保のループのガイドにあります。

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: 何が変わったかを1〜2文で
  - artifacts: コミットのハッシュ、PR の URL、テストのコマンドとその結果
  - notDone: 飛ばしたこと、後回しにしたこと
  - unknowns: 確かめられなかったこと
  - nextStep: 本人が承認したら取る一歩
- 終わらせずに止める場合はそう伝え、タスクは Doing に残す。

成果物があると、「終わった」が確かめられるものに変わります。証拠がなくてもこの呼び出しは失敗しません。終わった仕事を失うほうが、未検証のまま記録するより悪いからです。

Claude Code のセッションがタスクの途中で落ちたらどうなるか

後始末は何もいりません。確保はフラグではなくリースです。start_task は20分を与え、report_progress のたびにそれが更新されます。クラッシュした、ネットワークを失った、閉じられたセッションは報告できないので、沈黙が合図になります。

• ハートビートがないまま20分たつと、実行は stale と記録され、リーストークンは消され、タスクは未割り当てに戻ります。
• 掃除は10分ごとに走り、別のクライアントが確保しようとしたときにもタスクはすぐに解放されます。
• あなたの答えを待っている実行は、60分間確保を保ちます。その後リースは外れますが、質問はインボックスに残ります。
• 確保はデータベースが判定するので、同じタスクを奪い合う2つの Claude Code ウィンドウが両方勝つことはありません。負けたほうには、タスクの id とタイトル付きで already_claimed が返ります。

複数のエージェントを同時に動かす方法は、1つのボードで複数の AI エージェントを動かすで扱っています。

同じボードを ChatGPT やスマホから見られるか

見られます。一つのエンドポイントの裏にある一つのボードです。Weft は Free を含むすべてのプランで ChatGPT の公開アプリなので（設定）、Claude Code が夜のうちに何を終えたかを ChatGPT に尋ねられます。Cursor はワンクリックで入り（設定）、Codex は設定項目と codex mcp login weft を使います（設定）。claude.ai と Claude Desktop では、Weft をカスタムコネクタとして追加します。

Weft には iOS と Android のアプリもあります。タスクがあなたのキューに入るとスマホにプッシュが届きます（ワークスペースごとに10分に最大1回）。だから Claude Code からの質問は、机を離れていても届きます。OAuth クライアントはそれぞれが別の行為者で、ボードには登録時の名前が表示されます。

エージェントがしたことを読み返す方法は、AI エージェントは何をしたのかをご覧ください。

うまくいかないときと、その直し方

サインインしていない

Claude Code が weft には認証が必要だと報告したら、/mcp と入力し、weft を選んで認証します。Weft の Settings → 接続中の AI クライアントでそのクライアントを切断していた場合、古いトークンは次の呼び出しで拒否されるので、同じ方法でもう一度サインインしてください。

Weft のツールが一覧に出ない

claude mcp list を実行し、weft が URL https://letsweft.com/api/mcp で登録されているか確かめます。--scope user で追加していなければサーバーはプロジェクトごとなので、別のフォルダでは登録されていないことがあります。

already_claimed

これはエラーではなく答えです。別のクライアントがそのタスクの有効なリースを持っています。エージェントは別の仕事を選ぶべきです。もう一方のセッションが死んでいるとわかっているなら、待ってください。リースは20分以内に切れ、タスクは解放されます。

attention_queue_full

終わった、あるいは止まっている仕事があなたを待ちすぎています。1人のワークスペースで5件、チームで10件、または見積もりでレビュー45分ぶんの、どれか早いほうです。質問も数に入ります。インボックスをいくらか片づけるまで、start_task は断り続けます。応答には、エージェントがまだできること（report_progress、get_my_work、get_board_state、search）が並ぶので、新しく始める代わりに、終わらせたり整えたりできます。

Free プランで呼び出しが止まる

Free には月200回の AI 呼び出しが含まれ、登録後48時間は数えられません。5分ごとにハートビートを送る長いセッションは、着実に呼び出しを使います。Pro なら上限がなくなります。料金をご覧ください。

TODO.md、GitHub Issues、Hypertask と比べると

GitHub についての事実は GitHub のドキュメントと料金ページに、Hypertask についての事実は同社のドキュメントにリンクしています。より広い表は、MCP タスク管理ツールの比較をご覧ください。

開発者1人、リポジトリ一つなら TODO.md が正解です。コードと一緒にバージョン管理され、アカウントも認証もいりません。崩れるのは、2つのセッションが同時に編集するときや、スマホから質問に答えたいときです。

仕事がすでに issue とプルリクエストでできていて、チーム全員が GitHub で暮らしているなら、GitHub Issues が自然な居場所です。Weft には GitHub 連携がないので、コミットや PR のリンクは同期ではなく、記録に添える成果物として運ばれます。

フックや CI のための CLI、REST API、固有の ID を持つサービスアカウントとしてのエージェント、内蔵 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 に削除させないようにできますか？

同意画面で、または後から Settings → 接続中の AI クライアントで、接続を write にしてください。write は破壊的な3つのツール（trash_task、archive_done_tasks、complete_sprint）以外すべてを許します。read は11の読み取り専用ツールだけを許します。どの場合でも、エージェントはタスクを完全には削除できません。ゴミ箱は30日間保持し、ゴミ箱からの復元は Pro の機能です。

Weft は Claude とは別に AI の料金を取りますか？

取りません。Weft には AI クレジットがなく、考えるのはあなた自身の Claude のプランの下で動く Claude Code です。Weft が数えるのはツールの呼び出しで、Free は月200回、Pro は無制限で1席あたり月 ¥1,182 または年 ¥10,000 です。料金をご覧ください。

すでに Linear、Jira、Notion、Trello でタスクを管理しています。

インポートは全プランで無料です。Linear、Jira、Notion の CSV エクスポート、または Trello のボードの JSON。Claude Code は bulk_create_tasks で多数のタスクを一度に作ることもできます。

Weft は Claude Code 以外のコーディングエージェントでも動きますか？

動きます。Cursor、Codex、ChatGPT を含む33のクライアントの設定ページがあります。どれも同じエンドポイントから同じボードに届きます。