Aller au contenu

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.

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.
https://mcp.engram.page

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.

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.

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.

  • Deux entrées engram dans Tools & MCP. Le serveur est défini à la fois dans ~/.cursor/mcp.json et .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.json au 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 search par 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.

Pour déconnecter Cursor d’Engram :

  1. Dans Cursor, trouve l’entrée du connecteur ou du serveur MCP et supprime-la.
  2. Dans l’application Engram, ouvre Paramètres → Connexions et clique sur Révoquer dans la connexion correspondante ou la clé API.
  3. 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.