Dépanner une connexion MCP

En bref

Traitez une panne MCP dans un ordre fixe : confirmez l’URL officielle, observez le passage par OAuth, vérifiez les scopes, puis testez une lecture simple dans la bonne organisation. Ouvrir directement l’URL dans un navigateur ne teste pas le connecteur. Conservez le message exact et l’heure si l’erreur persiste.

Résultat attendu

Vous identifiez si le blocage vient de la configuration du client, de l’autorisation Billabex, du périmètre ou d’un appel trop fréquent.

Avant de commencer

• Gardez accès aux réglages du client IA et à Paramètres > Intégrations dans Billabex.
• Ne partagez aucun secret dans une capture ou une demande de support.

Procédure

1. Comparez l’URL du client à celle affichée par Billabex, caractère par caractère.
2. Déconnectez puis reconnectez une seule fois afin de terminer OAuth avec le bon compte.
3. Vérifiez mcp:read pour une lecture et mcp:write uniquement pour une modification.
4. Testez la liste des organisations, puis une lecture ciblée avec un identifiant connu.
5. Si l’erreur évoque une limite, espacez les appels ; sinon conservez l’heure, le client, l’outil et le message exact pour le support.

Ce que fait Billabex

Le serveur exige une authentification valide, limite les appels trop fréquents et refuse un outil quand le scope ou l’organisation ne correspond pas. Les codes et formats d’erreur à interpréter côté client sont décrits dans la documentation développeur versionnée.

Si le résultat n’est pas celui attendu

• Une réponse obtenue en ouvrant l’URL dans le navigateur ne prouve pas que le serveur est indisponible.
• Des données vides peuvent correspondre à la mauvaise organisation plutôt qu’à une panne de transport.
• Masquez jetons, cookies et en-têtes Authorization avant toute capture transmise au support.