Dépannage

Problèmes courants lors de la connexion ou de l'appel d'outils, et leurs causes.

« Authentication required » à la connexion

Le serveur exige un jeton d'accès Bearer à chaque requête — un simple GET sur l'URL du serveur (par exemple en l'ouvrant dans un navigateur) renvoie toujours ce message ; ce n'est pas une erreur de votre configuration.

{
  "error": "Authentication required. POST with Authorization: Bearer <token>."
}

Des requêtes qui fonctionnaient échouent soudainement

Les jetons d'accès expirent au bout d'1 heure. Un client fonctionnel se renouvelle automatiquement grâce à son jeton de rafraîchissement — si ce n'est pas le cas du vôtre, reconnectez-le.

Un client qui fonctionnait auparavant ne fonctionne plus du tout

Quelqu'un de votre agence a peut-être révoqué la connexion de ce client depuis Paramètres → Développeur → Connexions MCP. Reconnectez-le pour obtenir une nouvelle autorisation.

« Tool not found » ou un outil au nom similaire est manquant

Les noms d'outils sont exacts et sensibles à la casse — vérifiez cette référence pour le nom précis. En mode « compact » ou « code », seuls les outils de découverte (search_os_tools, call_os_tool, …) sont listés directement ; utilisez-les pour trouver et appeler les autres par leur nom.

Un appel d'outil est rejeté pour accès manquant

La connexion n'a que mcp:read (lecture seule) — reconnectez-vous et approuvez l'accès en écriture si l'outil appelé en a besoin.

Limites de débit

Il n'existe actuellement aucune limite de débit spécifique aux appels d'outils MCP — contrairement à la limite de l'API REST, basée sur le forfait et par agence.