Cursor
Cursor prend en charge MCP en natif. Dépose un fichier mcp.json,
redémarre Cursor, et OAuth s’exécute dans ton navigateur la première
fois que l’agent fait appel à Engram. Pour le contexte du protocole,
voir MCP.
Prérequis
Section intitulée « Prérequis »Avant de commencer, assure-toi que :
- Tu as un compte Engram sur app.engram.page.
- Au moins un coffre est synchronisé. Ouvre le plugin Obsidian ou l’application web et vérifie que les notes ont été synchronisées au cours des dernières 24 heures.
- Tu peux te connecter via ton navigateur. Le processus d’authentification MCP ouvre une fenêtre de navigateur.
- Si tu prévois d’utiliser une clé API au lieu d’OAuth : Les clés API fonctionnent sur tous les plans, y compris le plan gratuit. La connexion OAuth reste la méthode recommandée.
Point de terminaison
Section intitulée « Point de terminaison »https://mcp.engram.pageConfiguration
Section intitulée « Configuration »1. Modifie mcp.json. Crée ou modifie ~/.cursor/mcp.json
(global à l’utilisateur) ou .cursor/mcp.json à la racine de ton projet
(portée projet, prime sur le global pour le même nom de serveur) :
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page" } }}2. Redémarre Cursor. Quitte complètement (Cmd+Q / File → Exit)
et rouvre. Recharger la fenêtre ne suffit pas ; les serveurs MCP
s’enregistrent au démarrage de l’application.
3. Vérifie. Ouvre Settings → Tools & MCP et confirme que
engram apparaît dans la liste des serveurs.
Première authentification
Section intitulée « Première authentification »Cursor ne propose pas OAuth à la connexion. Il se déclenche au
premier appel d’outil. Ouvre une nouvelle conversation et demande à
l’agent de chercher dans ton Engram. Ton navigateur s’ouvre pour te
connecter à Engram et approuver la connexion. Cursor stocke le jeton et
le réutilise ensuite. L’autorisation accordée est la portée complète
mcp. Des portées granulaires par action
figurent sur la feuille de route.
Pour te passer d’OAuth (configurations sans interface ou à coffre partagé), remplace le bloc par une clé d’API :
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page", "headers": { "Authorization": "Bearer ${env:ENGRAM_API_KEY}" } } }}Obtiens une clé sur app.engram.page/settings/api-keys.
Dis à Cursor comment l’utiliser
Section intitulée « Dis à Cursor comment l’utiliser »Ajoute l’extrait ci-dessous à tes Cursor Rules : ~/.cursor/rules
(portée utilisateur) ou un fichier .cursor/rules/*.mdc dans un projet.
Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.Une fois connecté, demande à l’agent de Cursor :
- Cherche dans mon coffre les notes sur le processus d'entretien d'ingénieur et résume les trois principales.
- Trouve tout ce que j'ai écrit sur les embeddings le mois dernier.
Cursor appelle l’outil search d’Engram (ou get_note, write_note,
etc.), ramène les résultats et répond en contexte. Si l’outil se
déclenche, tout est en place.
Dépannage (spécifique à Cursor)
Section intitulée « Dépannage (spécifique à Cursor) »- Deux entrées
engramdans Tools & MCP. Le serveur est défini à la fois dans~/.cursor/mcp.jsonet.cursor/mcp.json. Supprime-en une (celle du projet l’emporte). - Le serveur apparaît dans Settings mais l’agent ne l’appelle
jamais. Problème connu d’injection de la configuration globale sur
certaines versions de Cursor. Contournement : déplace la configuration
vers
.cursor/mcp.jsonau niveau du projet. - OAuth ne se déclenche jamais. L’agent n’a pas encore invoqué
d’outil. Force-le : demande à l’agent d’appeler l’outil engram
searchpar son nom. Si rien ne se passe, redémarre Cursor ; un état de connexion périmé peut bloquer le premier appel.
Pour les échecs communs à tous les clients, voir Dépannage.
Révocation
Section intitulée « Révocation »Pour déconnecter Cursor d’Engram :
- Dans Cursor, trouve l’entrée du connecteur ou du serveur MCP et supprime-la.
- Dans l’application Engram, ouvre Paramètres → Connexions et clique sur Révoquer dans la connexion correspondante ou la clé API.
- Une clé API révoquée cesse de fonctionner immédiatement. Une connexion OAuth révoquée ne peut plus renouveler son accès et son jeton d’accès actuel expire en 15 minutes. Cursor devra se réauthentifier pour se reconnecter.
Pour le retirer côté client, supprime le bloc engram de ton
mcp.json et redémarre Cursor.