MCP_PROTOCOL_NEGOTIATION

環境変数

v2 の MCP クライアントランタイムに限り、Claude Code がサーバーに MCP プロトコルリビジョン 2026-07-28 の対応を問い合わせるかどうかを制御する。legacy に設定すると問い合わせを省略し、すべてのサーバーがそのリビジョン以前のハンドシェイクで接続する。auto に設定すると、問い合わせに対応しているサーバー種別、すなわち HTTP と stdio のサーバー、claude.ai コネクタ、クラウドおよび Remote Control セッションのコネクタに対して問い合わせる。変数が未設定の場合、Claude Code は既定で同じ種別に対して問い合わせる。MCP クライアントランタイムを参照。その他の値は無視され、デバッグログに警告が出力される。Claude Code v2.1.221 以降が必要

使い方・用途

  • v2 MCP クライアントランタイムで、新たな MCP プロトコルリビジョン 2026-07-28 への対応状況をサーバーに確認するプローブをスキップし、すべてのサーバーを旧リビジョン以前のハンドシェイクで接続したいとき、MCP_PROTOCOL_NEGOTIATION=legacy を設定する。
  • 新しいプロトコルリビジョン 2026-07-28 の交渉を無効化したサーバーを運用しており、そのサーバーとの接続を従来のハンドシェイクのまま維持したいときに legacy を設定する。
  • HTTP・stdio サーバーや claude.ai コネクタ、cloud・Remote Control セッションのコネクタなど、プローブに対応した種類のサーバーに対してのみ改めてプローブを行いたいときに auto を設定する。
英語原文

On the v2 MCP client runtime only, controls whether Claude Code probes servers for MCP protocol revision 2026-07-28. Set legacy to skip the probe, so that every server connects with the handshake from before that revision. Set auto to probe the server kinds that support the probe: HTTP and stdio servers, claude.ai connectors, and the connectors of cloud and Remote Control sessions. With the variable unset, Claude Code probes those same kinds by default; see MCP client runtimes. Any other value is ignored with a warning in the debug log. Requires Claude Code v2.1.221 or later

関連ドキュメント

関連する変更履歴

v2.1.299(1件)

クラウドセッションと Remote Control の MCP コネクタが、フラグを取得しないインストール環境ではデフォルトで MCP プロトコルバージョン 2026-07-28 にネゴシエートするように変更した。MCP_PROTOCOL_NEGOTIATION=legacy でオプトアウトできる
英語原文を表示
Changed cloud session and Remote Control MCP connectors to negotiate MCP protocol version 2026-07-28 by default on installs that fetch no flags; MCP_PROTOCOL_NEGOTIATION=legacy opts out

変更後

フラグを取得しない環境でも、クラウドセッションや Remote Control の MCP コネクターが新しい MCP プロトコル (2026-07-28) に対応したサーバーと自動的に最新プロトコルで接続できるようになる。従来の挙動に戻したい場合は環境変数で無効化できる。

関連ドキュメント

v2.1.295(1件)

フラグを取得しないインストール環境で、claude.ai コネクタが MCP プロトコルバージョン 2026-07-28 をデフォルトでネゴシエートするように変更した。MCP_PROTOCOL_NEGOTIATION=legacy でオプトアウトできる
英語原文を表示
Changed claude.ai connectors to negotiate MCP protocol version 2026-07-28 by default on installs that fetch no flags; MCP_PROTOCOL_NEGOTIATION=legacy opts out

変更後

フラグを取得しない環境でも、claude.ai コネクタが新しい MCP プロトコル (2026-07-28) を自動的にネゴシエートして接続できるようになる。従来の動作が必要な場合は MCP_PROTOCOL_NEGOTIATION=legacy を設定することでオプトアウトできる。

関連ドキュメント

v2.1.292(1件)

ローカル(stdio)MCP サーバー接続のプロトコルバージョン交渉を変更:Bedrock、Vertex、Foundry を含むすべてのインストールでデフォルトで 2026-07-28 がネゴシエートされるようになり、MCP_PROTOCOL_NEGOTIATION=legacy でオプトアウトできます
英語原文を表示
Changed local (stdio) MCP server connections to negotiate protocol version 2026-07-28 by default on every install, including Bedrock, Vertex and Foundry; MCP_PROTOCOL_NEGOTIATION=legacy opts out

変更後

ローカル (stdio) MCP サーバーとの接続が、Bedrock・Vertex・Foundry 環境を含むすべてのインストールで新しいプロトコルバージョン 2026-07-28 を既定でネゴシエートするようになり、サーバー側の最新プロトコル機能を利用できる。従来の挙動に戻したい場合は MCP_PROTOCOL_NEGOTIATION=legacy を設定すればよい。

関連ドキュメント

v2.1.274(1件)

Bedrock、Vertex、Foundry、テレメトリ無効のインストール環境でも、他の環境と同様にデフォルトで v2 MCP クライアントと MCP 2026-07-28 ネゴシエーション（direct 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、テレメトリ無効環境でも、他の環境と同じ v2 MCP クライアントと新しいプロトコル改訂 (2026-07-28) がデフォルトで使えるようになり、環境ごとの挙動の差異がなくなる。

関連ドキュメント