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/server 2.4.0(TypeScript SDK v2)、zod 4.6.7
  • 比較用:@modelcontextprotocol/sdk 1.32.2(TypeScript SDK v1 の執筆時点の最新版)
  • @modelcontextprotocol/inspector 2.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() を使えば、新旧どちらのクライアントにも同じコードで応えられます。