1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

2026-10-24 の公式ドキュメント更新:MCP タスクのパブリックベータと環境変数による制御

1
Posted at

この日の更新は、MCP サーバー上で動く長時間ジョブを追跡する「MCP タスク」のパブリックベータ公開を中心に、バックグラウンド処理の挙動を細かく制御する環境変数の定義追加と、OTEL によるサブエージェント追跡の強化が加わった構成です。フックのオンフェイルア動作に関する補足説明も Windows 環境向けに追記されています。

MCP タスク:サーバーが自律実行する長時間ジョブの追跡

レポート生成やビルドのように、MCP サーバー自身が実行する長時間ジョブを「MCP タスク」と呼びます。2026-10-24 時点でパブリックベータとして公開されており、ドキュメントには次のとおり記載されています。

MCP tasks are in public beta in the Claude Code CLI and require Claude Code v2.1.304 or later.

(出典 [1])

(訳:MCP タスクは Claude Code CLI においてパブリックベータ段階にあり、Claude Code v2.1.304 以降が必要です。)

ツール呼び出しはサーバーがジョブを受け付けた時点で Claude に返ります。Claude はその後も作業を続け、フッターには実行中タスク数が表示されます。ジョブが完了するとトランスクリプトにその旨が記録され、結果は Claude に渡ります。Claude がアイドル状態でタスク結果が届いた場合、Claude は自発的に作業を開始します。

停止するには /tasks から対象を選んで x を押すか、Claude に依頼します。Esc キーではバックグラウンドタスクは止まりません。リモートサーバー上のタスクはセッション終了後も動き続けるため、追跡を再開するには同じセッションを --resume で再開する必要があります。

この機能が有効になるには、プロトコルリビジョン 2026-07-28 での接続・フラグフェッチが有効なセッション・対象セッション種別(CLI ターミナル、Agent SDK セッション、GitHub Actions 実行)のすべてが満たされる必要があります。VS Code 拡張機能とデスクトップアプリは 2026-10-24 時点では対象外です。

自動バックグラウンド移行と環境変数による挙動の切り替え

会話中の MCP ツール呼び出しが 2 分間(デフォルト値、2026-10-24 時点)を超えて実行中の場合、Claude Code はセッションをブロックしないようバックグラウンドタスクへ自動移行します。この閾値は CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS(ミリ秒単位)で変更でき、0 に設定すると自動移行が無効になります。インタラクティブセッションで Claude に MCP タスクの結果を待たせたい場合は CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND を 1 に設定します。

CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 に設定すると、Bash・PowerShell・サブエージェントツールからバックグラウンド実行パラメータが取り除かれ、長時間シェルコマンドやサブエージェントのバックグラウンド自動移行も止まります。ただし、ドキュメントには次のとおり記されています。

MCP tasks and the Monitor tool still run in the background

(出典 [3])

(訳:MCP タスクと Monitor ツールはバックグラウンドで動き続けます。)

非インタラクティブ実行(claude -p)では MCP タスクの追跡ができず、自動移行された呼び出しの結果は失われます。追跡を再開するには、claude -p ではなくインタラクティブに --resume で該当セッションを再開する必要があります。

サブエージェント識別子の OTEL 属性追加

OTEL ストリームに agent_id と parent_agent_id が追加されました(Claude Code v2.1.310 以降)。

agent_id : identifier of the subagent that raised the event, such as a3f2c1b4d5e6f7a80

(出典 [4])

(訳:agent_id はイベントを発生させたサブエージェントの識別子で、例えば a3f2c1b4d5e6f7a80 のような値です。)

parent_agent_id はそのサブエージェントを起動した親エージェントの識別子で、メインセッションが発生元の場合は含まれません。あわせて request_id 属性も追加され、ツール呼び出しをその結果が含まれる API レスポンスのイベントと結合できるようになりました。複数のサブエージェントが並行するセッションでのコスト帰属分析や障害調査に役立ちます。

その他の更新

  • hooks ドキュメントに、Git Bash が未インストールの Windows 環境で終了コード 0 または 2 以外がすべて失敗扱いになる動作と、対処としての onFailure および shell 設定の組み合わせ方が追記されました(https://code.claude.com/docs/en/hooks)。

まとめ

今回の更新で運用への影響が大きいのは、MCP サーバーを実装している開発者と、Agent SDK や CI でノンインタラクティブ実行を組んでいる開発者です。MCP タスクが有効になる条件とセッション種別が明文化されたことで、タスクが起動しない場合の原因調査の起点が得られます。また、バックグラウンド処理を制御する環境変数の説明が整備されたことで、長時間 MCP ツール呼び出しの扱いをユースケースに合わせて選択できるようになりました。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-11-01 検証)。

[1] https://code.claude.com/docs/en/mcp
[2] https://code.claude.com/docs/en/headless
[3] https://code.claude.com/docs/en/env-vars
[4] https://code.claude.com/docs/en/monitoring-usage
[5] https://code.claude.com/docs/en/hooks

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?