新機能 / v2.1.319
MCPタスクのバックグラウンド化を無効化する変数
CHANGELOG 原文(英語)
Added the CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND environment variable to make Claude Code wait for an MCP task inside its tool call instead of moving it to the background right away 公式の変更履歴を開く ↗ 日本語での補足
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND環境変数を追加。Claude CodeがMCPタスクを即座にバックグラウンドへ移さず、ツール呼び出し内で待機するようにできる。
ドキュメント
ドキュメントの抜粋(参考訳)
Claude に MCP タスクの結果を待たせる
対話型セッションで Claude にタスクの結果を待たせるには、たとえば settings.json の env ブロックで、次の2つの環境変数のいずれかを設定します。
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MSを0に設定: Claude は、呼び出しが終わるまで、すべての MCP ツール呼び出しを待ちますCLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUNDを1に設定: Claude はタスクの結果を待ちます。自動バックグラウンド化がオンの間は、既定で2分後にその呼び出しをバックグラウンドへ移すため、短いタスクはその場で完了し、長いタスクでブロックされることもありません。移された呼び出しは、MCP タスクではなく通常のバックグラウンド呼び出しになります。セッションを終了すると失われます
Claude が待っている間に Esc を押すか、実時間の上限またはアイドルタイムアウトに達すると、呼び出しは終了し、Claude Code はサーバーにタスクのキャンセルを依頼します。
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 に設定したり、bare モードで起動したりするだけでは、Claude が MCP タスクを待つようにはなりません。次の例では CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS を 0 に設定しているため、Claude はすべての MCP ツール呼び出しを待ちます。
{
"env": {
"CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS": "0"
}
}
取得日 · 2026-11-20