Skip to content
← リリースに戻る · 2.1.319
新機能 / 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

変更の詳細