Aller au contenu

MCP Dépannage

https://mcp.engram.page
  • 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.
  • Compte inactif. Connecte-toi à app.engram.page et 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.
  • 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.

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 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 :

Fenêtre de terminal
codex mcp login engram
  • 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