Knowledge
MCP 2026-07-28 仕様に対応したサーバーを作る ― 何が変わり、どう動くのか
MCP の新仕様 2026-07-28 で何が変わったのかを整理し、TypeScript SDK v2 で最小のサーバーを作って Claude Code につなぐまでを実際に試しました。通信ログで、新旧どちらの仕様で話しているかも確かめます。
2026年7月28日、AI とツールをつなぐ標準規格 MCP(Model Context Protocol)の新しい仕様が、MCP プロジェクトから公開されました(公開元については後述)。プロトコルが登場してから最大の変更で、接続時の「あいさつ」とセッションがなくなり、1つ1つのリクエストが独立して動く(ステートレスな)作りになりました。
この記事では、変更点を整理したうえで、TypeScript SDK v2 で小さな MCP サーバーを作り、Claude Code につなぐところまでを実際に試します。比較のため、同じサーバーを SDK v1 でも書いて動かしました。
こんな場面で役立つ
- 社内ツールや自作スクリプトを、Claude から呼べるようにしたい。この記事のサーバーをひな形にすれば、関数を1つ書き足すだけでツールを増やせます。
- 既存の MCP サーバーを SDK v1 から v2 に上げようとしている。v1 と v2 のコードの違いと、README の例をそのまま写すと新仕様で動かない、という落とし穴を先に知っておけます。
- 「新しい仕様で何が変わったのか」を、仕様書を全部読まずに把握したい。サーバーを作る人が押さえるべき変更だけを表にまとめました。
- MCP サーバーの動作を、AI を通さずに確認したい。Inspector の CLI と、JSON を直接送る方法の両方を紹介します。
前提・検証環境
- 確認日:2026年11月12日(SDK v1 との比較と、運営体制は11月14日に確認)
@modelcontextprotocol/server2.4.0(TypeScript SDK v2)、zod4.6.7- 比較用:
@modelcontextprotocol/sdk1.32.2(TypeScript SDK v1 の執筆時点の最新版) @modelcontextprotocol/inspector2.13.0- Claude Code 2.1.322 / Node.js 23.9.0 / macOS
MCP の仕様は、誰が決めて公開しているのか
MCP は、2024年11月25日に Anthropic がオープンな規格として公開しました(Anthropic の発表)。考案したのは Anthropic の David Soria Parra 氏と Justin Spahr-Summers 氏です。
その後、2025年12月9日に Anthropic は MCP を、Linux Foundation 傘下に新しくできた Agentic AI Foundation(AAIF)に寄贈しました(Anthropic の発表)。AAIF は Anthropic・Block・OpenAI が共同で設立し、Google・Microsoft・AWS・Cloudflare・Bloomberg が支援しています。つまり2026年11月時点の MCP は、特定の企業の持ち物ではなく、中立の財団の下で運営されるオープンソースのプロジェクトです。
| 項目 | 2026年11月時点の状況 |
|---|---|
| 運営の母体 | Linux Foundation 傘下の AAIF。法的な名義は「Model Context Protocol a Series of LF Projects, LLC」 |
| 最終決定権 | リードメンテナー(David Soria Parra 氏、Den Delimarsky 氏)。その下にコアメンテナー6名、各 SDK などのメンテナーがいる |
| 席の割り当て | メンバーは個人単位で、特定の企業に席は割り当てられていない |
| 仕様の変え方 | SEP(Specification Enhancement Proposal:仕様の変更提案)という設計文書を出し、コアメンテナーが隔週の会議で採否を決める。試作のコードがない提案は審査されない |
| 仕様書の置き場所 | GitHub の modelcontextprotocol/modelcontextprotocol。公開先は modelcontextprotocol.io |
体制は公式のGovernanceとSEP のガイドラインのページで確認しました。今回の 2026-07-28 版も、公式ブログでリードメンテナーの2人の名前で発表されています。
バージョン名が日付になっているのも特徴です。バージョンの決まりによると、2026-07-28 は「後方互換のない変更が最後に入った日」を表します。互換性を保った修正だけなら、バージョン名は変わりません。
新しい仕様の情報を追いかけたいときは、公式ブログと、仕様書の変更履歴(Changelog)を見るのが確実です。
2026-07-28 で何が変わったか
前の版(2025-11-25)からの変更のうち、サーバーを作る人に関係の深いものをまとめました。出典は公式の変更履歴と公式ブログです。
| 変更 | 内容 |
|---|---|
| あいさつの廃止 | initialize と notifications/initialized が削除。Mcp-Session-Id ヘッダーもなくなった |
| リクエストごとの情報 | バージョンとクライアントの機能を、各リクエストの _meta に毎回載せる |
server/discover | サーバーが対応バージョン・機能・名前を返す新しいメソッド。サーバーは必ず実装する |
subscriptions/listen | ツール一覧の変更などの通知を受け取る仕組みが、これに一本化された |
resultType | すべての結果に "complete" か "input_required" が付く |
| 一覧のキャッシュ | tools/list などの結果に ttlMs と cacheScope が付く |
| 拡張機能の枠組み | Tasks(長時間の処理)、MCP Apps などは本体から「拡張」に移った |
| 非推奨 | Roots・Sampling・Logging と、HTTP+SSE 方式が非推奨に。非推奨から削除までは最低12か月 |
| エラーコード | 未対応バージョンのエラーは -32022 に変更(ほかにも番号の振り直しあり) |
状態を持ちたいサーバーはどうするのか、という疑問に対して、公式ブログは「ツールから明示的なハンドル(ID)を発行し、モデルに次の呼び出しで渡し返してもらう」方法を勧めています。
手順
1. SDK v2 をインストールする
SDK v2 は、パッケージ名が v1 の @modelcontextprotocol/sdk から変わり、サーバー用とクライアント用に分かれました。
mkdir mcp-demo && cd mcp-demo
npm init -y
npm pkg set type=module
npm install @modelcontextprotocol/server zod
2. 最小のサーバーを書く
例として、ページの説明文(meta description)の文字数を数えて、推奨の長さに収まっているか判定するツールを1つだけ持つサーバーを作ります。server.js として保存します。
import { McpServer } from '@modelcontextprotocol/server';
import { serveStdio } from '@modelcontextprotocol/server/stdio';
import * as z from 'zod/v4';
serveStdio(() => {
const server = new McpServer({ name: 'seo-helper', version: '1.0.0' });
server.registerTool(
'check_description',
{
description: 'ページの説明文(meta description)の文字数を数え、推奨範囲(70〜120字)に収まっているか判定する',
inputSchema: z.object({ text: z.string() })
},
async ({ text }) => {
const length = [...text].length;
const verdict = length < 70 ? '短すぎます' : length > 120 ? '長すぎます' : 'ちょうどよい長さです';
return {
content: [{ type: 'text', text: `${length}字:${verdict}(推奨 70〜120字)` }]
};
}
);
return server;
});
ポイントは serveStdio() です。サーバーを作る関数を渡すと、新しい仕様(2026-07-28)と従来の仕様の両方のクライアントに、同じコードで応答してくれます(理由は「つまずきポイント」で説明します)。
3. 比較:SDK v1 ではどう書いていたか
同じサーバーを、SDK v1(@modelcontextprotocol/sdk 1.32.2)でも書いてみました。v1 は2026年7月の新仕様より前の SDK で、ソースコードの対応バージョン一覧では 2025-11-25 が最新です。
npm install @modelcontextprotocol/sdk zod
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import * as z from 'zod';
const server = new McpServer({ name: 'seo-helper', version: '1.0.0' });
server.registerTool(
'check_description',
{
description: 'ページの説明文(meta description)の文字数を数え、推奨範囲(70〜120字)に収まっているか判定する',
inputSchema: { text: z.string() }
},
async ({ text }) => {
const length = [...text].length;
const verdict = length < 70 ? '短すぎます' : length > 120 ? '長すぎます' : 'ちょうどよい長さです';
return {
content: [{ type: 'text', text: `${length}字:${verdict}(推奨 70〜120字)` }]
};
}
);
await server.connect(new StdioServerTransport());
ツールの中身は同じです。違うのは、パッケージと、サーバーの起動のしかたです。
| 項目 | SDK v1(1.32.2) | SDK v2(2.4.0) |
|---|---|---|
| パッケージ | @modelcontextprotocol/sdk(サーバーとクライアントが1つ) | @modelcontextprotocol/server と @modelcontextprotocol/client に分割 |
| import | …/sdk/server/mcp.js のように .js まで書く | @modelcontextprotocol/server から直接 |
| 入力の型 | { text: z.string() } の形で渡した | z.object({ text: z.string() }) |
| 起動 | サーバーを1つ作り server.connect() | serveStdio() にサーバーを作る関数を渡す |
| 対応する仕様 | 2025-11-25 まで | 2026-07-28 と従来の仕様の両方 |
v1 のサーバーに、新しい仕様の server/discover を送ると、メソッドがないというエラーになります。
実行結果(v1 のサーバーに server/discover を送った場合)
{"jsonrpc":"2.0","id":1,"error":{"code":-32601,"message":"Method not found"}}
v1 のころの仕様(2025-11-25)では、最初に initialize であいさつしてから、ツールを呼び出していました。
実行結果(v1 のサーバーに initialize → tools/call を送った場合)
{"result":{"protocolVersion":"2025-11-25","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"seo-helper","version":"1.0.0"}},"jsonrpc":"2.0","id":1}
{"result":{"content":[{"type":"text","text":"33字:短すぎます(推奨 70〜120字)"}]},"jsonrpc":"2.0","id":2}
あいさつの返事(1行目)で、バージョンとサーバー名を返しています。新しい仕様では、この役目を server/discover と、各リクエストの _meta が引き継ぎました。
なお、この v1 のサーバーも Claude Code 2.1.322 からは問題なく使えました。Claude Code は server/discover が通じないと initialize に切り替えるためです(手順7で詳しく見ます)。既存の v1 のサーバーが、すぐに動かなくなるわけではありません。
4. Inspector の CLI で動作を確認する
公式の MCP Inspector には CLI モードがあり、AI を通さずにツールの一覧や呼び出しを試せます。
npm install -D @modelcontextprotocol/inspector
npx mcp-inspector --cli node server.js --method tools/call \
--tool-name check_description \
--tool-arg 'text=週末に作れる、季節の野菜を使った簡単な作り置きレシピを紹介します。'
実行結果
{
"content": [
{
"type": "text",
"text": "33字:短すぎます(推奨 70〜120字)"
}
]
}
5. JSON を直接送って、ステートレスになったことを確かめる
新しい仕様では、あいさつなしでいきなりリクエストを送れます。各リクエストの _meta にバージョンを載せて、標準入力から直接送ってみます。
M='"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}'
printf '%s\n' "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"server/discover\",\"params\":{$M}}" \
| node server.js
実行結果(整形済み)
{
"result": {
"supportedVersions": ["2026-07-28"],
"capabilities": { "tools": { "listChanged": true } },
"resultType": "complete",
"ttlMs": 0,
"cacheScope": "private",
"_meta": {
"io.modelcontextprotocol/serverInfo": { "name": "seo-helper", "version": "1.0.0" }
}
},
"jsonrpc": "2.0",
"id": 1
}
initialize を一度も送っていないのに、サーバーは対応バージョンと機能を返しました。resultType、キャッシュ用の ttlMs・cacheScope、サーバー名を載せた _meta など、表で挙げた新しい項目がそろっています。存在しないバージョン(2099-01-01)を指定すると、仕様どおり -32022 のエラーが返りました。
{"jsonrpc":"2.0","id":9,"error":{"code":-32022,"message":"Unsupported protocol version: 2099-01-01","data":{"supported":["2026-07-28"],"requested":"2099-01-01"}}}
6. Claude Code につないで使う
プロジェクトのディレクトリで、次のコマンドを実行します。
claude mcp add --scope project seo-helper -- node server.js
プロジェクト直下に .mcp.json が作られます。このファイルをリポジトリに入れておけば、チームの全員が同じサーバーを使えます。
{
"mcpServers": {
"seo-helper": {
"type": "stdio",
"command": "node",
"args": ["server.js"],
"env": {}
}
}
}
Claude Code に「seo-helper の check_description で、この説明文が適切な長さか判定して」と頼むと、ツールを呼び出して答えてくれました。
実行結果(Claude Code の動きを抜粋)
ツール呼び出し: mcp__seo-helper__check_description
{"text": "週末に作れる、季節の野菜を使った簡単な作り置きレシピを紹介します。"}
ツールの結果: 33字:短すぎます(推奨 70〜120字)
回答: この説明文は 33字で短すぎる という結果でした(推奨は70〜120字)。
推奨範囲に入れるには、あと40字ほど足す必要があります。…(書き直し例が続く)
7. Claude Code はどちらの仕様で話しているのか
サーバーの前に、届いたメッセージをファイルに書き出す小さなスクリプトを挟んで、Claude Code 2.1.322 が送ってくるメソッドを記録しました。
serveStdio() で作ったサーバーの場合
server/discover protocolVersion=2026-07-28
subscriptions/listen protocolVersion=2026-07-28
server/discover protocolVersion=2026-07-28
tools/list protocolVersion=2026-07-28
tools/call protocolVersion=2026-07-28
従来の書き方(server.connect)のサーバーの場合(SDK v1 のサーバーでも同じ)
server/discover protocolVersion=2026-07-28 ← まず新しい仕様で問い合わせる
initialize protocolVersion=2025-11-25 ← 通じないので従来のあいさつに切り替え
notifications/initialized
tools/list
tools/call
確認した時点の Claude Code は新しい仕様で通信し、initialize を一度も送りません。従来の仕様にしか対応していないサーバーには、まず server/discover で問い合わせ、通じなければ initialize に切り替えていました。仕様にある、stdio での後方互換の確かめ方のとおりの動きです。
つまずきポイント
- v2 でも README の最小例は、従来の仕様でしか動かない。SDK の README にある
server.connect(new StdioServerTransport())の書き方で作ると、server/discoverに-32601(Method not found)が返ります。v1 と同じserver.connect()の書き方のままだと、v2 にしても新しい仕様には対応しません。SDK v2 は、新しい仕様を自分から有効にする作りです。stdio ならserveStdio()を使ってください。Claude Code は従来の仕様にも切り替えてくれるので、つながること自体はつながります。そのため気づきにくい点に注意が必要です。 - プロジェクトに登録したサーバーは、最初に承認が必要。
claude mcp listで見ると⏸ Pending approvalと表示されます。対話モードのclaudeを一度起動して承認してください。非対話モード(claude -p)で試すだけなら、--mcp-config .mcp.jsonで設定ファイルを明示して読み込ませる方法もあります。 - Inspector の最新版は Node.js のバージョンを選ぶ。最新版の 2.15.0 は Node.js 22.23.4 以上・24.22.1 以上・26.12.1 以上を必要とします。Node.js 23.9.0 の環境では、npm が条件を満たす 2.13.0 を入れました。
- stdio のサーバーでは、標準出力にログを書かない。標準出力は通信そのものに使われるので、
console.logを書くと通信が壊れます。ログは標準エラー出力に書きます。新しい仕様でも、プロトコル上の Logging は非推奨になり、stderr や OpenTelemetry を使うよう案内されています。
まとめ
MCP 2026-07-28 の中心は、あいさつとセッションをなくし、リクエストごとに完結させる変更です。サーバーを作る側で最初に効いてくるのは、SDK v2 では新しい仕様を自分で有効にする必要がある、という点でした。stdio なら serveStdio() を使えば、新旧どちらのクライアントにも同じコードで応えられます。