Aller au contenu

Dépannage

Points de contrôle à vérifier en cas de connexion ou d’appel en échec, quel que soit le client MCP utilisé.

Liste de vérification

  • Redémarrage de l’application : après toute modification de configuration, assurez-vous que le client a bien été redémarré. Certaines applications de bureau (ChatGPT, Claude Desktop...) ne se ferment pas en fermant simplement leur fenêtre : utilisez le menu File > Quit (Cmd+Q sur macOS, Ctrl+Q sur Windows/Linux).
  • URL exacte : vérifiez que le client joint bien le point d’accès exact, slash final inclus.
  • En-tête d’authentification : confirmez le format attendu, Authorization: Bearer AUTHKEY, ou Authorization: AUTHKEY sans préfixe pour un connecteur qui n’ajoute pas Bearer automatiquement.
  • Permissions de l’authkey : l’authkey doit appartenir à un utilisateur Canopsis actif, disposant des permissions nécessaires à l’opération API demandée.
  • Journaux : inspectez le journal du serveur MCP pour la requête entrante, et le journal canopsis-internal-api pour le statut de l’appel transmis.
  • Distinguer 401/403 de 404 : un 401 ou 403 de canopsis-internal-api indique un problème d’identifiants ou de permissions ; un 404 peut être un résultat parfaitement valide (alarme absente).
  • "Invalid parameters" sur une ressource manquante : si un client signale des paramètres invalides pour une resource manquante, inspectez le corps JSON-RPC. Voir la limitation connue ci-dessous.
  • Clients cloud : vérifiez la résolution DNS publique, un certificat TLS de confiance, les règles de pare-feu, et les délais d’attente du reverse proxy.
  • CORS : gardez les origines autorisées restrictives. CORS ne concerne que les clients exécutés dans un navigateur et ne remplace jamais l’authentification.
  • Exposition publique : n’exposez jamais publiquement un point d’accès MCP en écriture sans TLS, authentification, limitation de débit, journalisation d’audit et authkey à moindre privilège.

Limitation connue : ressource introuvable

Une resource MCP correspondant à une alarme absente peut remonter, selon le client, comme une erreur "paramètres invalides" plutôt qu’un simple "non trouvé". Le détail de cette limitation (code JSON-RPC -32602 au lieu de -32002) est documenté dans Référence des outils et ressources. Traitez ce cas comme une absence normale de résultat, pas comme une erreur de configuration côté client.

Voir aussi