Veraltete Features

Maschinelle Übersetzung

Diese Seite wurde automatisch aus der englischen Dokumentation übersetzt, und die englische Seite ist die maßgebliche Fassung. Wenn sich etwas falsch liest, erklärt Übersetzungen, wie du es melden kannst.

Die Spec 2026-07-28 mustert fünf Dinge aus. Das SDK implementiert jedes davon weiterhin, und jedes davon trägt jetzt eine Deprecation-Warnung.

Die Tabelle unten nennt jedes veraltete Feature, den Grund, warum es verschwindet, und den Ersatz, auf dem du aufbauen solltest.

Was veraltet ist

Veraltet	Warum	Was du stattdessen tust
Roots: `ctx.session.list_roots()`, `client.send_roots_list_changed()`, der `list_roots_callback=`, den du an `Client(...)` übergibst	SEP-2577 mustert die Capability aus.	Nimm die Pfade als gewöhnliche Tool-Argumente oder Ressourcen-URIs entgegen, oder bette einen `ListRootsRequest` in ein `InputRequiredResult` ein (siehe Multi-Roundtrip-Requests).
Serverseitig initiiertes Sampling: `ctx.session.create_message()`, der `sampling_callback=`, den du an `Client(...)` übergibst	SEP-2577 mustert die Capability aus.	Gib `InputRequiredResult` zurück und lass den Client den Aufruf wiederholen (siehe Multi-Roundtrip-Requests).
Protokoll-Logging: `ctx.log()`, `ctx.debug()`, `ctx.info()`, `ctx.warning()`, `ctx.error()`, `ctx.session.send_log_message()`, `client.set_logging_level()`	SEP-2577 mustert die Capability aus. Innerhalb des Protokolls ersetzt sie nichts.	Gewöhnliches `import logging` nach stderr (siehe Logging).
`ping`: `client.send_ping()`	Aus dem Protokoll entfernt, nicht bloß veraltet. In 2026-07-28 gibt es keine Methode `ping`.	Nichts. Es funktioniert nur gegen eine `mode="legacy"`-Verbindung.
Progress vom Client zum Server: `client.send_progress_notification()`	2026-07-28 erlaubt Progress nur noch vom Server zum Client.	Es gibt nichts zu senden. Dein Server meldet Fortschritt mit `ctx.report_progress()` (siehe Progress).

Drei Dinge ergeben sich aus dieser Tabelle:

Roots, Sampling und Logging gehören zusammen. Ein einziger Vorschlag, SEP-2577, erklärt alle drei Capabilities auf einmal für veraltet.
Sampling und Roots teilen ein tieferes Problem: Es sind Stellen, an denen ein Server einen Request an den Client sendet. Genau diese Richtung ersetzt 2026-07-28 durch Multi-Roundtrip-Requests (multi-round-trip requests). Verschwunden sind die eigenständigen RPC-Methoden (sampling/createMessage, roots/list und das Push-artige elicitation/create); die Payload-Typen CreateMessageRequest / ListRootsRequest / ElicitRequest bleiben erhalten, eingebettet in InputRequiredResult.input_requests, und auf dem Client landen sie bei denselben Callbacks.
ping fällt aus der Reihe. Das Protokoll erklärt es nicht für veraltet, es entfernt es. Die SDK-Methode warnt trotzdem (ihre Meldung sagt removed, nicht deprecated), und ein Aufruf auf einer modernen Verbindung wird mit „Method not found“ beantwortet.

Veraltet ist ein Hinweis, kein Verbot

Heute geht nichts kaputt.

Jede der oben genannten Methoden funktioniert weiterhin gegen jede Session, die 2025-11-25 oder früher ausgehandelt hat. Pinne mode="legacy" auf dem Client, und du bekommst exakt das Verhalten von vor 2026. Auf der Leitung ändert sich nichts, und das Aushandeln der Capabilities bleibt unverändert.

