- SYNTAX
- SCHEMA
- LOGIK
- MENSCH
Kurzantwort
Wie prüfe ich Partner-API-Specs mit meiner KI?
Ihre KI nutzt das Tool validate_openapi, um OpenAPI-Dateien auf Syntaxfehler, fehlende Pflichtfelder oder fehlerhafte Referenzen zu scannen. Sie erhalten einen präzisen Bericht über alle strukturellen Probleme. Das verhindert Integrationsfehler, noch bevor Sie mit dem Programmieren beginnen.
Wo die Fehler liegen.
Die Audit-Ergebnisse.
Die KI verarbeitet die Spezifikation und ordnet die Funde in diese Kategorien ein.
SYNTAX
Fehlerhafte Struktur
Die KI identifiziert fehlerhaftes YAML oder JSON, das das Parsen der Datei verhindert. Sie erhalten die genauen Zeilennummern der Syntaxfehler.
SCHEMA
Ungültige Definitionen
Die KI findet fehlende Pflichtfelder oder falsche Datentypen. So wird sichergestellt, dass die Spezifikation dem OpenAPI-Standard entspricht.
LOGIK
Defekte Referenzen
Die KI findet tote Links und nicht aufgelöste $ref-Pointer. Sie sehen sofort, welche Komponenten in der Definition fehlen.
MENSCH
Manuelle Prüfung nötig
Die KI markiert mehrdeutige Beschreibungen oder logische Unstimmigkeiten. Sie entscheiden, ob diese Details für Ihre Implementierung relevant sind.
Der Ablauf
Was Ihre KI tut, wenn eine Spezifikation eintrifft.
Die KI fungiert als Gatekeeper und stellt sicher, dass die Dokumentation tatsächlich nutzbar ist.
Datei einlesen
Ihre KI liest den bereitgestellten OpenAPI-Inhalt, egal ob als lokale Datei oder über eine URL.
validate_openapiStruktur-Audit durchführen
Die KI gleicht die Datei mit den offiziellen Regeln der OpenAPI-Spezifikation ab.
validate_openapiDefekte Links finden
Der Agent sucht nach internen Referenzen, die auf nicht existierende Objekte verweisen.
validate_openapiAbweichungen melden
Die KI fasst alle Fehler und Warnungen in einer übersichtlichen Liste für Sie zusammen.
validate_openapi
Probieren Sie es
Kopieren Sie diese Vorlagen.
Nutzen Sie diese Prompts, um den Validierungsprozess zu starten.
Startpunkte
Ersetzen Sie die Dateipfade oder URLs durch Ihre tatsächliche Partner-Dokumentation.
@seriousme/openapi-schema-validator Connector
Alles bereit. Wählen Sie Ihren MCP-Client und folgen Sie den Einrichtungsschritten.
https://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcpClaude Desktop
Folgen Sie den Schritten unten, um sich in Sekunden zu verbinden.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — @seriousme/openapi-schema-validator capabilities are ready to use.
{
"mcpServers": {
"openapi-validator-engine-mcp": {
"url": "https://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcp"
}
}
}Validierung dieser OpenAPI-Spezifikation: https://api.partner.com/v3/openapi.json
Prüfe die lokale Datei ./specs/auth-api.yaml auf fehlerhafte $ref-Pointer.
Führe eine Validierung dieser Spezifikation durch und sag mir, ob im user-Objekt Pflichtfelder fehlen.
Scanne diese API-Definition und liste alle Syntaxfehler im Pfad-Abschnitt auf.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Starten Sie hier
Einmal mit der OpenAPI Validator Engine verbinden, dann fragen.
Verknüpfen Sie den MCP einfach mit Ihrem Client. Ihre Zugangsdaten bleiben verschlüsselt und Sie können sofort mit dem Audit der Spezifikationen beginnen.
OpenAPI Validator Engine mit Ihrer KI verbindenFAQ
Verhalten und Funktionen.
- 01
Kann die KI die Fehler in der Spezifikation automatisch beheben?
Nein. Die KI identifiziert und meldet die Fehler, aber Sie müssen die Datei manuell bearbeiten, um sie zu korrigieren.
- 02
Prüft die KI, ob die API tatsächlich funktioniert?
Nein. Dieses Tool validiert nur die Struktur und Syntax der Definitionsdatei, nicht das Verhalten des Live-Endpoints.
- 03
Kann ich Spezifikationen validieren, die auf privaten URLs liegen?
Ja, vorausgesetzt Ihr KI-Client verfügt über die notwendigen Netzwerkzugriffe, um diese URL zu erreichen.
- 04
Wird die KI meine Originaldateien löschen?
Nein. Die KI liest den Inhalt nur, um die Validierung durchzuführen. Sie hat keine Berechtigung, Ihre lokalen Dateien zu ändern oder zu löschen.
- 05
Werden sowohl JSON- als auch YAML-Formate unterstützt?
Ja, die Validierung funktioniert für beide gängigen OpenAPI-Formate.
Noch Fragen zur OpenAPI Validator Engine? Die Connector-Seite liefert Antworten. Alle Funktionen der OpenAPI Validator Engine sehen
Verbinde @seriousme/openapi-schema-validator mit Claude, Cursor, ChatGPT & mehr
