MCPのTasksとは?時間のかかる処理を後で受け取る仕組み

MCPのTasksとは?時間のかかる処理を後で受け取る仕組み

AI アプリと外部のツールをつなぐ MCP では、ツールを呼び出すと、サーバーが結果を返すまでクライアントがその場で待つのがふつうの動きです。

数秒で終わる処理なら困りませんが、CI のパイプラインやデータの一括処理のように数分から数時間かかる処理だと、待っている間に接続が切れたり、途中の様子が分からなくなったりします。

MCP の Tasks は、時間のかかる呼び出しをサーバーがすぐ「タスク」として受け付けて ID を返し、クライアントが後からその ID で状態と結果を問い合わせる仕組みです。

2025-11-25 版の仕様で実験的な機能として入り、現行の 2026-07-28 版では仕様の本体から外れて、公式の拡張 io.modelcontextprotocol/tasks に移りました。

版によってメソッドや受け付けの決め方が変わっているので、その違いと Claude Code での扱いが分かると、長い処理を MCP のツールにするときに迷いにくくなります。

MCPとは?AIエージェントと外部ツールをつなぐ標準規格

Tasks が解こうとしている問題

Tasks の元になった提案 SEP-1686 は、ふつうのツール呼び出しの困りごとを 2 つ挙げています。

1 つは、呼び出しの状態をクライアントから問い合わせる方法がなく、サーバー側で呼び出しが落ちていても、応答が来るのかどうか分からないことです。

もう 1 つは、終わった呼び出しの結果を後から取り直す方法がなく、受け取りそこねたら数分かかるツールでも呼び直すしかないことでした。

これまでの回避策は、1 つの処理を「始める」「状態を聞く」「結果を取る」の 3 つのツールに分ける形です。

  • start_long_running_tool: 処理を始めて、ジョブ ID のような目印を返す
  • get_long_running_tool_status: 目印を受け取り、まだ処理中かどうかを返す
  • get_long_running_tool_result: 目印を受け取り、終わっていれば結果を返す

この形では、状態を何度も聞く役目を AI エージェントが担います。

SEP-1686 は、エージェントに問い合わせを繰り返させるのは無駄にコストがかかり、問い合わせるかどうかもプロンプトの書き方頼みになると指摘しています。

ツールの分け方はサーバーごとの決まりなので、ホストのアプリが代わりに問い合わせを引き受けることもできません。

提案には、先にジョブの一覧を取らせないとモデルがジョブ名を作り上げてしまい、その調査に手間取ったという Amazon のチームの例も載っています。

元の提案は SEP-1686 Tasks で読めます。

SEP-1686: Tasks - Model Context Protocol

終わるまで接続を開けたまま待つ形を取らない理由として、公式の拡張の説明は、多くのクライアントや途中の中継がタイムアウトを設けていて、数秒を超える待ちには向かないことを挙げています。

Tasks は「始める・待つ・受け取る」をプロトコルの決まりにして、問い合わせをモデルに頼らずクライアントが受け持てるようにする仕組みです。

現行版での基本の流れ

ここからは、現行の 2026-07-28 版で使う公式の拡張の形で説明します。

まず、クライアントとサーバーの両方が拡張に対応していることを示します。

クライアントはリクエストごとの _meta にある io.modelcontextprotocol/clientCapabilities の extensions に拡張の名前を入れ、サーバーは server/discover の応答で同じ拡張を示します。

server/discover は 2026-07-28 版で加わったメソッドで、サーバーが対応する版や機能を知らせるためのものです。

タスクにできるリクエストは、いまのところ tools/call だけです。

タスクにするかどうかを決めるのはサーバーで、クライアントはリクエストごとに「タスクにしてほしい」とは頼みません。

時間がかかると判断したら、サーバーは本来の結果の代わりに、resultType が "task" の結果を返します。

次の例は、拡張の提案 SEP-2663 に載っている応答です。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "task",
    "taskId": "786512e2-9e0d-44bd-8f29-789f320fe840",
    "status": "working",
    "statusMessage": "The operation is now in progress.",
    "createdAt": "2025-11-25T10:30:00Z",
    "lastUpdatedAt": "2025-11-25T10:40:00Z",
    "ttlMs": 60000,
    "pollIntervalMs": 5000
  }
}

ttlMs はタスクを作ってから保持する時間の目安で、pollIntervalMs は問い合わせの間隔の目安です。

どちらもミリ秒で表し、タスクの途中で値が変わることもあります。

サーバーは、tasks/get でそのタスクを引ける状態になるまで、この応答を返してはいけません。

拡張に対応していると示さなかったクライアントには、サーバーはタスクを返してはいけない決まりです。

タスクにしないと応じられない処理なら、サーバーは -32021(必要なクライアントの capability が足りない)のエラーを返します。

タスクを受け取ったクライアントは、taskId を付けて tasks/get を送り、pollIntervalMs を守りながら、終わるまで状態を問い合わせます。

