Tools und Schemas versionieren
Entwickeln Sie Ihren Server weiter, ohne Clients zu beeinträchtigen.
Tools und Schemas versionieren ist eine kostenlose MCP Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des MCP Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.
Teile dieser Lektion wurden noch nicht übersetzt und werden auf Englisch angezeigt.
Clients Depend on Your Shapes
Once others connect, they rely on your tool names and argument shapes. Changing them carelessly breaks every client at once.
Additive Changes Are Safe
Adding an optional parameter with a default keeps old callers working. They simply ignore the new field they do not send.
def search(q: str, limit: int = 10) -> list:
...Breaking Changes Hurt
Renaming a tool, removing an argument, or making one required is breaking. Existing clients suddenly send calls that no longer fit.
Add, Then Deprecate
To evolve a field, add the new one and keep the old. Mark the old as deprecated in its description so callers know to migrate.
Version in the Tool Name
For a real break, ship a v2 tool beside v1. Both run for a while, letting clients move over at their own pace.
@mcp.tool(name="search_v2")
def search_v2(query: str) -> list:
...The Server Reports Its Version
Your server announces a name and version during the handshake. Bump it so clients can see which release they connected to.
mcp = FastMCP("my-server")
# version surfaces in server infoFollow Semantic Versioning
Use semver: bump patch for fixes, minor for additive features, and major when you make a breaking change. The number tells a story.
Widen, Don't Narrow, Outputs
Adding a field to a result is usually safe; removing one is breaking. Treat your output schema as a promise clients parse.
Keep a Changelog
Record every tool and schema change in a changelog. Users upgrading need to see what moved, what is new, and what is gone.
Give Deprecations a Sunset
Announce when an old tool will be removed. A clear sunset date pushes migration without yanking the rug from anyone abruptly.
Test Against Old Clients
Before release, run your tests as an older client would call you. That catches accidental breaks the type checker cannot see.
Quick Check
Which change to an existing tool is safe for current clients?
Recap: Evolving Safely
Prefer additive changes, deprecate before removing, ship v2 for real breaks, follow semver, and keep a changelog. You can ship with confidence! 🚀
Häufig gestellte Fragen
Ist die Lektion „Tools und Schemas versionieren“ kostenlos?
Ja — der vollständige Text von „Tools und Schemas versionieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des MCP Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Tools und Schemas versionieren“?
Entwickeln Sie Ihren Server weiter, ohne Clients zu beeinträchtigen. Du übst MCP Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um MCP Academy zu starten?
Keine Vorkenntnisse erforderlich. MCP Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.
Wie lange dauert die Lektion „Tools und Schemas versionieren“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser MCP Academy-Lektion Code schreiben und ausführen?
Ja. Jede MCP Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Geschichtete Serverarchitektur
- Konfiguration und Secrets über die Umgebung
- Idempotente Tools mit bewussten Seiteneffekten
- Tools und Schemas versionieren