Changelog

Wie sich die Schnittstelle weiterentwickelt

Additiv-only innerhalb von v1

Neue optionale Felder und neue Tools kommen jederzeit ohne Breaking Change dazu. Ein bestehendes Feld ändert nie seinen Typ, wird nie verpflichtend und verschwindet nie. Ein bestehendes Tool ändert seine Ausgabe nie inkompatibel und wird nie ohne das Deprecation-Fenster unten entfernt. Ein Breaking Change bekommt immer eine neue Version (/api/mcp/v2/) neben v1, nie einen In-place-Bruch.

90-Tage-Deprecation-Fenster

Ein Tool oder Feld, das entfernt werden soll, wird zuerst hier als datierter Eintrag angekündigt, am selben Tag mit einem Deprecation-Hinweis in der eigenen Beschreibung in tools/list markiert, und bleibt danach mindestens 90 Tage lang aufrufbar. Eine Entfernung vor Ablauf des Fensters ist ein Vertragsbruch, das Fenster darf nur verlängert werden.

Versionsstempel ohne Drift

tools/list trägt apiVersion und dieselbe Zahl, die der neueste Eintrag hier deklariert. Der Website-Build schlägt fehl, wenn beide auseinanderlaufen, sodass Tool-Referenz und Changelog nie stillschweigend divergieren können.