0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCP 仕様 2026-07-28 の変更点を、自分の設定ファイルとツールスキーマで確かめる

0
Last updated at Posted at 2026-11-10

MCP(Model Context Protocol)の仕様リビジョン 2026-07-28 は、変更点の一覧だけ読むと「プロトコルの内側の話」に見えます。セッションが無くなった、initialize のハンドシェイクが無くなった、server/discover が増えた。どれもサーバーやクライアントを作る人向けの話で、MCP を「使う側」には関係なさそうに思えます。

ところが、使う側にも自分で書いているファイルが2つあります。

  1. MCP の設定ファイル(.mcp.json や claude_desktop_config.json)
  2. 自作のツールを持っているなら、そのツールのスキーマ(inputSchema / outputSchema)

この記事では、変更点の一覧を全部追うのではなく、「この2つのファイルの、どこを見ればよいか」に絞って手順を整理します。仕様そのものの代わりにはならないので、最終的には公式の変更履歴を見てください。

先に全体像: 使う側に響く変更はどれか

2026-07-28 の主な変更を、使う側から見て3つに分けると見通しがよくなります。

A. 自分の設定ファイルに出てくるもの

  • 従来の HTTP+SSE トランスポートは 2025-03-26 の時点で非推奨になっており、移行先は Streamable HTTP です。
  • Claude Code のドキュメントも sse タイプを非推奨とし、使えるなら HTTP サーバーを使うよう案内しています。

B. 自作ツールのスキーマに出てくるもの

  • inputSchema と outputSchema で JSON Schema 2020-12 のどのキーワードも使えるようになりました。
  • 新しく x-mcp-header という注釈ができ、規則に反した注釈を持つツールはクライアントに拒否されます。

C. サーバーやクライアントの実装側の話(使う側は「知っておく」でよい)

  • プロトコル層のセッションと Mcp-Session-Id ヘッダーの廃止、ステートレス化
  • server/discover の追加、subscriptions/listen への置き換え
  • Roots・Sampling・Logging・Dynamic Client Registration の非推奨化
  • 再開できる SSE ストリーム(Last-Event-ID)の廃止

C は、使っているクライアントやサーバーが新しいリビジョンに対応すれば自動的に効いてくる部分です。自分の手元で何かを書き換える必要が出るのは、主に A と B です。

手順1: 設定ファイルの「トランスポート」を棚卸しする

最初に見るのは、設定ファイルに並んでいるサーバーのエントリーです。見るポイントは次の3つです。

  • type が sse になっているエントリー
    HTTP+SSE トランスポートを使っている印です。非推奨の一覧に入っているので、サーバー側が Streamable HTTP に対応しているなら、そちらへ切り替える候補になります。
  • リモートのサーバーなのに type が書かれていないエントリー
    どのトランスポートとして扱われるかがクライアント任せになります。意図した形で接続されているか、明示しておくと後で迷いません。
  • ローカルで起動する(コマンドで立ち上げる)エントリー
    こちらは HTTP+SSE の非推奨とは別の話です。慌てて書き換えないようにします。

ここで大事なのは、非推奨は「すぐ動かなくなる」という意味ではないことです。仕様では、非推奨の機能も引き続き仕様の一部であり、新しい機能ライフサイクルのポリシーで非推奨の期間は最低12か月とされています。HTTP+SSE の「最も早い削除時期」は、ある提案(SEP-2596)が Final になってから3か月後とされていて、日付で決まっているわけではありません。つまり今日やるべきことは「書き換え」より先に「どこが該当するかを把握すること」です。

棚卸しは目で追ってもできますが、エントリーが多いと見落とします。ToolkITBox の記事に組み込まれている MCP Config Checker に設定ファイルの中身を貼ると、type の無いリモートサーバーや sse を使っているエントリーを一覧で報告してくれます。処理はブラウザの中で完結し、設定はアップロードされません。

ただし、チェッカーが見ていないものもあります。コマンドが実在するか、パッケージがインストールできるか、リモートサーバーが実際に応答するか、他のアプリケーションが別の扱いをするか、は確認対象外です。「チェッカーに通った=接続できる」ではない点は覚えておいてください。

手順2: 切り替え先の Streamable HTTP で何が変わるかを知っておく

設定を sse から HTTP に切り替えるとき、設定ファイル側で書くことは多くありません。それでも、相手のサーバーが何を求めるのかを知っておくと、つながらないときの切り分けが早くなります。仕様が説明している Streamable HTTP の要点は次のとおりです。

  • サーバーは POST を受け付ける単一のエンドポイントを公開し、クライアントは JSON-RPC メッセージをそれぞれ別の POST として送る
  • 各 POST の Accept ヘッダーには application/json と text/event-stream の両方を挙げる
  • すべての POST に、本文のプロトコルバージョンと一致する MCP-Protocol-Version ヘッダーを付ける
  • リクエストには Mcp-Method ヘッダーを付け、tools/call・resources/read・prompts/get には Mcp-Name も付ける
  • サーバーは単一の JSON オブジェクトか、そのリクエスト限定の SSE ストリームで答える

ここで見落としやすいのが、バージョンの食い違いです。2026-07-28 ではすべてのリクエストがプロトコルのバージョンを _meta に含め、合わなければ UnsupportedProtocolVersionError が返ります。設定を書き換えて急に動かなくなったら、設定の誤りを疑う前に「クライアントとサーバーがどのリビジョンに対応しているか」をそれぞれのドキュメントで確かめるのが近道です。

