環境変数

MCP_PROTOCOL_NEGOTIATION

v2 MCP クライアント・ランタイムにおいてのみ有効で、MCP プロトコルリビジョン 2026-07-28 を使用するためにサーバーへプロトコル確認を行うかどうかを設定します。

使い方・用途

  • auto を設定すると、HTTP、claude.ai コネクタ、stdio サーバーに対してプロトコル確認を行い、応答がない場合は以前のプロトコルで接続します（SSE や WebSocket は常に以前のプロトコルを使用します）。
  • legacy を設定すると、すべてのサーバーに対してプロトコル確認をスキップします。
  • 設定しない場合、Claude Code v2.1.232 以降では、特定の例外を除き、自動的にプロトコル確認が行われます。
英語原文(公式ドキュメントより)

On the v2 MCP client runtime only, whether Claude Code probes servers for MCP protocol revision 2026-07-28. Set auto to probe HTTP, claude.ai connector, and stdio servers; a server that doesn't answer the probe connects on the earlier protocol instead, as SSE and WebSocket servers always do. Set legacy to skip the probe for every server. Without the variable, Claude Code probes HTTP, claude.ai connector, and stdio servers on Claude Code v2.1.232 or later, with the exceptions the MCP client runtimes section lists. Any other value is ignored with a warning in the debug log. Requires Claude Code v2.1.221 or later

関連ドキュメント

関連する変更履歴

v2.1.274(1件)

Changed
Bedrock、Vertex、Foundry、およびテレメトリ無効化環境で、他の環境と同様に、デフォルトで v2 MCP クライアントと MCP 2026-07-28 交渉を直接 HTTP サーバーに対して使用するように変更した(オプトアウト: MCP_SDK_GENERATION=v1 または MCP_PROTOCOL_NEGOTIATION=legacy)
英語原文を表示
Changed Bedrock, Vertex, Foundry and telemetry-disabled installs to use the v2 MCP client and MCP 2026-07-28 negotiation with direct HTTP servers by default, as other installs already do (opt out: MCP_SDK_GENERATION=v1 or MCP_PROTOCOL_NEGOTIATION=legacy)

変更前

Bedrock、Vertex、Foundry、テレメトリ無効化環境では v1 MCP クライアントが使われ、他の環境と挙動が異なっていた。

変更後

Bedrock、Vertex、Foundry、テレメトリ無効化環境でも、他の環境と同様に v2 MCP クライアントがデフォルトで使われ、直接 HTTP で接続するサーバーとの MCP 2026-07-28 プロトコル交渉が行われる。

ユーザーへの恩恵

Bedrock、Vertex、Foundry、テレメトリ無効化環境でも最新の MCP クライアントの機能を他の環境と同等に利用できるようになる。

関連ドキュメント