OpenAPI, Postman und weitere Dateien
| Datei | Was es ist |
|---|---|
| openapi.json | Die OpenAPI-3.1-Beschreibung der API. Das ist die eine Quelle; die Referenz wird aus denselben Daten erzeugt. |
| openapi.yaml | Dasselbe als YAML. |
| postman-collection.json | Eine Postman-Collection mit einer Anfrage pro Aufruf. Setze die Variable api_key. |
| llms.txt | Eine Liste aller Seiten für AI-Assistenten. |
| llms-full.txt | Alle Seiten in einer Datei. |
| smartchat-docs.zip | Alle Seiten als Markdown plus die OpenAPI-Dateien. |
| sitemap.xml | Alle Seiten. |
Jede Seite gibt es auch als Markdown: Hänge .md an ihre Adresse an oder nutze den Link am Ende der Seite.
#Mit OpenAPI einen Client erzeugen
Jeder OpenAPI-3.1-Generator kann aus openapi.json einen Client erzeugen. Jeder Aufruf hat eine operationId, die dem Namen in dieser Referenz entspricht. Der MCP-Server nutzt für die meisten Werkzeuge denselben Namen. Wo er abweicht (zum Beispiel save_contact für create_contact und update_contact), steht der Name in x-mcp-tool und in der Spalte REST operationId der Werkzeugliste. Zusätzliche Felder mit x- beschreiben das Recht (x-scope), das Risiko (x-risk), die Wirkungen (x-effects) und das MCP-Werkzeug (x-mcp-tool).