もう1つ、再開できる SSE ストリームが廃止された点も、使う側の体感に関わります。レスポンスの途中で接続が切れると、処理中のリクエストは失われ、クライアントは新しいリクエストとして送り直します。回線の不安定な環境で長い処理を投げているなら、「途中で切れたら最初からやり直しになる」前提で考えておくとよいでしょう。

手順3: 自作ツールのスキーマを「規則」と「サンプル」の両方で確かめる

自分で MCP サーバーを書いていて、ツールを定義しているなら、次はスキーマです。

使えるキーワードが広がった

inputSchema と outputSchema では JSON Schema 2020-12 のどのキーワードも使えるようになり、structuredContent には任意の JSON 値を入れられます。あわせて、$ref の解決に関する要件と、組み合わせ用のキーワードに対するリソースの上限が加わりました。

表現力が上がったぶん、「書いたスキーマが意図どおりに効いているか」を確かめる重要度も上がります。JSON Schema には、使い慣れていないと気づきにくい性質がいくつかあります。

  • properties が確認するのは、存在するプロパティだけ。必須にしたいなら required に名前を挙げる
  • additionalProperties を省略すると、余分なプロパティは許可される
  • pattern は先頭・末尾に固定されない。全体一致させたいなら ^ と $ を付ける
  • format は既定では注釈で、確認するかどうかは実装次第
  • 未知のキーワードは注釈として扱われるので、requierd のような打ち間違いはエラーにならず、黙って無視される

最後の1つは特に怖いところです。必須のつもりで書いた項目が、つづりを1文字間違えただけで「任意」になり、どんな引数でも通ってしまいます。

確かめ方: 有効な引数と無効な引数を1つずつ用意する

おすすめは、スキーマだけを眺めるのではなく、通るはずの引数と、落ちるはずの引数を1つずつ用意して実際に照らすことです。落ちるはずの引数が通ってしまったら、どこかの規則が効いていません。

ToolkITBox の JSON Schema Validator は、左にスキーマ、右に JSON を貼ると、問題のあるパスと守られなかったキーワードを一覧にしてくれます。Draft 2020-12 の主なキーワードに対応していて、format や unevaluatedProperties のように確認しないキーワードをスキーマが使っているときは、その旨を表示します。「通ったけれど、実は確認していないキーワードがあった」という見落としを防げる作りです。$ref は同じスキーマの中の定義だけを読み、外部のスキーマは取りにいきません。

x-mcp-header を付けるときの規則

新しく入った x-mcp-header は、ツールのパラメータに付けると、その値を Mcp-Param-{name} という HTTP ヘッダーにコピーさせるものです。便利な一方で、規則が細かく、違反するとツールそのものが使えなくなります。

  • 付けるパラメータの型は文字列・整数・真偽値のどれか。数値(number)は不可
  • そのプロパティには、スキーマのルートから properties キーだけをたどって到達できること
  • 途中で items・oneOf・anyOf・allOf・not・if/then/else・$ref を経由してはいけない

Streamable HTTP を使うクライアントは、これらの規則に反した注釈を持つツール定義を拒否しなければならず、そのツールは tools/list の結果から外れます。エラーが出るのではなく「ツールが一覧に出てこない」という形で現れるので、原因に気づきにくいはずです。x-mcp-header を使い始めたらツールが消えた、というときは、まずこの3点を見直してください。バリデーターはスキーマとデータの照合をするものなので、この「どこに付けてよいか」の規則は目で確認する必要があります。

サーバーを自分で立てている人へ: 設定と一緒に見ておく項目

ローカルで MCP サーバーを動かしているなら、仕様のセキュリティ上の要点も同じタイミングで確認しておくと二度手間になりません。

  • すべての受信接続で Origin ヘッダーを検証し、無効なら 403 を返す(DNS リバインディング対策)
  • ローカルのサーバーは 0.0.0.0 ではなく 127.0.0.1 にだけバインドする
  • すべての接続に適切な認証を実装する
  • ヘッダーと本文が一致しないリクエストは、HTTP 400 と JSON-RPC エラー HeaderMismatch(コード -32020)で拒否する

特にバインド先は、設定ファイルの棚卸しと同じ流れで確認できます。「手元でしか使っていないつもりのサーバーが、実はネットワーク全体に開いていた」というのはよくある落とし穴です。

まとめ: 今日やること、後でよいこと

いつ やること
今日 設定ファイルで sse のエントリーと type の無いリモートサーバーを洗い出す
今日 自作ツールのスキーマに、通る引数と落ちる引数を1つずつ当てる
使い始めるとき x-mcp-header の3つの規則を守っているか確認する
移行のとき サーバーとクライアントが対応するリビジョンを、それぞれのドキュメントで確認してから切り替える
様子を見る Roots・Sampling・Logging など非推奨の機能。最低12か月の猶予があり、削除の時期はまだ決まっていない

仕様の変更は、全部を理解しようとすると重く感じます。けれど、自分が書いたファイルに関係する部分だけを拾えば、確認作業は数十分で終わります。まずは設定ファイルを開いて、sse という文字が無いかを探すところから始めてみてください。

詳しく知りたいとき


この記事は生成AIで作成し、公開前に人が最終確認しています。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?