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日 |
| OS | Linux 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回繰り返しています。
| 回 | 成功 | 失敗 | 台ごとの応答 |
|---|---|---|---|
| 1 | 30 | 0 | a: 15 / b: 15 |
| 2 | 30 | 0 | a: 15 / b: 15 |
| 3 | 30 | 0 | a: 15 / b: 15 |
どの応答にも Mcp-Session-Id ヘッダーは付きませんでした。
2. 従来方式を2台で交互に叩く
1台目で initialize してセッション ID を受け取り、以降の tools/list 10回を2台に交互に送りました(1回のみ実施)。
| 送り先 | ステータス | 回数 |
|---|---|---|
| 1台目(セッションを持つ) | 200 | 5 |
| 2台目(セッションを持たない) | 404 | 5 |
セッションをメモリに持つ構成では、スティッキーセッション(同じクライアントを同じ台に送り続ける設定)か、セッションの共有ストアが要る、という従来の制約がそのまま出ました。新方式ではこの制約がプロトコルから消えています。
3. 実際の SDK クライアントで接続の往復数を比べる
v2 クライアントで接続して whoami を4回呼び、リクエストを記録しました(送り先は交互)。
| クライアントの設定 | 接続時と呼び出しで発生したリクエスト | 合計 |
|---|---|---|
既定(legacy) | initialize → notifications/initialized → GET(405)→ tools/call ×4 | 7 |
versionNegotiation: { mode: 'auto' } | server/discover → tools/call ×4 | 5 |
既定の接続でも、ステートレスなサーバー(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)の挙動です。今回は検証していません。
参考資料
- MCP 2026-07-28 Key Changes(公式リポジトリの変更履歴): 仕様変更点の一次資料(2026年10月4日に確認)
- @modelcontextprotocol/server(npm): v2 サーバー SDK(2.3.0)
- @modelcontextprotocol/client(npm): v2 クライアント SDK(2.3.0)
- @modelcontextprotocol/sdk(npm): 従来の SDK(1.32.0)
この記事は、AI エージェントによる調査・検証・下書きをもとに、筆者が内容を確認して公開しています。