終わったタスクの tasks/get の応答には result が入っていて、その中身は元の tools/call がその場で返したはずの結果と同じ形です。

サーバーが対応していれば、状態の変化を notifications/tasks で受け取る形も選べますが、既定は問い合わせのほうです。

拡張の全体像は、MCP の公式サイトの Tasks の概要ページ にまとまっています。

Tasks - Model Context Protocol

タスクがとる 5 つの状態

タスクの状態は、次の 5 つのどれかです。

状態意味
working処理している
input_required続けるのにクライアントからの入力が要る
completed終わった(result に結果が入る)
failed実行中に JSON-RPC のエラーが起きた(error に中身が入る)
cancelled終わる前に取り消された

completed・failed・cancelled は終わりの状態で、ここに着いたタスクの状態はもう変わりません。

見落としやすいのは、ツールが isError: true の結果を返した場合も completed に入ることです。

failed を使うのは JSON-RPC のエラーで失敗したときだけ、と拡張の仕様は決めています。

途中で入力が要るとき

処理の途中でユーザーの確認が要るときなどは、サーバーがタスクを input_required にします。

このとき tasks/get の応答には inputRequests が入り、そこにサーバーからクライアントへの問い合わせが並びます。

クライアントはその答えを inputResponses に入れて tasks/update で送り、そのあとも tasks/get で状態を見続けます。

tasks/update の応答は、中身のない受け取りの確認だけです。

inputRequests のキーは 1 つのタスクの中で使い回されないので、同じ問い合わせを 2 回ユーザーに見せないよう、クライアントはキーで重複を省くよう勧められています。

タスク経由で届いた問い合わせも、直接届いたものと同じ信頼の扱いにするよう、仕様は求めています。

途中でユーザーに入力を求める Elicitation そのものは、別の記事で扱いました。

MCPのElicitationとは?途中で入力を求める仕組み

2025-11-25 版との違い

最初に入った 2025-11-25 版の Tasks は、仕様の本体にある実験的な機能でした。

2026-07-28 版の変更点は、これを本体から外して公式の拡張に移し、作りも見直したと説明しています。

項目2025-11-25 版2026-07-28 版(拡張)
置き場所仕様の本体(実験的)公式の拡張 io.modelcontextprotocol/tasks
対応の示し方接続の最初の initialize で tasks を宣言リクエストごとの _meta と server/discover
タスクにするかクライアントが params に task を付けて頼むサーバーがリクエストごとに決める
結果の受け取りtasks/result(終わるまで応答を待たせる)tasks/get の result
途中の入力tasks/result の流れの中でサーバーから届くinputRequests と tasks/update
一覧の取得tasks/listなし
タスクにできるものtools/call と、クライアント側の sampling/createMessage・elicitation/createtools/call だけ
時間の項目名ttl・pollIntervalttlMs・pollIntervalMs

2025-11-25 版では、ツールごとにも execution.taskSupport で "required"・"optional"・"forbidden" のどれかを示していました。

作りを変えた理由として、SEP-2663 は主に次の 3 つを挙げています。

  • サーバーの capability とツールごとの設定の 2 段構えで、先に tools/list を呼ばないとタスクを頼めず、分かりにくく間違えやすかった
  • tasks/result は終わるまで応答を待たせるので長く保つ接続が要り、サーバーからの勝手なリクエストを禁じた別の変更(SEP-2260)とも合わなくなった
  • 誰のタスクまで見せてよいかの範囲を決められない場合があり、tasks/list を安全に提供できなかった

拡張に移したのは、仕様の本体の改定の周期に縛られずに、実装からの声を受けて育てるためです。

SEP-2663 は、拡張が安定して広く使われるようになったら、本体に取り込む考えも示しています。

2025-11-25 版のつもりで作ったサーバーやサンプルは、現行の拡張とメソッドも項目名も合いません。

拡張の仕様では、tasks/result を呼んだクライアントには -32601(メソッドが見つからない)を返し、tools/call に付いてきた task は無視することになっています。

詳しい差分は SEP-2663 Tasks Extension と、MCP 仕様 2026-07-28 版の変更点 で確かめられます。

SEP-2663: Tasks Extension - Model Context Protocol
Key Changes - Model Context Protocol

2025-11-25 版の原文も MCP 仕様 2025-11-25 版の Tasks のページ に残っています。

Tasks - Model Context Protocol

どんな処理に向いているか

公式の拡張の説明は、Tasks が向く場面として次を挙げています。

  • CI のパイプライン、データの一括処理、モデルの学習のように、数分から数時間かかる処理
  • 承認やレビューのように、途中で人の確認を待つ処理
  • クラウドのデプロイや非同期の API のように、もともとジョブ ID で動く外部の仕組みを包むサーバー
  • モバイルや不安定なネットワークのように、接続が切れやすい環境
  • 大量の取り込みや一括更新のように、途中までの進み具合に意味がある処理

