プロトコルバージョン

MCP には 2 つの世代があります。

2026-07-28 より前にリリースされたサーバーは、すべての接続を initialize ハンドシェイクで始めます。クライアントがバージョンを提案し、サーバーが対案を返し、クライアントが了承します。これらがすべて、最初の実質的なリクエストより前に行われます。2026-07-28 のサーバーはこのハンドシェイクをやめました。クライアントが server/discover のプローブを 1 回送り、サーバーは必要なものすべてを 1 つの結果にまとめて返します。

Client が代わりにネゴシエーションしてくれるので、気にする必要はほとんどありません。このページで扱うのは、それを制御するたった 1 つのコンストラクター引数 mode= と、それを変更する 3 つの場面です。

mode="auto"

from mcp import Client
from mcp.server import MCPServer

mcp = MCPServer("Bookshop")


@mcp.tool()
def search_books(query: str) -> str:
    """Search the catalog by title or author."""
    return f"Found 3 books matching {query!r}."


async def main() -> None:
    async with Client(mcp) as client:
        print(client.protocol_version)

mode を渡していないので、デフォルトの "auto" が使われます。async with に入ると、この SDK が話せる最新のバージョンで server/discover プローブを 1 回だけ送ります。その後は次のどちらかです。

• 新世代のサーバーはこれに応答します。クライアントはその結果を採用します。ラウンドトリップ 1 回で完了です。
• 古いサーバーは server/discover を知らないので、エラーを返します。クライアントは従来の initialize ハンドシェイクにフォールバックし、そこでネゴシエートされた結果を受け入れます。

どちらの場合でも接続は確立され、どちらだったかは client.protocol_version でわかります。

2026-07-28

機能としてはこれだけです。Client は 1 つ、サーバーはどの世代でもよく、コードに分岐は要りません。

mode="legacy"

from mcp import Client
from mcp.server import MCPServer

mcp = MCPServer("Bookshop")


@mcp.tool()
def search_books(query: str) -> str:
    """Search the catalog by title or author."""
    return f"Found 3 books matching {query!r}."


async def main() -> None:
    async with Client(mcp, mode="legacy") as client:
        print(client.protocol_version)

mode="legacy" はプローブを一切送りません。initialize ハンドシェイクを実行します。2026 年より前のクライアントが開くのと同じ接続です。

2025-11-25

同じサーバーです。このサーバーは 2026-07-28 を問題なく話せますが、尋ねないようクライアントに指示したのです。

これが必要になるのは、プッシュ型の機能を使うときです。

サーバー起点のリクエストとは、サーバーのほうから「呼び出し側」を呼ぶものです。ctx.elicit(...) がユーザーの前にフォームを出したり、サンプリングがツール呼び出しの途中でモデルに補完を求めたりします。このチャネルはハンドシェイク世代のセッションにしか存在しません。

2026-07-28 ではこのチャネルはなくなりました。サーバーは質問を結果として「返し」、クライアントは答えを添えて呼び出しをやり直します（マルチラウンドトリップ（multi-round-trip）リクエスト）。

mode="auto" でハンドシェイクになるのは、サーバーが古すぎてほかに手がないときだけです。mode="legacy" ならハンドシェイクが保証されます。Client(...) に sampling_callback を渡すとき、リクエストとして駆動させたい elicitation_callback を渡すとき、あるいは message_handler を渡すときは、いつでもこれを使ってください。それぞれについては クライアントのコールバック で説明しています。

バージョンのピン留め

mode には新世代のプロトコルバージョン文字列も指定できます。現時点でその集合はちょうど ["2026-07-28"] です。

from mcp import Client
from mcp.server import MCPServer

mcp = MCPServer("Bookshop")


@mcp.tool()
def search_books(query: str) -> str:
    """Search the catalog by title or author."""
    return f"Found 3 books matching {query!r}."


async def main() -> None:
    async with Client(mcp, mode="2026-07-28") as client:
        print(client.protocol_version)

ピン留めすると何も送りません。プローブもハンドシェイクもありません。クライアントはローカルで 2026-07-28 を採用し、async with から戻った瞬間に接続は使える状態です。

ピン留めは「呼び出し側」がする約束です。サーバーがそのバージョンを話せるとすでに知っている、という約束です。クライアントは確認しません。

None

ピン留めできるのは新世代のバージョンだけです。ハンドシェイク世代の文字列は、I/O が発生する前の構築時点で拒否され、代わりに何を書くべきかはエラーが教えてくれます。

ValueError: mode must be 'legacy', 'auto', or one of ['2026-07-28']; got '2025-06-18' ('2025-06-18' is a handshake-era version; use mode='legacy')

prior_discover を使った再接続

プローブは安価ですが、それでも再接続のたびに支払うラウンドトリップであり、答えが変わることはほとんどありません。

なので取っておきましょう。auto で接続した後、client.session.discover_result にはサーバーが送った DiscoverResult がそのまま入っています。supported_versions、capabilities、instructions、そしてサーバーが結果の _meta に刻んだ識別情報です。次回はそれを prior_discover= として渡します。

from mcp import Client
from mcp.server import MCPServer

mcp = MCPServer("Bookshop")


@mcp.tool()
def search_books(query: str) -> str:
    """Search the catalog by title or author."""
    return f"Found 3 books matching {query!r}."


async def main() -> None:
    async with Client(mcp) as client:
        saved = client.session.discover_result

    async with Client(mcp, mode="2026-07-28", prior_discover=saved) as client:
        print(client.protocol_version)
        if client.server_info is not None:
            print(client.server_info.name)

2026-07-28
Bookshop

2 回目の接続はネゴシエーションのラウンドトリップがゼロで、それでも相手が誰なのかを正確に把握しています。これがピン留めモードの正しい使い方です。mode= でバージョンを指定し、prior_discover= で識別情報を与えます。✨

DiscoverResult は Pydantic モデルです。saved.model_dump_json() をファイルやキャッシュに保存し、次のプロセスで DiscoverResult.model_validate_json(...) を使って復元します。

4 つのモード

まとめ

• MCP にはハンドシェイク世代（2025-11-25 まで、initialize ハンドシェイク）と新世代（2026-07-28、server/discover）があります。Client がその橋渡しをします。
• mode="auto" がデフォルトです。プローブし、だめならフォールバックします。ほかの 3 行のどれかに当てはまらない限り、そのままにしておいてください。
• 「何になったのか」の答えは、いつでも client.protocol_version です。
• mode="legacy" はハンドシェイクを強制します。サンプリング、プッシュ型のエリシテーション（elicitation）、message_handler といったサーバー起点のリクエストに必要なのはこれです。
• バージョンのピン留め（mode="2026-07-28"）はネゴシエーションの通信を一切送りません。その代償として client.server_info が None になります。
• prior_discover= がその代償を取り戻します。client.session.discover_result を保存し、それを使って再接続すれば、両方が手に入ります。

新世代の接続にはプッシュ用のチャネルがありません。では 2026 年世代のサーバーは、呼び出しの途中でどうやって質問するのでしょうか。結果として返すのです。詳しくは マルチラウンドトリップリクエスト を参照してください。