非推奨の機能
2026-07-28 の仕様では、5 つのものが役目を終えます。SDK は今もその 5 つすべてを実装しており、そのすべてに非推奨の警告が付くようになりました。
下の表は、非推奨になった機能それぞれについて、なくなる理由と、代わりに土台にすべきものを挙げています。
非推奨になるもの
| 非推奨 | 理由 | 代わりにすること |
|---|---|---|
ルート（roots）：ctx.session.list_roots()、client.send_roots_list_changed()、Client(...) に渡す list_roots_callback= |
SEP-2577 がこのケイパビリティを非推奨にします。 | パスを通常のツール引数やリソース URI として受け取るか、InputRequiredResult に ListRootsRequest を埋め込みます（マルチラウンドトリップ（multi-round-trip）リクエスト を参照）。 |
サーバー起点のサンプリング：ctx.session.create_message()、Client(...) に渡す sampling_callback= |
SEP-2577 がこのケイパビリティを非推奨にします。 | InputRequiredResult を返し、クライアントに呼び出しを再試行させます（マルチラウンドトリップリクエスト を参照）。 |
プロトコルのロギング：ctx.log()、ctx.debug()、ctx.info()、ctx.warning()、ctx.error()、ctx.session.send_log_message()、client.set_logging_level() |
SEP-2577 がこのケイパビリティを非推奨にします。プロトコル内でこれに代わるものはありません。 | stderr へ出力する通常の import logging（ロギング を参照）。 |
ping：client.send_ping() |
単なる非推奨ではなく、プロトコルから削除されました。2026-07-28 には ping メソッドがありません。 |
何もありません。mode="legacy" の接続に対してしか動作しません。 |
クライアントからサーバーへの進捗：client.send_progress_notification() |
2026-07-28 では、進捗はサーバーからクライアントへの方向だけになります。 | 送るものはありません。進捗はサーバー側が ctx.report_progress() で報告します（進捗 を参照）。 |
この表から 3 つのことがわかります。
- ルート、サンプリング、ロギングはひとまとまりです。SEP-2577 という 1 つの提案が、3 つのケイパビリティを一度にすべて非推奨にしています。
- サンプリングとルートには、より根深い共通の問題があります。どちらもサーバーがクライアントにリクエストを送る場面だという点です。2026-07-28 が マルチラウンドトリップリクエスト で置き換えるのは、まさにこの方向の通信全体です。なくなるのは単独の RPC メソッド（
sampling/createMessage、roots/list、プッシュ型のelicitation/create）です。CreateMessageRequest/ListRootsRequest/ElicitRequestというペイロード型はInputRequiredResult.input_requestsに埋め込まれる形で残り、クライアント側ではこれまでと同じコールバックに届きます。 pingだけは毛色が違います。プロトコルはこれを非推奨にするのではなく、削除します。SDK のメソッドは依然として警告を出し（メッセージは「deprecated」ではなく「removed」と述べます）、現行仕様の接続で呼び出すと「Method not found」が返ります。
非推奨は勧告にすぎない
今日の時点で壊れるものはありません。
上に挙げたメソッドはすべて、2025-11-25 以前で交渉されたセッションに対しては引き続き動作します。クライアントで mode="legacy" を固定すれば、2026 年より前とまったく同じ挙動になります。通信上の変更はなく、ケイパビリティの交渉も変わりません。
変わるのは、それぞれが最初に実行されたときに、目に見える警告が出る点です。
MCPDeprecationWarning: The logging capability is deprecated as of 2026-07-28 (SEP-2577).
MCPDeprecationWarning は UserWarning のサブクラスであり、DeprecationWarning のサブクラスではありません。これは意図的なものです。Python のデフォルトのフィルターは、__main__ として直接実行されるコードでしか DeprecationWarning を表示しません。ライブラリが何かを非推奨にしても 2 年間誰も気づかない、というのはこの仕組みのせいです。この警告は -W フラグなしで、どこでも表示されます。
Warning
「勧告にすぎない」のは通信路の手前までです。サンプリングとルートはサーバーからクライアントへの「リクエスト」であり、2026-07-28 のセッションにはそれを運ぶチャネルがありません。現行仕様の接続のツール内で ctx.session.create_message() を呼び出すと、警告はやはり出ますが、そのあと送信がエラーで失敗します。
Cannot send 'sampling/createMessage': this transport context has no back-channel
for server-initiated requests.
シグナルは 2 つ、この順番です。MCPDeprecationWarning は、どの接続でもメソッドを呼び出した瞬間に発生します。エラーは、そのあと SDK が送信を試みたときに返ってくるものです。この 2 つの機能がエンドツーエンドで動作するのは、対応するコールバックをクライアントが登録した mode="legacy" の接続だけです。
警告を抑止する
新しいコードでは、しないでください。
ただし、保守しているサーバーが実際に 2026 年より前のクライアントを相手にしているなら、ログを静かに保つ正当な理由があります。最初の非推奨の呼び出しが実行される前に、このカテゴリをフィルターしてください。
import warnings
from mcp import MCPDeprecationWarning
warnings.filterwarnings("ignore", category=MCPDeprecationWarning)
API はこれだけです。メソッドごとのスイッチはありませんし、必要もありません。カテゴリが 1 つである利点は、1 行で黙らせ、1 行で元に戻せることです。
Check
フィルターを逆向きにかければ、無料で回帰テストが手に入ります。pytest の設定の filterwarnings に "error::mcp.MCPDeprecationWarning" を追加すると、非推奨の呼び出しは警告ではなく例外を送出します。まだ ctx.info() を呼んでいる old_log という名前のツールは通らなくなり、次のように報告し始めます。
Error executing tool old_log: The logging capability is deprecated as of 2026-07-28 (SEP-2577).
pytest の設定を 1 行足すだけで、非推奨の呼び出しがテストを失敗させずにコードベースへ紛れ込むことは二度とありません。
まとめ
- 2026-07-28 の仕様は、ルート、サーバー起点のサンプリング、プロトコルのロギングを非推奨にし（いずれも SEP-2577）、進捗をサーバーからクライアントへの方向に限定し、
pingを削除します。 - 「代わりにすること」の列が次の行き先を示しています。サンプリングとルートには マルチラウンドトリップリクエスト、ロギングには ロギング、進捗には 進捗 です。
pingには何も必要ありません。 - 非推奨は勧告にすぎません。通信上の変更はなく、2026 年より前のセッションに対してはすべてが引き続き動作します。そして目に見える
MCPDeprecationWarningが出ます（UserWarningなので、デフォルトで有効です）。 - サンプリングとルートにはさらに、2026-07-28 のセッションにはないバックチャネル（back-channel）が必要です。現行仕様の接続では警告を出し、そのあと例外を送出します。
warnings.filterwarnings("ignore", category=MCPDeprecationWarning)でカテゴリ全体を黙らせます。pytest で"error::mcp.MCPDeprecationWarning"を指定すれば、テストの失敗に変わります。- 新しいコードは、これらのどれの上にも築くべきではありません。
このドキュメントのほかのページはすべて、現行の API を扱っています。