MCP-Stabilität & Versionierung

Das Stabilitätsmodell von MCP unterscheidet sich grundlegend von klassischen REST-APIs. Um langlebige KI-Integrationen zu bauen, ist die Unterscheidung zwischen fachlichen Fähigkeiten und technischen Schemas entscheidend.

Fachliche Fähigkeiten sind stabil

Sobald eine Domänenfunktion auf dem MCP-Server bereitgestellt wird, bleibt sie dauerhaft verfügbar. Wir entfernen keine Tools oder Fähigkeiten aus MCP, solange die zugrunde liegende Funktion in etg24 existiert. Ein Agent, der für die Abfrage von Einheiten oder das Erfassen von Schäden konzipiert ist, kann sich langfristig auf diese Werkzeuge verlassen.

Verträge und Schemas sind dynamisch – by design

Was sich dynamisch weiterentwickeln kann, ist die konkrete technische Definition eines Tools: Parameternamen, Schemadetails und Feldstrukturen. MCP ist als dynamisches Discovery-Protokoll konzipiert, nicht als statischer Vertrag.

Das feste Verdrahten (Hardcoding) von MCP-Tool-Parametern oder Endpunkten im Client ist ein Antipattern. Wenn ein Agent Schemas statisch voraussetzt, statt sie dynamisch abzufragen, bricht er bei der nächsten Backend-Aktualisierung – nicht wegen eines Fehlers, sondern weil er den Discovery-Mechanismus von MCP umgangen hat.

Empfohlene Integrationsmuster

• Zur Laufzeit dynamisch entdecken: Nutze stets meta.tools.search, um Werkzeuge zu finden, meta.tool.describe, um das aktuelle Schema abzufragen, und meta.tool.execute, um den Aufruf abzusetzen. Siehe den Meta-Tool-Workflow.
• Keine statische Codegenerierung aus MCP: Generiere keine festen TypeScript-Typen oder SDK-Klassen aus abgefangenen MCP-Definitionen.
• Agenten defensiv instruieren: Prompts und Agenten-Frameworks sollten benötigte Attribute auslesen und unbekannte oder neu hinzugefügte Felder im Ergebnis fehlertolerant ignorieren.
• REST für starre Typverträge: Benötigt deine Systemarchitektur fest versionierte, unveränderliche Schnittstellen für deterministische SDKs, nutze die REST API v2. REST ist für deterministische Systemintegrationen gedacht, MCP für kognitive KI-Agenten.

Stellenwert der interaktiven Tool-Referenz

Die MCP-Tool-Referenz liefert einen interaktiven Überblick über den aktuellen Tool-Bestand zur Orientierung und zum manuellen Debuggen. Da sich Werkzeuge mit kontinuierlichen Releases weiterentwickeln können, bleibt meta.tool.describe die maßgebliche Single Source of Truth zum Zeitpunkt der Ausführung.