MCP_SDK_GENERATION

環境変数

このプロセスが MCP サーバーへの接続に使う MCP クライアントランタイムを固定する: MCP TypeScript SDK 1.x ベースの v1、または MCP TypeScript SDK 2.0 ベースの v2。変数を設定しない場合、Claude Code は v2 を使用し、そのセクションに記載されたバージョンから開始する。Claude Code v2.1.221 以降では、v2 ランタイムが MCP OAuth サーバーの認可レスポンスで返された issuer を検査し、一致しない場合は「Issuer mismatch in authorization response」で始まるエラーでサインインを失敗させる。v1 ランタイムはこの検査を行わない。認識できない値を設定した場合、Claude Code はそれを無視し、デバッグログに警告を書き込む。Claude Code はこの値をプロセスごとに 1 回だけ読み込む。Claude Code v2.1.218 以降が必要

使い方・用途

  • Bedrock、Vertex、Foundry、テレメトリ無効環境で v2 MCP クライアントへの切り替え後に従来の v1 ランタイムを使い続けたいとき、MCP サーバとの互換性問題を回避するために v1 を明示的に指定できる
  • MCP OAuth サーバが返す発行者(issuer)の検証を避け、Issuer mismatch in authorization response によるサインイン失敗を回避したいとき、チェックを行わない v1 ランタイムに切り替えられる
英語原文

Pin which MCP client runtime this process connects to MCP servers with: v1, built on MCP TypeScript SDK 1.x, or v2, built on MCP TypeScript SDK 2.0. Without the variable, Claude Code uses v2, starting with the versions listed in that section. On Claude Code v2.1.221 or later, the v2 runtime checks the issuer an MCP OAuth server returns in its authorization response and fails the sign-in with an error that begins Issuer mismatch in authorization response when it doesn't match. The v1 runtime doesn't run this check. If you set an unrecognized value, Claude Code ignores it and writes a warning to the debug log. Claude Code reads the value once per process. Requires Claude Code v2.1.218 or later

関連ドキュメント

関連する変更履歴

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) がデフォルトで使えるようになり、環境ごとの挙動の差異がなくなる。

関連ドキュメント