最初のクエリの前に、起動処理が MCP サーバーの接続完了を待つかどうかを制御する。MCP の起動はデフォルトでノンブロッキングであり、サーバーはバックグラウンドで接続し、完了し次第ツールが利用可能になる。0を設定すると、Claude Code が最初のクエリの前にサーバーの接続を待つようになる。alwaysLoad: true が設定されたサーバーは、ディスカバリーキャッシュから供給される場合を除き、最初のプロンプト構築時にツールが存在している必要があるため、この設定に関係なく起動を待たせる。--input-format stream-json を付けない非対話モード(-p)では、この変数に関係なく、最初のターンの前にまだ接続中のサーバーを待つ。--mcp-config を明示的に渡した場合、待機にはより長い期限が設けられる。キャッシュ済みサーバーの例外についてはそのフラグの項目を参照。
Controls whether startup waits for MCP servers to connect before the first query. MCP startup is non-blocking by default: servers connect in the background and their tools become available as they finish. Set to 0 to make Claude Code wait for servers to connect before the first query. Servers configured with alwaysLoad: true still make startup wait regardless, except when served from the discovery cache, since their tools must be present when the first prompt is built. In non-interactive mode (-p) without --input-format stream-json, Claude Code also waits for still-pending servers before the first turn regardless of this variable. When you pass --mcp-config explicitly, the wait has a longer deadline; see that flag's entry for the cached-server exception
MCP_CONNECTION_NONBLOCKING=0 の際に、MCP_CONNECT_TIMEOUT_MS を無視して claude.ai コネクタへの接続を 1 秒で諦める問題を修正したMCP_CONNECTION_NONBLOCKING=0 giving up on claude.ai connectors after 1s instead of honoring MCP_CONNECT_TIMEOUT_MS-p モードでMCP接続の待ち合わせを完全にスキップする MCP_CONNECTION_NONBLOCKING=true を追加し、さらに --mcp-config で渡したサーバーへの接続待ちを、最も遅いサーバーに引きずられて無期限にブロックする代わりに5秒で打ち切るようにした。MCP_CONNECTION_NONBLOCKING=true for -p mode to skip the MCP connection wait entirely, and bounded --mcp-config server connections at 5s instead of blocking on the slowest server変更後
遅い・応答しないMCPサーバーがあっても起動時間の上限をユーザーが制御でき、headless実行が速く確定的に終わるようになる。