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

Avant de commencer, vérifie 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 des notes ont été synchronisées au cours du dernier jour.
• Tu peux te connecter via le navigateur. Le flux d’authentification MCP ouvre une fenêtre de navigateur.
• Si tu comptes utiliser une clé d’API plutôt qu’OAuth : les clés d’API demandent l’offre Pro. La connexion OAuth fonctionne sur toutes les offres, y compris Free, et c’est la méthode recommandée. Free et Starter ne peuvent ni créer ni utiliser de clés d’API.

Point de terminaison

https://mcp.engram.page

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

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

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.

Essaie

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)

• 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.

Révocation

Pour déconnecter Cursor d’Engram :

1. Dans Cursor, trouve l’entrée du connecteur ou du serveur MCP et supprime-la.
2. Dans Engram, ouvre ton compte → API Keys & Sessions et révoque la session correspondante.
3. Le jeton OAuth est invalidé côté serveur. 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.

Prochaines étapes

MCPVue d'ensemble du protocole.

PortéesCe que couvre l'autorisation.

Toutes les intégrationsChoisis un autre client.