Dépannage MCP

Points de terminaison

https://mcp.engram.page

« Failed to connect »

• Mauvaise URL. Le point de terminaison MCP se trouve à /api/mcp (voir points de terminaison ci-dessus). L’hôte seul (sans chemin) n’est pas le point de terminaison MCP et renverra une 404.
• TLS en auto-hébergement. Le point de terminaison MCP doit être en HTTPS. Les clients rejettent le HTTP simple conformément à OAuth 2.1.
• Backend injoignable. Vérifie que tu peux atteindre /api/health directement. Si cela échoue, MCP ne peut pas fonctionner.

« Authorization failed »

• Compte inactif. Connecte-toi à app.engram.page et vérifie que ton abonnement est en règle.
• Onboarding incomplet. Engram exige l’acceptation des conditions d’utilisation avant que les points de terminaison de coffre (MCP inclus) soient utilisables.
• Limite de débit pendant OAuth. Attends une minute et réessaie.

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 porte bien la portée mcp ; ajoute à nouveau le connecteur si tu as sauté l’autorisation lors de la première installation.
• Essaie une requête plus précise. La recherche sémantique renvoie les top-K résultats, donc des requêtes vagues sur un gros coffre peuvent ne pas faire ressortir ce que tu attends.

« Token expired »

Les jetons OAuth ont une durée de vie limitée. La plupart des clients gèrent le renouvellement automatiquement ; réessaie l’opération. Si l’échec persiste, supprime puis rajoute le connecteur.

Où trouver plus d’informations

• Journaux côté serveur : pour l’auto-hébergement, voir Auto-hébergement
• Journaux côté client : Claude Desktop → Help → Open developer console
• Signale les problèmes sur engram-app/engram