Was sich ändert: Du bekommst eine sichtbare Warnung, wenn eine davon zum ersten Mal läuft:

MCPDeprecationWarning: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

MCPDeprecationWarning ist eine Unterklasse von UserWarning, nicht von DeprecationWarning. Das ist Absicht: Pythons Standardfilter zeigt DeprecationWarning nur in Code, der direkt als __main__ läuft – so erklären Bibliotheken Dinge für veraltet, und zwei Jahre lang merkt es niemand. Diese hier erscheint überall, ganz ohne -W-Flag.

Warning

Der Hinweischarakter endet an der Leitung. Sampling und Roots sind Requests vom Server an den Client, und eine 2026-07-28-Session hat keinen Kanal, der einen solchen transportiert. Rufst du ctx.session.create_message() in einem Tool auf einer modernen Verbindung auf, wird die Warnung trotzdem ausgelöst, und danach schlägt das Senden mit einem Fehler fehl:

Cannot send 'sampling/createMessage': this transport context has no back-channel
for server-initiated requests.

Zwei Signale, in dieser Reihenfolge. Die MCPDeprecationWarning wird in dem Moment ausgelöst, in dem du die Methode aufrufst, auf jeder Verbindung. Der Fehler ist das, was zurückkommt, wenn das SDK anschließend zu senden versucht. Beide funktionieren nur auf einer mode="legacy"-Verbindung von Anfang bis Ende, deren Client den passenden Callback registriert hat.

Die Warnung unterdrücken

Tu es nicht, in neuem Code.

Ein Server, den du pflegst und der tatsächlich Clients von vor 2026 bedient, hat aber jedes Recht auf ein ruhiges Log. Filtere die Kategorie, bevor der erste veraltete Aufruf läuft:

import warnings

from mcp import MCPDeprecationWarning

warnings.filterwarnings("ignore", category=MCPDeprecationWarning)

Das ist die ganze API. Es gibt keinen Schalter pro Methode, und du willst auch keinen: Der Sinn einer einzigen Kategorie ist, dass eine Zeile sie zum Schweigen bringt und eine Zeile sie zurückholt.

Check

Dreh den Filter um, und du bekommst einen Regressionstest geschenkt. Füge "error::mcp.MCPDeprecationWarning" zur Einstellung filterwarnings in deiner pytest-Konfiguration hinzu, und der veraltete Aufruf wirft eine Exception, statt zu warnen. Ein Tool namens old_log, das noch ctx.info() aufruft, besteht nicht mehr und meldet stattdessen:

Error executing tool old_log: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

Eine Zeile pytest-Konfiguration, und ein veralteter Aufruf kann sich nie wieder in deine Codebasis schleichen, ohne einen Test fehlschlagen zu lassen.

Zusammenfassung

Die Spec 2026-07-28 erklärt Roots, serverseitig initiiertes Sampling und Protokoll-Logging für veraltet (alle SEP-2577), beschränkt Progress auf die Richtung vom Server zum Client und entfernt ping.
Die Ersatzspalte weist dir den Weg: Multi-Roundtrip-Requests für Sampling und Roots, Logging für Logging, Progress für Progress. ping braucht gar nichts.
Veraltet ist ein Hinweis: keine Änderungen auf der Leitung, alles funktioniert weiterhin gegen Sessions von vor 2026, und du bekommst eine sichtbare MCPDeprecationWarning (eine UserWarning, also standardmäßig aktiv).
Sampling und Roots brauchen zusätzlich einen Rückkanal (back-channel), den eine 2026-07-28-Session nicht hat. Auf einer modernen Verbindung warnen sie und werfen dann eine Exception.
warnings.filterwarnings("ignore", category=MCPDeprecationWarning) bringt die ganze Kategorie zum Schweigen; "error::mcp.MCPDeprecationWarning" in pytest macht daraus einen fehlschlagenden Test.
Neuer Code sollte auf nichts davon aufbauen.

Jede andere Seite dieser Dokumentation vermittelt die aktuelle API.