• SYNTAXE
  • SCHÉMA
  • LOGIQUE
  • HUMAIN

Vérifier les spécifications API avec votre IA

Connectez ce MCP à votre client IA pour auditer les définitions d'API externes. Il détecte instantanément les défauts de structure et les erreurs de schéma.

Demandez à l'IA à propos de cette page

Réponse rapide

Comment vérifier les spécifications API avec mon IA ?

Votre IA utilise l'outil validate_openapi pour analyser les fichiers OpenAPI bruts. Elle détecte les erreurs de syntaxe, les champs obligatoires manquants ou les références brisées. Vous obtenez un rapport clair de chaque problème structurel, ce qui évite les échecs d'intégration avant même de coder.

Localisation des erreurs.

Résultats de l'audit.

L'IA traite la spécification et classe les résultats selon ces catégories.

SYNTAXE

Structure corrompue

L'IA identifie les fichiers YAML ou JSON mal formés qui empêchent la lecture du fichier. Elle vous indique précisément les numéros de ligne en cause.

SCHÉMA

Définitions invalides

L'IA détecte les propriétés obligatoires manquantes ou les types de données incorrects. Cela garantit la conformité à la norme OpenAPI.

LOGIQUE

Références brisées

L'IA repère les liens morts et les pointeurs $ref non résolus. Vous saurez exactement quels composants manquent à la définition.

HUMAIN

Révision manuelle requise

L'IA signale les descriptions ambiguës ou les incohérences logiques. À vous de décider si ces nuances impactent votre implémentation.

Le flux

Ce que fait l'IA lors de la réception d'une spécification.

L'IA agit comme un garde-fou pour garantir que la documentation est réellement exploitable.

  1. Ingestion du fichier

    Votre IA lit le contenu OpenAPI brut que vous fournissez, qu'il s'agisse d'un fichier local ou d'une URL.

    validate_openapi

  2. Audit structurel

    L'IA vérifie la conformité du fichier par rapport aux règles officielles de la spécification OpenAPI.

    validate_openapi

  3. Détection des liens morts

    L'agent traque les références internes pointant vers des objets inexistants.

    validate_openapi

  4. Rapport d'écarts

    L'IA résume l'ensemble des erreurs et avertissements dans une liste lisible.

    validate_openapi

Essayez

Copiez ces exemples pour commencer.

Utilisez ces prompts pour lancer le processus de validation.

Points de départ

Remplacez les chemins de fichiers ou les URL par votre propre documentation partenaire.

@seriousme/openapi-schema-validator Connector

Tout est prêt. Choisissez votre client MCP et suivez les instructions de configuration.

Lien du connecteurhttps://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcp

Claude Desktop

Suivez les étapes ci-dessous pour vous connecter en quelques secondes.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — @seriousme/openapi-schema-validator capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopier
{
  "mcpServers": {
    "openapi-validator-engine-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcp"
    }
  }
}
Copiez dans le chat04

  • Valide cette spécification OpenAPI pour moi : https://api.partner.com/v3/openapi.json

  • Vérifie le fichier local ./specs/auth-api.yaml pour détecter d'éventuels pointeurs $ref brisés.

  • Lance une validation sur cette spécification et dis-moi s'il manque des champs obligatoires dans l'objet user.

  • Analyse cette définition d'API et liste toutes les erreurs de syntaxe trouvées dans la section paths.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Commencez ici

Connectez OpenAPI Validator Engine une fois, puis interrogez.

Liez simplement le MCP à votre client. Vos identifiants restent chiffrés et vous pouvez auditer vos spécifications immédiatement.

Connecter OpenAPI Validator Engine à votre IA

FAQ

Fonctionnement de la tâche.

  • 01

    L'IA peut-elle corriger automatiquement les erreurs de la spécification ?

    Non. L'IA identifie et signale les erreurs, mais vous devez modifier le fichier manuellement pour les corriger.

  • 02

    L'IA vérifie-t-elle si l'API fonctionne réellement ?

    Non. Cet outil valide uniquement la structure et la syntaxe du fichier de définition, pas le comportement réel du point de terminaison (endpoint).

  • 03

    Puis-je valider des spécifications hébergées sur des URL privées ?

    Oui, à condition que votre client IA dispose de l'accès réseau nécessaire pour atteindre cette URL.

  • 04

    L'IA va-t-elle supprimer mes fichiers originaux ?

    Non. L'IA se contente de lire le contenu pour effectuer la validation ; elle n'a aucune permission pour modifier ou supprimer vos fichiers locaux.

  • 05

    Prend-elle en charge les formats JSON et YAML ?

    Oui, la validation fonctionne pour les deux formats standards OpenAPI.

  • D'autres questions sur OpenAPI Validator Engine ? La page du connecteur y répond. Voir toutes les capacités du connecteur OpenAPI Validator Engine

Connectez @seriousme/openapi-schema-validator à Claude, Cursor, ChatGPT et d'autres