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+Qsur macOS,Ctrl+Qsur 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, ouAuthorization: AUTHKEYsans préfixe pour un connecteur qui n’ajoute pasBearerautomatiquement. - 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-apipour le statut de l’appel transmis. - Distinguer 401/403 de 404 : un
401ou403decanopsis-internal-apiindique un problème d’identifiants ou de permissions ; un404peut ê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¶
- Sécurité et audit : authentification, permissions, kill switch d’écriture
- Installation et configuration : vérifier que le serveur répond