ブログ一覧に戻る

MCP 2026-07-28 のステートレス化を実測:SDK v2 サーバー2台を交互に叩いた結果

MCP(Model Context Protocol)の 2026-07-28 版仕様は「プロトコルがステートレスになり、ロードバランサーの背後に普通に並べられる」と紹介されています。リモート MCP サーバーを Cloudflare Workers のようなサーバーレス環境に載せたい人にとっては、重要な変更です。この記事では、その主張を TypeScript SDK v2.3.0 のサーバーを2台立てて交互にリクエストを送る 方法で確かめ、仕様の変更点と、実際に動かして初めて分かった注意点(クライアントの既定動作など)をまとめます。

TL;DR

  • 仕様の変更点は、公式リポジトリの変更履歴(changelog)で確認しました。Mcp-Session-Id と initialize が廃止され、各リクエストが _meta にプロトコルバージョンとクライアント能力を載せます。
  • 2台を交互に叩く実験では、新方式は 30 回中 30 回成功(3回繰り返して同じ)。2025年版のセッション方式(メモリ上のセッション管理)は 10 回中 5 回が 404 Session not found でした。
  • 調査の最初に読んだ解説(要約)では _meta に clientInfo だけ載せればよいように読めましたが、実際のサーバーは protocolVersion と clientCapabilities が無いと -32602 で拒否しました。
  • v2 クライアントの versionNegotiation の既定は 'legacy' で、何も指定しないと従来の initialize 方式で接続します。サーバーを legacy: 'reject'(新方式のみ)にすると、既定のクライアントは接続できませんでした。
  • Cloudflare Workers 上での動作と、実際のロードバランサー越しの動作は 未検証 です。

背景:なぜ今これを確かめるのか

2026年10月4日時点で、@modelcontextprotocol/server と @modelcontextprotocol/client の v2 系は 2.3.0 が最新です(npm レジストリで確認。2.3.0 の公開は2026年10月2日)。README には「v2 は安定版で、2026-07-28 仕様を実装している」と書かれています。一方、従来の @modelcontextprotocol/sdk は 1.32.0 が最新で、同梱のコードが対応するプロトコルバージョンは 2025-11-25 までです。つまり「新仕様に対応した SDK」と「従来の SDK」が並行して配布されており、どちらを使うかで挙動が変わります。

仕様側の根拠は、公式リポジトリの 2026-07-28 の変更履歴です。次の点が書かれています。

  • Streamable HTTP から Mcp-Session-Id ヘッダーとプロトコルレベルのセッションを削除(SEP-2567)。サーバー側で複数回の呼び出しをまたぐ状態が必要な場合は、サーバーが発行したハンドルをツールの引数として渡す。
  • initialize / notifications/initialized を削除し、各リクエストが _meta に io.modelcontextprotocol/protocolVersion と io.modelcontextprotocol/clientCapabilities を載せる。能力の問い合わせ用に server/discover を追加(SEP-2575)。
  • POST リクエストに Mcp-Method と Mcp-Name ヘッダーを必須化(SEP-2243)。
  • 結果に resultType、一覧系には ttlMs と cacheScope を追加。

なお、公式サイト(modelcontextprotocol.io)と Cloudflare のブログはこの実行環境のネットワークから読めませんでした。そのため、以下は GitHub 上の変更履歴と、実際に動かした結果を根拠にしています。

検証環境

項目内容
実行日2026年10月4日
OSLinux 6.18(クラウドのサンドボックス)
ランタイムBun 1.3.14(サーバー・クライアントとも)、Node.js 22.22.0(パッケージ導入)
新方式@modelcontextprotocol/server 2.3.0、@modelcontextprotocol/client 2.3.0、zod 4
従来方式@modelcontextprotocol/sdk 1.32.0
構成サーバー2台(ポート違い)を同一マシン上で起動。クライアントがリクエストごとに送り先を切り替える

