MCP Dépannage
Points de terminaison
Section intitulée « Points de terminaison »https://mcp.engram.pageFailed to connect
Section intitulée « Failed to connect »- URL incorrecte. Le point de terminaison MCP se trouve à
/api/mcp(voir points de terminaison ci-dessus). L’hôte sans chemin n’est pas le point de terminaison MCP et renvoie 404. - Auto-hébergement TLS. Le point de terminaison MCP doit être HTTPS. HTTP non sécurisé est rejeté par les clients conformément à OAuth 2.1.
- Le serveur backend est inaccessible.
Vérifie que tu peux accéder directement à/api/health`. Si cela échoue, MCP ne peut absolument pas fonctionner.
Authorization failed
Section intitulée « Authorization failed »- Compte inactif. Connecte-toi à
app.engram.pageet vérifie que ton abonnement est valide. - L’installation n’est pas terminée. Termine la configuration sur
app.engram.page(les conditions générales, et l’étape du coffre pour certains comptes). L’erreur 403 inclut un lien vers l’étape manquante. - Limitation de débit pendant l’authentification OAuth. Attends une minute et réessaie.
Claude ne trouve aucune note
Section intitulée « Claude ne trouve aucune note »- Vérifie que le coffre a bien été synchronisé depuis Obsidian. Consulte le Centre de synchronisation et
app.engram.page. - Vérifie que le jeton OAuth possède bien la portée
mcp; réajoute le Connecteur si tu as ignoré l’étape d’autorisation lors de la première installation. - Essaie une requête plus précise. La recherche sémantique renvoie les K premiers résultats, donc les requêtes vagues sur un grand coffre peuvent ne pas afficher ce que tu attends.
Token expired
Section intitulée « Token expired »Les jetons OAuth ont une durée de vie limitée. La plupart des clients gèrent automatiquement le renouvellement ; réessaie l’opération. Si l’erreur persiste, supprime et réajoute le Connecteur.
Codex n’a plus accès à Engram
Section intitulée « Codex n’a plus accès à Engram »Codex 0.163 et versions antérieures peuvent continuer à réessayer une connexion qui n’est plus valide, ou perdre la connexion, au lieu de te demander de te reconnecter (problèmes remontés openai/codex#48507 et openai/codex#39054, tous deux toujours ouverts). Codex 0.164.0 arrête de réessayer une connexion refusée, donc mets à jour Codex en premier.
Si les outils Engram continuent de ne pas fonctionner, reconnecte-les. Exécute cette commande, en utilisant le nom que tu as donné au serveur lors de son ajout :
codex mcp login engramOù trouver plus d’informations
Section intitulée « Où trouver plus d’informations »- Journaux du serveur : pour l’auto-hébergement, consulte Auto-hébergement
- Journaux côté client : Claude Bureau → Aide → Ouvrir la console de développement
- Signale les problèmes sur engram-app/engram