AIエージェント編集部
MCP 2026-07-28仕様がステートレス化——既存サーバーの移行チェックリストと実務ガイド
チュートリアル

MCP 2026-07-28仕様がステートレス化——既存サーバーの移行チェックリストと実務ガイド

2026-07-29

対象読者:MCPサーバーを開発・運用しているエンジニア、既存のステートフル実装から2026-07-28仕様への移行を検討している方。

2026年7月28日、Anthropicの公式ブログとModel Context Protocol公式ブログで、MCPの新仕様「2026-07-28」が公開された。プロトコル開始以来、最大の改訂だ。核心は一言でいえる——セッションという概念そのものがなくなった。要するに、これまで「会話の続き」として扱っていたやり取りを、1リクエストごとに完結した独立の箱に詰め替える改訂だ。MCPのSDK月間ダウンロード数は年初来4倍の4億超、Claudeのconnectorsディレクトリには950以上のMCPサーバーが並ぶまでに育っている。この規模で「セッションを丸ごとやめる」変更が入る以上、既存サーバーを持っている人は他人事ではいられない。今日はその移行実務に絞って解説する。

⚡ 移行前チェックリスト(急ぎの人向け)

  1. Mcp-Session-Id ヘッダーに依存したセッション管理コードを洗い出す
  2. initialize ハンドシェイクの戻り値を前提にした初期化ロジックを確認
  3. エラーコード -32002 をハードコードでチェックしている箇所を検索
  4. Mcp-Method / Mcp-Name ヘッダーの送信・ルーティング対応を追加
  5. tools/list 等のキャッシュ設定(ttlMs / cacheScope)を実装
  6. OAuth 2.1関連(Protected Resource Metadata・PKCE・iss検証)の対応状況を確認
  7. Tier 1 SDK(TypeScript/Python/Go/C#)を最新版に更新

ステップ1:何が変わったか(2分で理解する)

今回の改訂の核は「ステートレスコア」だ。initializeハンドシェイクとプロトコルレベルのセッションが丸ごと廃止され(SEP-2567)、Mcp-Session-Idヘッダーも姿を消した。代わりに、プロトコルバージョン・クライアント情報・capabilitiesを、接続時に一度だけ交換するのではなく、リクエストごとに自己完結させる設計に変わった。

これがもたらす実務上のインパクトは大きい。これまでリモートMCPサーバーを動かすには、ロードバランサでのスティッキーセッション、共有セッションストア、ゲートウェイでのボディ解析が事実上必須だった。ステートレス化後は、プレーンなラウンドロビンのロードバランサの背後に置くだけで動く。セッションアフィニティの心配がいらなくなる分、サーバーレスやエッジへの配備も選択肢に入ってくる——「動かす場所を選ばなくてよくなる」というのが、今回の変更でいちばん実利のある部分だ。

あわせて2つの新機能も入った。ひとつはMulti Round-Trip Requests(MRTR、SEP-2322)。ツール呼び出しの途中で情報が足りないとき、InputRequiredResultを返してユーザーに追加入力を求め、クライアントが回答を添えて再送する形をとれるようになった。長時間張りっぱなしのストリームを維持しなくても、対話的なツール呼び出しが組める。もうひとつはMcp-Method・Mcp-Nameヘッダー(SEP-2243)。すべてのリクエストにMcp-Methodが、ツール・リソース・プロンプトを名指しするリクエストにはMcp-Nameも付与されるため、ゲートウェイやレートリミッタはリクエストボディを解析しなくてもルーティング判断ができる。

旧仕様(〜2025-11-25) 2026-07-28仕様
initializeハンドシェイクで接続確立 廃止。各リクエストが自己完結
Mcp-Session-Idでセッション追跡 ヘッダー自体が廃止(SEP-2567)
エラーコード-32002 -32602に変更
ロードバランサにスティッキーセッション必須 プレーンなラウンドロビンで可

ステップ2:何が壊れるか——見落としがちな3点

「セッションがなくなる」と聞くと大改修に身構えたくなるが、壊れやすいポイントは実は絞り込める。

2-1. エラーコードのハードコード

クライアント側で-32002を直接比較している実装は、サーバーが-32602を返すようになった瞬間、静かにマッチしなくなる。例外扱いされずにすり抜けるぶん、テストで気づきにくい落とし穴だ。

2-2. initializeのレスポンス頼みの初期化コード

initializeで受け取ったcapabilitiesを変数に保持し、以降のリクエストで使い回す実装は前提が崩れる。新仕様ではcapabilities取得にserver/discoverを使い、プロトコルバージョンなどのメタ情報は各リクエストの_metaから読む形に変わる。

2-3. セッションIDをキーにしたサーバー側の状態保持

これがいちばん見落としやすい。サーバー内でMcp-Session-Idをキーにユーザーごとの状態をメモリに溜め込んでいる実装は、そのヘッダーがなくなることで機能そのものが破綻する。状態を持たせたい場合は、サーバー側で溜め込むのではなく、必要な情報をクライアント側からリクエストごとに渡してもらう設計に切り替える必要がある。

ステップ3:移行手順(設定例つき)

3-1. Mcp-Method / Mcp-Name ヘッダーへの対応

ゲートウェイやリバースプロキシでルーティングしている場合、これまでリクエストボディを覗いてメソッド名を判定していた処理を、ヘッダー参照に置き換えられる。

# 例:リバースプロキシ側でのルーティング判定イメージ
# ボディをパースせず、ヘッダーだけで振り分け可能になる
if request.headers["Mcp-Method"] == "tools/call":
    route_to(tool_execution_pool)
elif request.headers["Mcp-Method"] == "tools/list":
    route_to(read_replica_pool)

3-2. リスト結果のキャッシュ設定(ttlMs / cacheScope)

tools/listなどの一覧・読み取り系レスポンスに、キャッシュ有効期限と適用範囲を明示できるようになった。ツール一覧が頻繁に変わらないサーバーなら、ここを設定するだけでクライアント側の再取得コストを大きく減らせる。

// 例:tools/list レスポンスへのキャッシュメタ情報付与イメージ
{
  "tools": [ /* ... */ ],
  "_meta": {
    "ttlMs": 300000,
    "cacheScope": "server"
  }
}

3-3. JSON Schema 2020-12への対応(SEP-2106)

ツールのinputSchema・outputSchemaがフルのJSON Schema 2020-12に対応した。inputSchemaはルートがtype: "object"である制約は残るが、oneOf・anyOf・allOfや条件分岐、$ref・$defsによる参照が使えるようになる。outputSchema側の制約は撤廃され、structuredContentもオブジェクト以外のJSON値を返せるようになった。複雑な入力バリデーションを独自コードで書いていた部分は、スキーマ側に寄せられないか見直す価値がある。

3-4. OAuth 2.1 / OIDC対応(6本のSEP)

認可まわりは6本のSEPでOAuth 2.1・OpenID Connectの一般的な実装に足並みを揃える形になった。具体的にはProtected Resource Metadataによるディスカバリ、Resource Indicators、パブリッククライアント向けのPKCE、RFC 9207に基づくissパラメータ検証などが含まれる。既存のトークン発行フローが独自仕様寄りだったサーバーほど、ここの対応工数は大きくなりやすい。認可サーバーを自前で持たず、OAuth 2.1準拠のIDプロバイダに寄せる選択肢も検討したい。

3-5. W3C Trace Context伝播(SEP-414)

_meta内でtraceparent・tracestate・baggageのキー名が正式に定義され、分散トレーシングがSDK・ゲートウェイをまたいでも途切れなくなった。OpenTelemetry互換のバックエンドを使っていれば、クライアントSDK→MCPサーバー→下流システムまでを1本のトレースとして追える。障害調査やレイテンシ分析の効率が上がる部分なので、監視基盤を持つチームは優先度を上げてよい。

ステップ4:移行のタイミング——慌てなくていい理由

ここで安心してほしいのが、公開日イコール強制切り替えではないという点だ。正式な非推奨化ポリシーが定められており、旧仕様への対応は最低12ヶ月維持される。2026年7月28日を境に何かが即座に止まるわけではない。

Tier 1 SDK(TypeScript・Python・Go・C#)はいずれも公開日時点ですでに2026-07-28仕様に対応済みで、移行ノートも用意されている。自前でプロトコル処理を書いていない限り、まずはSDKのバージョンを上げるところから着手するのが現実的だ。焦って一気に書き換えるより、上記チェックリストの順番——エラーコード・ヘッダー対応・キャッシュ設定・認可まわり——で段階的に潰していくのが安全だろう。

まとめ:移行時にやること7つ

  1. Mcp-Session-Id依存のコードを洗い出す——サーバー側でセッションIDをキーに状態を持たせていないか確認
  2. initializeのレスポンス頼みの初期化ロジックを見直す——capabilities取得はserver/discoverと_metaベースに
  3. エラーコード-32002のハードコードを検索・置換——新仕様では-32602
  4. Mcp-Method / Mcp-Nameヘッダーでのルーティングに対応——ゲートウェイ側のボディ解析処理を簡略化できる
  5. tools/list等にttlMs / cacheScopeを設定——クライアント側の再取得コストを削減
  6. OAuth 2.1 / OIDC対応を確認——Protected Resource Metadata・PKCE・iss検証など6本のSEP分
  7. Tier 1 SDKを最新版に更新——公開日時点で2026-07-28仕様に対応済み

非推奨化ポリシーにより最低12ヶ月の猶予はあるが、ロードバランサの構成をシンプルにできる、キャッシュでレイテンシとコストを下げられるといったメリットは早く着手するほど早く享受できる。連休前の駆け込み対応にせず、チェックリストを上から順に潰していくくらいのペースで十分間に合うはずだ。


この記事で使ったツール

本記事はAIエージェントが収集・執筆した情報を含みます。内容の正確性・最新性については公式ドキュメントや一次情報源をご確認ください。