Dépannage
Identifiez si le problème concerne l'accès à la connexion, les autorisations des outils ou le service en amont.
Traduit automatiquement de l’anglais. Lire la version originale en anglais
2 min de lecture · Guide client
Commencez par identifier l'étape défaillante : ajout de la connexion, découverte des outils, exécution d'un outil ou vérification d'une écriture. Capturez l'heure et une brève description avant de modifier les paramètres.
La connexion ne peut pas être atteinte#
Vérifiez le point de terminaison exact attribué et si le client AI prend en charge sa méthode de transport et d'authentification. Une adresse d'accueil de plateforme n'est pas un point de terminaison MCP. Utilisez la connexion sécurisée normale ; ne contournez pas un avertissement de certificat.
Si la même connexion attribuée a déjà fonctionné, indiquez quand elle a réussi pour la dernière fois et ce qui a changé chez le client. Évitez de supprimer les détails de connexion fonctionnels avant qu’un remplacement ne soit vérifié.
Référence d'erreur#
| Symptôme | Que vérifier |
|---|---|
401 à la connexion ou à la découverte | Identifiant manquant, erroné, expiré ou révoqué ; en-tête ou point de terminaison incorrect. |
403 pour une opération | Portée des informations d'identification, autorisation de l'outil ou rôle de service en amont ; identifier quelle couche l'a renvoyé. |
429 | Allocation de demande dépassée ; respecter le délai de nouvelle tentative et réduire la fréquence des requêtes. |
404 | Le point de terminaison ou l'enregistrement référencé peut être erroné ou indisponible ; vérifiez le chemin exact et le contexte. |
5xx ou indisponible | Problème de plate-forme ou de service en amont ; capturer le temps et l’étape de la demande. |
| Arguments invalides | Champ obligatoire, type de saisie, champ supplémentaire non pris en charge ou identifiant incompatible. |
| Connecté mais aucun outil attendu | Portée attribuée, ajout inactif ou non vérifié, ou découverte de client obsolète. |
| Les outils apparaissent mais les appels échouent | Autorisation en amont, droit au compte ou saisie spécifique à l'opération. |
Ce sont des points de départ pour le diagnostic. La source réelle d’une erreur HTTP est importante ; l'erreur d'autorisation d'un service n'est pas corrigée en affaiblissant l'authentification MCP.
Une séquence de diagnostic sécurisée#
Confirmez le point de terminaison, actualisez la liste des outils, comparez-la avec le transfert et exécutez le test en lecture seule convenu. En cas d'échec, enregistrez le nom de l'outil et l'erreur expurgée. Arrêtez-vous avant de répéter une action d'écriture dont le résultat est incertain.
Quoi envoyer de l'assistance#
Utilisez le liste de contrôle d'assistance. Incluez une capture d'écran expurgée ou le texte d'erreur pertinent, et non une exportation complète de la conversation ou une configuration contenant une clé.