環境変数

MCP_CONNECTION_NONBLOCKING

非インタラクティブモード（-p）において、MCP接続の待機を完全にスキップするにはtrueに設定します。

使い方・用途

  • MCPツールを必要としないスクリプトやパイプラインにおいて、起動のオーバーヘッドを削減するために使用します。
  • 低速なMCPサーバーへの接続待機（最大5秒）を回避し、CI/CDなどの自動化ツールで処理を素早く開始できます。
英語原文(公式ドキュメントより)

Set to true in non-interactive mode (-p) to skip the MCP connection wait entirely. Useful for scripted pipelines where MCP tools are not needed. Without this variable, the first query waits up to 5 seconds for --mcp-config server connections. Servers configured with alwaysLoad: true always block startup regardless of this variable, since their tools must be present when the first prompt is built

`alwaysLoad: true`

関連する変更履歴

v2.1.89 (1件)

Added
MCP
-p モード用に MCP_CONNECTION_NONBLOCKING=true を追加し、MCP接続の待機を完全にスキップできるようになりました。また、--mcp-config による接続時間を最大5秒に制限しました。
英語原文を表示
Added 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サーバーがあると接続完了まで長時間待機させられ、スクリプトの実行効率が低下していました。

変更後

非ブロッキング接続を選択可能になり、またタイムアウト制限が設けられたことで、低速なサーバーに引きずられることなく素早く処理を開始できるようになりました。

ユーザーへの恩恵

CI/CDや自動化ツールでの利用において、起動のオーバーヘッドが削減され、全体の実行時間が短縮されます。

関連ドキュメント