Home
Vibe
Studio

Déboguer les connecteurs

Le débugueur de Connecteurs vous permet de tester un serveur de Connecteur MCP avant de l'utiliser avec Studio. Utilisez-le pour vérifier l'accessibilité du serveur, la configuration de l'authentification, la découverte des outils et les erreurs de validation depuis Studio.

i
Information

Public Preview

Le débugueur de connecteurs est en Public Preview. La couverture de validation et les détails des erreurs peuvent évoluer au fur et à mesure que nous ajoutons des vérifications de compatibilité MCP.

Avant de commencer

Avant de commencer

Vous devez avoir accès à Studio et à l'URL du serveur de Connecteur MCP que vous souhaitez tester. Si le serveur nécessite une authentification, préparez l'une des options suivantes :

  • Un en-tête HTTP statique, par exemple Authorization: Bearer <token>.
  • Des identifiants client OAuth2 pour le serveur du Connecteur.

Les identifiants configurés dans le débugueur ne sont pas stockés. Ils durent uniquement pendant la session en cours.

Si votre Connecteur utilise OAuth2, configurez cette URI de redirection dans votre application OAuth :

https://console.mistral.ai/build/connectors/debugger/oauth-callback
Ouvrir le débugueur de Connecteurs

Ouvrir le débugueur de Connecteurs

  1. Ouvrez Studio.
  2. Dans le menu de gauche, cliquez sur Connecteurs.
  3. Cliquez sur Debugger dans le coin supérieur droit.

Vous pouvez également ouvrir directement le débugueur de Connecteurs.

Configurer le test du Connecteur

Configurer le test du Connecteur

Saisissez d'abord l'URL du Connecteur. Ajoutez des identifiants uniquement si le serveur de Connecteur les exige.

  1. Dans le champ d'URL du Connecteur, saisissez l'URL du serveur MCP.

  2. Si le serveur exige des identifiants, cliquez sur l'icône des paramètres à côté de Run diagnostic.

  3. Dans Credentials, sélectionnez Custom header ou OAuth 2.0.

  4. Pour un en-tête personnalisé, définissez Header name sur Authorization et Header value sur Bearer <token>.

  5. Pour OAuth, saisissez Client ID et Client Secret.

  6. Confirmez que Redirect URI affiche l'URL de callback du débugueur :

    https://console.mistral.ai/build/connectors/debugger/oauth-callback

  7. Cliquez sur Run diagnostic.

Attention

Testez uniquement les serveurs de Connecteurs auxquels vous faites confiance. Le débugueur envoie les en-têtes ou identifiants configurés à l'adresse du serveur que vous fournissez.

Exécuter un diagnostic

Exécuter un diagnostic

Le débugueur exécute le diagnostic et génère un rapport sur le côté droit de la fenêtre. Si vous devez relancer le test après avoir modifié l'URL ou les identifiants, cliquez sur Run again.

Lorsqu'une étape échoue, le rapport explique quelle étape a échoué et inclut les détails de dépannage. Selon l'échec, le rapport peut inclure :

  • Likely cause
  • Suggested fix
  • Raw response
  • Copy as curl
  • Headers
  • Body
  • Un rapport JSON pour l'étape en échec

Par exemple, si le serveur renvoie du HTML au lieu d'une réponse MCP JSON-RPC, le rapport peut afficher The server responded but does not appear to be an MCP server comme cause probable et Verify the URL points to an MCP server, not a regular web page or REST API comme solution suggérée.

Un rapport d'étape en échec peut ressembler à ceci :

{
  "step": "transport_detection",
  "status": "error",
  "duration": 259,
  "data": {
    "attempt": {
      "request": {
        "method": "POST",
        "url": "https://chaos-mcp.example.com/"
      },
      "response": {
        "status": 200,
        "headers": {
          "content-type": "text/html; charset=utf-8"
        },
        "body": "<!DOCTYPE html><html lang=\"en\">..."
      }
    }
  },
  "error": {
    "type": "not_mcp_server"
  }
}
Examiner un test réussi

Examiner un test réussi

Quand toutes les vérifications réussissent, le rapport final indique que le serveur MCP est prêt. Le rapport inclut la version du protocole MCP, un lien Voir la documentation officielle, des métriques de résumé, des instructions lorsqu'elles sont disponibles et le contenu MCP découvert.

Un rapport réussi peut inclure :

  • Serveur MCP prêt
  • Protocole 2025-11-25
  • Voir la documentation officielle
  • Outils : le nombre d'outils découverts
  • Prompts : le nombre de prompts découverts
  • Ressources : le nombre de ressources découvertes
  • Durée : la durée de la validation
  • Vérifications : le nombre de vérifications réussies, par exemple 3/3
  • Instructions : les instructions du serveur lorsque le serveur MCP les renvoie

La section Tools répertorie les outils découverts. Vous pouvez utiliser Search... pour les filtrer et sélectionner Interactive pour les inspecter. Par exemple, un serveur de test peut renvoyer des outils nommés echo, add et current_time. La sélection de echo affiche Echo back the provided message. comme description et affiche le schéma d'entrée :

{
  "type": "object",
  "properties": {
    "message": {
      "description": "Text to echo",
      "type": "string"
    }
  },
  "required": ["message"]
}
Résoudre les erreurs MCP typiques

Résoudre les erreurs MCP typiques

Utilisez d'abord le rapport généré. Il affiche l'étape en échec ainsi que les champs Likely cause et Suggested fix les plus précis disponibles. Les cas ci-dessous expliquent les problèmes fréquents de serveur MCP qui peuvent apparaître dans le rapport.

Prochaines étapes après un test réussi

Prochaines étapes après un test réussi

Une fois que le débugueur a validé votre serveur de Connecteur, utilisez le rapport pour confirmer sa compatibilité avec Studio. Le flux de création de Connecteurs n'est pas inclus dans cette version.