「ラウンドロビンのロードバランサー」は、クライアント側で送り先ポートを交互に切り替えて代用しました。本物のロードバランサー(nginx や Cloudflare)は通していません。

実装

新方式のサーバー(SDK v2)

createMcpHandler に、リクエストごとに呼ばれるサーバーのファクトリを渡します。以下は実際に動かしたコードの主要部分です(ログ出力など一部を除いた、ほぼ全体です)。

import { McpServer, createMcpHandler } from '@modelcontextprotocol/server';
import * as z from 'zod/v4';

const id = process.env.INSTANCE ?? 'a';
const port = Number(process.env.PORT ?? 3001);
const legacy = process.env.LEGACY ?? 'stateless';
let hits = 0;

const factory = () => {
  const s = new McpServer({ name: 'stateless-demo', version: '0.0.1' });
  s.registerTool('whoami', { description: 'which instance served this', inputSchema: z.object({}) },
    async () => ({ content: [{ type: 'text', text: `instance=${id} pid=${process.pid} hits=${++hits}` }] }));
  s.registerTool('add', { description: 'add', inputSchema: z.object({ a: z.number(), b: z.number() }) },
    async ({ a, b }) => ({ content: [{ type: 'text', text: String(a + b) }] }));
  return s;
};
const handler = createMcpHandler(factory, { legacy, onerror: e => console.error(`[${id}] onerror`, e.message) });
Bun.serve({ port, fetch: req => handler.fetch(req) });

handler.fetch は Web 標準の Request を受けて Response を返す形なので、Bun・Cloudflare Workers・Node のどれにも載せやすい作りです(Workers 上での動作は今回検証していません)。legacy オプションは 2025 年版のクライアントをどう扱うかを決め、既定は 'stateless'(リクエストごとに新しいインスタンスで応答)、'reject' にすると新方式以外を拒否します。

従来方式のサーバー(比較用)

2025年版の標準的な構成として、セッション ID を発行し、セッションごとのトランスポートをプロセス内の Map に保持するサーバーを SDK 1.32.0 で作りました(コードは省略。WebStandardStreamableHTTPServerTransport に sessionIdGenerator を渡し、Map で引く典型的な形です)。

結果

1. 新方式を2台で交互に叩く

initialize なしで、MCP-Protocol-Version: 2026-07-28 と Mcp-Method / Mcp-Name ヘッダーを付け、_meta に3つのキーを載せた tools/call(whoami)を、2台に交互に30回送りました。これを3回繰り返しています。

回成功失敗台ごとの応答
1300a: 15 / b: 15
2300a: 15 / b: 15
3300a: 15 / b: 15

どの応答にも Mcp-Session-Id ヘッダーは付きませんでした。

2. 従来方式を2台で交互に叩く

1台目で initialize してセッション ID を受け取り、以降の tools/list 10回を2台に交互に送りました(1回のみ実施)。

送り先ステータス回数
1台目(セッションを持つ)2005
2台目(セッションを持たない)4045

セッションをメモリに持つ構成では、スティッキーセッション(同じクライアントを同じ台に送り続ける設定)か、セッションの共有ストアが要る、という従来の制約がそのまま出ました。新方式ではこの制約がプロトコルから消えています。

3. 実際の SDK クライアントで接続の往復数を比べる

v2 クライアントで接続して whoami を4回呼び、リクエストを記録しました(送り先は交互)。

クライアントの設定接続時と呼び出しで発生したリクエスト合計
既定(legacy)initialize → notifications/initialized → GET(405)→ tools/call ×47
versionNegotiation: { mode: 'auto' }server/discover → tools/call ×45

既定の接続でも、ステートレスなサーバー(legacy: 'stateless')が相手なら4回とも成功しました。ただし GET は 405 で拒否されています。2025年版の「サーバーからの通知用ストリーム」を張ろうとして断られた形で、ステートレス構成では通知を受け取れない点は従来から変わりません。

