• SCHEMA
  • CODE
  • DOCS
  • HUMAN

Vérifier les schémas API avec votre IA et Stoplight

Connectez Stoplight à votre agent pour accéder à la documentation en direct. Une fois lié, votre IA inspecte les définitions des points de terminaison pour garantir la conformité de votre code.

Demandez à l'IA à propos de cette page

Réponse rapide

Comment vérifier les détails du schéma API avec mon IA ?

Votre agent utilise Stoplight pour récupérer les modèles OpenAPI et les définitions spécifiques des points de terminaison. Il compare ensuite votre implémentation à ces exigences réelles pour détecter les écarts. Vous obtenez une vision claire de ce que la documentation exige réellement.

Les résultats.

Où arrivent vos résultats de validation.

L'IA effectue la lecture fastidieuse de la spécification pour que vous puissiez vous concentrer sur la correction.

SCHEMA

Accès aux modèles en direct

L'agent extrait les dernières définitions OpenAPI. Vous disposez d'une source de vérité actualisée pour vos points de terminaison.

CODE

Détection des écarts

L'IA compare votre code actuel aux nœuds Stoplight. Elle identifie les types ou les chemins qui ne correspondent pas.

DOCS

Analyse des points de terminaison

Votre agent inspecte les détails de nœuds spécifiques. Cela fournit les paramètres et les structures de réponse exacts nécessaires.

HUMAN

Corrections manuelles

L'IA signale les erreurs, mais vous décidez comment refactoriser le code. Vous gardez le contrôle total sur l'implémentation finale.

Le flux

Ce que fait votre IA une fois le schéma reçu.

L'agent passe de la découverte globale du projet à l'inspection granulaire des détails.

  1. Cartographier le projet

    L'agent identifie tous les nœuds API disponibles dans votre projet Stoplight.

    list_project_nodes

  2. Récupérer les données d'endpoint

    L'agent extrait le schéma et la définition spécifiques d'un point de terminaison choisi.

    get_node_details

  3. Comparer l'implémentation

    L'agent analyse votre code et le vérifie par rapport au modèle OpenAPI récupéré.

    get_node_details

  4. Signaler les écarts

    L'agent liste les champs ou les chemins spécifiques qui ne correspondent pas à la documentation.

    list_project_nodes

Essayez

Copiez ces commandes pour commencer.

Utilisez ces prompts pour lancer le processus de vérification.

Points de départ

Remplacez les noms de projet et les chemins d'endpoint par vos données Stoplight réelles.

Stoplight Connector

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

Lien du connecteurhttps://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/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 — Stoplight capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopier
{
  "mcpServers": {
    "stoplight-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
    }
  }
}
Copiez dans le chat04

  • Liste tous les nœuds de mon projet Stoplight pour que je puisse voir les points de terminaison disponibles.

  • Récupère les détails du nœud 'user_auth' dans Stoplight et vérifie si ma fonction de connexion est conforme.

  • Vérifie le schéma de l'endpoint 'payment_gateway' par rapport à mon gestionnaire de requête actuel.

  • Trouve la définition du nœud 'order_status' et dis-moi s'il me manque des champs obligatoires.

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

Commencez ici

Connectez Stoplight une fois, puis posez vos questions.

Liez votre compte une seule fois. Vos identifiants restent cryptés et vous pouvez immédiatement interroger votre agent sur vos spécifications API.

Connecter Stoplight à votre IA

FAQ

Fonctionnement de la tâche.

  • 01

    L'IA peut-elle mettre à jour ma documentation Stoplight ?

    Non. L'IA peut uniquement lire les modèles et les définitions pour vous aider à vérifier votre code.

  • 02

    L'IA va-t-elle modifier mon code automatiquement ?

    Non. L'IA identifie les écarts et suggère des corrections, mais vous devez appliquer les changements vous-même.

  • 03

    Cela fonctionne-t-il avec n'importe quelle spécification OpenAPI ?

    Oui, tant que la spécification est accessible via les nœuds de votre projet Stoplight.

  • 04

    Puis-je l'utiliser pour trouver des paramètres manquants ?

    Oui. L'agent compare votre code aux détails des nœuds pour identifier les champs manquants ou superflus.

  • 05

    L'IA a-t-elle accès à l'intégralité de mon compte Stoplight ?

    Non. L'agent accède uniquement aux nœuds de projet spécifiques vers lesquels vous le dirigez avec les outils fournis.

  • D'autres questions sur Stoplight ? Voir toutes les capacités du connecteur Stoplight

Connectez Stoplight à Claude, Cursor, ChatGPT et d'autres