SEP-1686 も、AWS Step Functions や CI/CD のパイプラインのような、ワークフロー型の API を包む MCP サーバーを例に挙げていました。

もともとジョブ ID を返す API なら、ジョブを作った時点でタスクを返し、ジョブが終わったらタスクを終える形にそのまま当てはまります。

リクエストを先に預けて、結果を後から取りに行く形は、LLM の Batch API とも似ています。

バッチAPIとは?AIへの大量の依頼を半額で処理する仕組み

Claude Code での扱い

Claude Code のドキュメントには、この拡張を使う「MCP tasks」の節があります。

Claude Code の CLI では MCP tasks がパブリックベータで、v2.1.304 以降が必要です。

タスクになると、サーバーが処理を受け付けた時点でツールの呼び出しが返り、Claude はほかの作業を続けます。

その間、画面の下部に 1 MCP task のような件数が出て、Claude Code がサーバーに状態を問い合わせながら追いかけます。

処理が終わると会話の記録にその旨が出て、Claude が結果を受け取る流れです。

止めたいときは、/tasks でタスクを選んで x を押すか、Claude に頼みます。

ドキュメントにもあるとおり、取り消しを頼んでも、サーバーが処理を終えてしまうことはあります。

呼び出しがタスクになるのは、主に次の条件がそろったときです。

  • サーバーが Tasks に対応している
  • サーバーと 2026-07-28 版で接続している
  • 機能フラグを取りにいくセッションである(Amazon Bedrock のような他社のプラットフォーム経由や、テレメトリーを切った構成は対象外)
  • ターミナルの CLI、Agent SDK、GitHub Actions のどれかで動いている(VS Code の拡張機能とデスクトップアプリは対象外)
  • サブエージェントからではなく、メインの会話からの呼び出しである

対話のない実行で使うには環境変数などの条件が足され、1 回だけの claude -p "<プロンプト>" の実行ではタスクになりません。

リモートのサーバーで動くタスクは Claude Code を終了しても動き続け、同じセッションを再開すると、また追いかけ始める仕組みです。

結果が出るまで Claude を待たせたいときは、CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS を 0 にするか、CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を 1 にします。

条件と動きの詳細は、Claude Code のドキュメント Connect Claude Code to tools via MCP の MCP tasks の節にあります。

Connect Claude Code to tools via MCP - Claude Code Docs

MCP の公式サイトの 拡張の対応表 でも、Tasks の列には Claude Code と Claude(Web)が載っています。

Extension Support Matrix - Model Context Protocol

この表はコミュニティが手入れしているものなので、クライアントごとの対応は、それぞれのドキュメントでも確かめてください。

つまずきやすい点

tasks/cancel は取り消したいという意思を伝えるだけで、サーバーに処理を止める義務はありません。

応答は中身のない受け取りの確認だけで、そのあともタスクが working のまま残ったり、cancelled 以外の終わりの状態になったりすることがあります。

2025-11-25 版では、受け付けた取り消しは cancelled に移すと決めていたので、ここも版で考え方が変わったところです。

結果を取りに行くのが遅れると、もう引けない場合もあります。

サーバーは ttlMs を過ぎたタスクを failed にしたり、消したりしてよいことになっているからです。

クライアントには、タスク ID を消えない場所に保存し、落ちたり再起動したりした後も問い合わせを続けられるようにすることが勧められています。

サーバーの側では、タスク ID の作り方にも決まりがあります。

第三者が当てたり並べたりできないだけの十分なランダムさで作ることと、タスクに関わるリクエストのたびに、そのクライアントがタスクを見てよいかを確かめることが MUST とされています。

HTTP で動かすときは、tasks/get などのリクエストの Mcp-Name ヘッダーにタスク ID を入れることも決まりの一つです。

ロードバランサーが同じタスクのリクエストを、状態を持つサーバーのインスタンスへ振り分けられるようにするためです。

Claude Code でタスクにしたいなら、サーバーが 2026-07-28 版で接続でき、server/discover で拡張を示しているかを先に確かめます。

2026-07-28 版では server/discover の実装がサーバーの MUST になっていて、2025-11-25 版のつもりで作ったサーバーは、Claude Code がタスクにする条件を満たしません。

最後に

MCP の Tasks は、時間のかかるツール呼び出しを、受け付け・問い合わせ・受け取りの決まった流れに乗せる仕組みです。

現行の 2026-07-28 版では公式の拡張になり、タスクにするかをサーバーが決め、結果も途中の入力も tasks/get と tasks/update で扱う形に変わりました。

長い処理を 3 つのツールに分けてモデルに問い合わせさせていたなら、Tasks に寄せると、待つ役目をクライアントに任せられます。

2025-11-25 版の資料もまだ多く残っているので、読むときはどの版の話かを先に確かめてください。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA