AI活用

Claude CodeのMCPタスクとは|長い処理を待たずに進める仕組みと設定【2026年】

編集責任者佐藤翔太株式会社UrakaTA 代表取締役記事はAIが社内の記録から下書きし、別のAIが公式情報で照合、公開後に編集責任者が確認しています。
中央の大きなサーバーの箱が荷物を受け取って作業を続け、手前ではノートPCの前の会社員が待たずに次の書類に取りかかっているイラスト
イラスト:AIで作成

この記事の結論

Claude CodeのMCPタスクは、MCPサーバーが書き出しやビルドなどの長い処理を引き受けた時点でツール呼び出しが返り、Claudeが別の作業を続けられる仕組みです。終わると結果がClaudeに届きます。ターミナルのCLIではv2.1.304以降でパブリックベータです。VS Code拡張とデスクトップアプリのローカルのセッションは対象外で、対象プラン・料金・日本での提供は公式に記載がありません。

目次9項目
  1. Claude CodeのMCPタスクとは:サーバーが長い処理を引き受ける仕組み
  2. 何ができる:待たずに次の作業へ、終われば結果が届く
  3. 誰が使える:CLIはv2.1.304以降のパブリックベータ
  4. 始め方:tasks対応のサーバーをつなぎ、必要なら待たせる設定を足す
  5. 料金・制限:料金の記載はなく、時間の上限は待たせ方で変わる
  6. 注意点:止めてもサーバーの処理が止まるとは限らない
  7. 中小企業での使いどころ(僕の見立て)
  8. まとめ
  9. よくある質問

【無料資料 No.7】「Claude Code、入れて3日で止まってない?」を受け取る →

Claude CodeのMCPタスクは、長い仕事をMCPサーバー側に預けて、Claudeを待ちぼうけにさせない仕組みだと僕は読んでいます。サーバーが書き出しやビルドを受け付けた時点で呼び出しが返り、Claudeは次の作業へ進み、終われば結果が届きます。

この記事は公式情報・公開情報をもとにまとめた解説です。僕の会社で検証していない点は、その旨を書いています。出典はClaude Codeの公式ドキュメント2ページで、確認日は2026年11月21日です。

似た名前の「長い呼び出しの自動バックグラウンド化」との違い、使える条件、待たせる設定、止め方まで公式の書き方に沿って並べます。「長いMCPの処理、待つべき?待たないべき?」という迷いには、注意点と最後の見立ての節で答えます。

Claude CodeのMCPタスクとは:サーバーが長い処理を引き受ける仕組み

ひと言でいうと、MCPサーバーが自分で長い処理を走らせ、Claudeはその完了を待たずに進める仕組みです。公式ドキュメントでは、レポートの書き出しやビルドが例に挙がっています。

中身は、MCPの拡張機能である「MCP tasks extension」に沿ったものだと公式は説明しています。MCPとサーバーの関係そのものは、MCPとは何か、MCPサーバーの仕組みにまとめています。

流れは3段です。Claudeがツールを呼ぶと、サーバーが仕事を受け付けた時点で呼び出しが返ります。Claudeは別の作業を続け、仕事が終わると結果を受け取ります。

2分で切り替わる「自動バックグラウンド化」とは別の仕組み

同じページには、よく似た仕組みがもう1つあります。メイン会話のMCPツール呼び出しが2分を超えても動いていると、バックグラウンドのタスクへ移す機能です。

2つの違いを、公式の記載から表にしました。

比べる点自動のバックグラウンド化MCPタスク
誰が長い処理を抱えるかClaude Code側の呼び出しが待ち続けるMCPサーバーが仕事として引き受ける
いつ切り替わるか呼び出しから2分たっても終わらないとき(既定)サーバーが仕事を受け付けた時点
サーバー側の条件tasks対応は条件に挙がっていない(IDEのサーバーへの呼び出しは移らない)tasksに対応したサーバーだけ
セッションを閉じたら残らないリモートのサーバーなら処理は続き、同じセッションを再開して追える

僕の読みでは、前者はClaude Code側の待ち方の工夫で、後者はサーバーと役割を分ける仕組みです。この記事の主役は後者で、前者は設定の節で必要な範囲だけ触れます。

何ができる:待たずに次の作業へ、終われば結果が届く

できるのは、時間のかかる処理をサーバーに任せたまま、同じ会話で別の作業を進めることです。待ち時間にClaudeが止まらないのが、いちばんの変化だと読んでいます。

進行中は画面の下に件数が出る

公式ドキュメントでは、処理の間は画面下部に「1 MCP task」のような件数が表示されます。Claude Codeはサーバーに状態を問い合わせて、タスクを追い続けます。

/tasks を開くと、サーバーが報告した最新の進み具合を見られます。ここはタスクを止める場所でもあります。

終わると会話に1行が出て、結果はClaudeに渡る

処理が終わると、会話の記録にタスクが完了した旨の1行が出ます。結果そのものは記録には出ずClaudeに渡るので、Claudeに聞いて受け取る形です。

Claudeが手すきのときに結果が届いた場合は、指示がなくてもClaudeがその続きに取りかかる、と公式にあります。

途中でサーバーから質問が来ることもある

動いているタスクが、入力を求める画面(elicitation)を出すことがあります。/tasks を開いている間はその画面が隠れるので、閉じてから答えます。

Claudeに結果を待たせる設定にしていなければ、その画面で Esc を押して後で答えられます。この「後で答える」機能はv2.1.324以降が必要だと書かれています。

誰が使える:CLIはv2.1.304以降のパブリックベータ

MCPタスクはパブリックベータで、Claude Code v2.1.304以降が必要です。ただし、どの画面からでも使えるわけではなく、呼び出しが条件をすべて満たしたときだけタスクになります。

公式が挙げる条件を、要点だけ並べます。

  1. サーバーがtasksに対応している
  2. HTTP・stdio・claude.aiのコネクタのいずれかのサーバーで、プロトコルの版が2026-07-28でつながっている
  3. セッションが機能フラグを取得できる(Amazon Bedrockなど他社経由や、テレメトリーを切った環境は対象外)
  4. Anthropicが、そのセッションの種類でMCPタスクを有効にしている
  5. 呼び出しがメイン会話からで、サブエージェントからではない
  6. 対話のセッションである(Agent SDKや stream-json の実行は、環境変数の条件つきで対象)

4の「セッションの種類」は、公式では次のように分かれています。ターミナルのCLI、Agent SDKのセッション、GitHub Actionsの実行はv2.1.304以降で有効です。

クラウドのセッション(デスクトップアプリから開いたものを含む)は、Anthropicがアカウントや組織に有効にした場合だけです。利用者が設定で有効にしたり、状態を確かめたりはできないと書かれています。

VS Code拡張と、デスクトップアプリのローカルのセッションは対象外です。claude -p "<prompt>" の単発実行も対象外と明記されています。

対象のプランと日本で使えるかは、今回読んだ2ページに記載がありませんでした。地域の制限の文言も見当たらないので、この記事では「未確認」として扱います。

始め方:tasks対応のサーバーをつなぎ、必要なら待たせる設定を足す

公式ドキュメントには、MCPタスクを「有効にする」スイッチの手順はありません。条件を満たしたサーバーとセッションなら、呼び出しが自動でタスクになる書き方です。手順はここで補いません。

利用者が触れる設定として書かれているのは、待たせる設定・止め方・再開の3つです。

Claudeに結果を待たせたいときの環境変数は2つ

結果が出るまで次へ進ませたくないときは、settings.json の env などで次のどちらかを設定する、と公式にあります。

  • CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS を 0:すべてのMCPツール呼び出しを、終わるまで待つ
  • CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を 1:タスクの結果を待つ。ただし自動のバックグラウンド化が有効なら、既定で2分後にバックグラウンドへ移る

2つ目は、短い処理はその場で終わらせ、長い処理だけ手を離す設定です。移った呼び出しはMCPタスクではなく通常のバックグラウンドの呼び出しになり、セッションを閉じると残りません。

公式の例は、1つ目を 0 にする書き方です。

{
  "env": {
    "CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS": "0"
  }
}

環境変数のページでは、CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS の既定は120000(2分)で、v2.1.212以降が必要です。

CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND はv2.1.304以降が必要です。

なお CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 にしても、それだけではMCPタスクを待つようにはならない、と公式は注意しています。

待たせている間に Esc を押すか時間の上限に達すると、呼び出しは終わり、Claude Codeはサーバーにタスクの取り消しを頼む、と公式にあります。

止めるときは /tasks で選んで x

動いているタスクを止めるには、/tasks で選んで x を押すか、Claudeに頼みます。Claude Codeはタスクを追うのをやめ、サーバーに取り消しを頼みます。

Esc ではバックグラウンドのタスクは止まりません。一度止めたタスクは、Claude Codeで追い直せないとも書かれています。

閉じた後に結果を受け取るには、同じセッションを再開する

リモートのサーバーのタスクは、Claude Codeを終了しても動き続けます。追い直すには、claude --resume や claude --continue で、タスクを始めたセッションを対話で再開します。

新しいセッションや --fork-session では追えません。サーバーの名前と接続設定を変えずにおくことも、公式は求めています。

料金・制限:料金の記載はなく、時間の上限は待たせ方で変わる

料金は、今回読んだ2ページのどこにも書かれていませんでした。タスクにすることで利用量の数え方が変わるかどうかも、記載がありません。

時間の上限は、公式にこう書かれています。バックグラウンドに移ったタスクには、Claude Code側の時間の上限が既定でありません。

ただし、サーバーがタスクとして返事をするまでは、呼び出し全体の時間の上限と、無反応の時間の上限がかかります。Claudeに待たせる設定にした場合は、タスクの最後までこれらがかかります。

5分つながらないと表示が出る

サーバーと連絡が取れない状態が続くと、/tasks に状態の表示が出ます。代表的なのが、5分(300秒)再接続しなかったときの表示です。

表示が出ている間も、処理自体はサーバーで続いているかもしれないと公式は書いています。多くの場合の対処は、/mcp からの再接続かサインインです。

注意点:止めてもサーバーの処理が止まるとは限らない

いちばん気をつけたいのは、止める操作の意味です。公式は "Stopping doesn't guarantee the server stops" と書いています(自動バックグラウンド化の節)。

MCPタスクの節でも、サーバーに取り消しを頼んでも、サーバーが最後まで終えることがあるとしています。止めた時点で、仕事の一部がすでに済んでいる可能性もあります。

結果が分からないまま、もう一度呼ぶと二重になりうる

サーバーがタスクのIDを受け付けなくなるなどして、会話に「outcome unknown.」で終わる行が出て、追跡が止まります。この状態で同じツールを呼ぶと、仕事が繰り返されることがあると公式は書いています。

その場合は、呼び直す前にサーバーの別のツールなどで、何が済んだかを確かめるよう案内されています。

stdioのサーバーは、閉じると処理も止まる

手元で動かすstdioのサーバーは、Claude Codeを終了するとプロセスが止まります。/tasks に動き続けると表示されていても、処理が続くとは限りません。

公式は、サーバーの説明に「プロセスを越えて続く」と書かれていない限り、終わるのを待つか、先に /tasks で止めるよう勧めています。

接続設定を変えると追えなくなる

タスクが動いている間にサーバーの名前・URL・コマンド・環境変数などを変えると、再開しても追えないと表示されます。僕の読みでは、設定をチームで共有していると影響が出やすい点です。

共有の設定ファイルの扱いは、.mcp.jsonの置き場所と書き方に分けています。

サブエージェントと単発実行は対象外

サブエージェントからの呼び出しは、タスクにも自動のバックグラウンド化にもなりません。長い処理をサブエージェントに任せる作りでは、この機能の効果は出ない書き方です。

claude -p "<prompt>" の単発実行もタスクを受け取りません。定期実行などで単発の形を使っている場合は、対象外と考えておくのが安全です。

中小企業での使いどころ(僕の見立て)

ここからは事実ではなく、僕の見立てです。僕の会社ではMCPタスクを業務で回した記録がないので、下の場面は一般論として読んでください。

合いそうな場面

効きそうなのは、1回の処理に数分以上かかる重い仕事を、MCP経由でサーバーに頼む場面です。公式の例のレポートの書き出しやビルドが、そのまま当てはまります。

  • 分析ツールから大きなレポートを書き出す間に、Claudeに別の資料の下書きを進めさせたい
  • サイトのビルドや書き出しを走らせつつ、同じ会話で文言の修正を続けたい
  • 夕方に長い処理を頼み、翌朝に同じセッションを再開して結果だけ受け取りたい

ただし、これはつなぐMCPサーバーがtasksに対応していることが前提です。どのサーバーが対応しているかは、各サーバーの説明で確かめる必要があります。

MCP経由で外部サービスの作成機能を呼ぶ例は、DomoAI MCP・CLIで動画や画像を作る設定手順で解説しています。動画の書き出しのような重い処理の頼み方を考えるときの参考になります。

待たせる設定から始めるのが無難だと考えている

僕なら最初は、CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を 1 にして、短い処理はその場で終わらせる形から入ります。結果を見てから次へ進む流れの方が、何が起きたかを追いやすいからです。

書き出しや送信のように、二重に走ると困る処理は特に慎重に扱います。前の節のとおり、止めても止まらない・結果が分からないことがありうるためです。

社内のルールにしておきたいこと

僕なら、タスクが動いている間は「サーバーの設定を変えない」「止めたらサーバー側で結果を確かめる」の2点を先に決めます。どちらも公式の注意書きから出る、手間の小さいルールです。

まとめ

  • Claude CodeのMCPタスクは、MCPサーバーが長い処理を引き受けた時点で呼び出しが返り、Claudeが待たずに作業を続ける仕組み
  • パブリックベータで、ターミナルのCLI・Agent SDK・GitHub Actionsはv2.1.304以降が対象。VS Code拡張とデスクトップアプリのローカルのセッションは対象外
  • 待たせるなら CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS を 0、または CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を 1
  • 止めるのは /tasks で選んで x。ただしサーバーの処理が止まるとは限らない。料金・対象プラン・日本での提供は記載なし
  • 僕なら、待たせる設定から始めて、二重に走ると困る処理には使う前にルールを決めます

よくある質問

Claude CodeのMCPタスクとは何ですか?

MCPサーバーが自分で長い処理を走らせる仕組みです。サーバーが仕事を受け付けた時点でClaudeのツール呼び出しが返るので、Claudeは待たずに作業を続け、処理が終わると結果を受け取ります。公式ドキュメントでは、レポートの書き出しやビルドが例に挙がっています。

MCPタスクはどのバージョンから使えますか?

公式ドキュメントでは、パブリックベータでClaude Code v2.1.304以降が必要です。ターミナルのCLI、Agent SDKのセッション、GitHub Actionsの実行が対象です。後から質問に答える機能はv2.1.324以降が必要です。

VS Codeやデスクトップアプリでも使えますか?

公式ドキュメントでは、VS Code拡張とデスクトップアプリのローカルのセッションでは使えません。クラウドのセッションは、Anthropicがアカウントや組織に有効にした場合だけ使えます。claude -p の単発実行やAmazon Bedrockなど他社経由の利用も対象外です。

Claudeに結果を待たせたいときはどうしますか?

settings.json の env などで環境変数を設定します。CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS を0にするとすべてのMCPツール呼び出しを最後まで待ちます。CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を1にするとタスクの結果を待ちますが、既定では2分たつとバックグラウンドへ移ります。

MCPタスクに料金はかかりますか?

2026年11月21日時点で、公式ドキュメントのMCPのページと環境変数のページには、料金・対象プラン・日本での提供についての記載がありません。この記事では未確認として扱っています。

引用元・参考にした記事

  1. Connect Claude Code to tools via MCP出典Claude Code Docs参照
  2. Environment variables出典Claude Code Docs参照