考察とハマりどころ

_meta に必要なキーは最初に読んだ解説より多かった

最初に、調査で読んだ解説の要約に書かれていたとおり clientInfo だけを _meta に載せて server/discover を送ったところ、次のエラーになりました。

Invalid params: the MCP-Protocol-Version header names protocol revision 2026-07-28,
but the request is missing the required per-request envelope key(s):
io.modelcontextprotocol/protocolVersion, io.modelcontextprotocol/clientCapabilities

変更履歴の記述どおり、protocolVersion と clientCapabilities が必須で、clientInfo は SHOULD(推奨)です。自作のクライアントや curl で試す場合は、3つとも載せてください。clientCapabilities は空オブジェクト {} で通りました。

ヘッダーと本文の不一致は 400 で拒否される

Mcp-Method を本文の method と違う値にすると -32020(「ヘッダーと本文が食い違っている」)で 400 になりました。Mcp-Name を params.name と違う値にした場合も同じです。ロードバランサーがヘッダーだけを見てルーティングしても、本文とずれる事故は起きにくい設計です。

既定のクライアントは旧方式のまま

v2 クライアントの README は「2026-07-28 仕様を実装」と書いていますが、Client の versionNegotiation の既定は 'legacy' です。型定義のコメントにも「既定は legacy。2026-07-28 のサーバーと話すには 'auto' か pin を指定する」とあります。実際に、サーバーを legacy: 'reject' にして試しました。

クライアント相手が legacy: 'stateless'相手が legacy: 'reject'
v2 既定成功(旧方式)失敗(-32022 Unsupported protocol version: 2025-11-25)
v2 mode: 'auto'成功(新方式)成功(新方式)
v2 mode: { pin: '2026-07-28' }成功(新方式)成功(新方式)
v1(SDK 1.32.0)成功失敗(同じエラー)

つまり、サーバーだけを v2 にして legacy: 'reject' にすると、手元のクライアントが v1 や設定なしの v2 のままだと接続できません。移行期は、サーバーを既定の legacy: 'stateless' のままにしておくほうが安全だと考えられます。ただし、その場合は新方式の利点を使うのはクライアントが auto か pin を指定したときだけです。

旧方式のステートレス運用は元からあった

legacy: 'stateless' は、1台ごとにセッションを持たない従来のステートレス構成(sessionIdGenerator: undefined)と同じ動作です。今回の2台交互の実験でも、既定クライアントの4回の呼び出しがすべて成功しました。「ステートレスにできるのは新仕様から」ではなく、従来も セッションを使わない選択肢 はありました。新仕様の違いは、それが任意の構成ではなくプロトコルの前提になったことと、initialize の往復がなくなったことです。

セッションに頼っていた機能は別の手段が要る

変更履歴によれば、複数回の呼び出しにまたがる状態は、サーバーが発行するハンドルをツールの引数で渡す方式に変わります。接続ごとに一覧の内容を変える(tools/list がセッションによって違う)作りも許されなくなりました。既存のサーバーがセッションに状態を置いている場合は、設計の見直しが必要です。この点は今回の実験の範囲外で、実際の移行コストは測っていません。

まとめ

手元の検証では、2026-07-28 仕様と SDK v2.3.0 の組み合わせで「initialize なし・セッションなし」の呼び出しが、2台のサーバーに交互に送っても 30/30 で成功しました。従来のセッション方式は 5/10 が 404 でした。一方で、クライアントの既定が旧方式であること、_meta の必須キーが最初に読んだ解説より多いこと、legacy: 'reject' にすると古いクライアントが切れることは、動かして初めて分かりました。

次に確かめたいのは、Cloudflare Workers 上での動作、本物のロードバランサー越しの動作、subscriptions/listen と複数ラウンドの要求(input_required)の挙動です。今回は検証していません。

参考資料

この記事は、AI エージェントによる調査・検証・下書きをもとに、筆者が内容を確認して公開しています。