Configuration MCP

La plupart des utilisateurs n’auront pas besoin de cette page. Chaque client IA moderne (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) propose une interface graphique qui ajoute Engram en quelques clics. Voir Intégrations IA pour le pas-à-pas par client.

Si tu préfères éditer un fichier de configuration (ou si ton client n’a pas d’interface graphique), il y a trois voies, de la plus simple à la plus manuelle : confier la configuration à ton IA, suivre les onglets par client, ou te passer complètement d’OAuth avec une clé d’API.

Laisse ton IA le configurer

La voie la plus rapide : colle le prompt ci-dessous dans ton assistant IA. Il détectera dans quel client il tourne, modifiera le bon fichier de configuration (ou lancera la bonne commande CLI) et te dira quoi faire ensuite.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

Si quelque chose tourne mal (ou si tu préfères tout faire toi-même), les onglets par client ci-dessous contiennent la recette manuelle complète.

Le point de terminaison MCP d’Engram

https://mcp.engram.page

Engram parle MCP via HTTPS. Deux façons de s’authentifier :

• OAuth (par défaut). La première fois que ton client se connecte à l’URL ci-dessus, une fenêtre de navigateur s’ouvre pour la connexion. Le client conserve ensuite un jeton et se reconnecte silencieusement. Aucune clé à copier.
• Clé d’API pour les configurations sans interface, scriptées ou à coffre partagé. Envoie la clé comme jeton Bearer dans un en-tête Authorization. Voir Authentification par clé d’API plus bas.

Pas de variables d’environnement, pas de processus serveur local dans les deux cas.

Configurer ton client

Choisis ton client ci-dessous. Chaque onglet est une recette complète : configuration, rechargement, première authentification, et où apprendre à l’IA à vraiment utiliser Engram.

Pour l’auto-hébergement, remplace l’URL cloud par l’URL /api/mcp de ton propre backend dans n’importe lequel des extraits ci-dessous. Voir la section points de terminaison ci-dessus pour les valeurs de référence.

Claude Code

1. Ajoute Engram. Utilise la CLI de Claude Code, qui modifie la configuration à ta place :

claude mcp add --transport http --scope user engram https://mcp.engram.page

L’option --scope user rend Engram disponible dans tous les projets. Retire-la (ou utilise --scope project) pour limiter Engram au .mcp.json du projet courant.

Tu préfères le faire à la main ? Ajoute ceci à ~/.claude.json (portée utilisateur) ou à .mcp.json à la racine du projet :

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recharge. Quitte ta session Claude Code actuelle et relance claude. Lance claude mcp list pour confirmer qu’Engram est enregistré.

3. Première authentification. Claude Code ne te le proposera pas automatiquement. Dans la nouvelle session, lance /mcp, sélectionne engram (il affiche △ needs authentication), puis choisis Authenticate. Ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et Claude Code stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à Claude de l’utiliser. Ajoute l’extrait ci-dessous à ~/.claude/CLAUDE.md, ton fichier d’instructions au niveau utilisateur, appliqué à tous les projets.

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.

Cursor

1. Modifie la configuration. Ajoute Engram à ~/.cursor/mcp.json (portée utilisateur) ou à .cursor/mcp.json à la racine de ton projet (portée projet) :

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recharge. Quitte complètement Cursor (Cmd+Q / File → Exit) et rouvre-le. Recharger la fenêtre ne suffit pas ; les serveurs MCP s’enregistrent au démarrage de l’application.

3. Première authentification.

La première fois que Cursor appelle Engram, ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et c’est terminé. Cursor stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à Cursor de l’utiliser. Ajoute l’extrait ci-dessous à tes Cursor Rules : ~/.cursor/rules (portée utilisateur) ou .cursor/rules 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.

VS Code

1. Modifie la configuration. Ajoute Engram à .vscode/mcp.json dans ton espace de travail. VS Code utilise servers au lieu de mcpServers et exige "type": "http" :

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recharge. Lance Developer: Reload Window depuis la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P). Un redémarrage complet de VS Code n’est pas nécessaire.

3. Première authentification.

La première fois que Copilot Chat (ou ton extension compatible MCP) appelle Engram, ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et c’est terminé. Copilot Chat (ou ton extension compatible MCP) stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à VS Code de l’utiliser. Ajoute l’extrait ci-dessous aux custom instructions de ton espace de travail (Copilot Chat → paramètres → Custom Instructions, ou l’équivalent de ton extension).

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.

Windsurf

1. Modifie la configuration. Ajoute Engram à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recharge. Quitte complètement Windsurf et rouvre-le. Recharger la fenêtre peut ne pas déclencher l’enregistrement du serveur MCP.

3. Première authentification.

La première fois que Windsurf appelle Engram, ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et c’est terminé. Windsurf stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à Windsurf de l’utiliser. Ajoute l’extrait ci-dessous au volet AI Rules de Windsurf (Workspace → AI Rules) ou à ~/.codeium/windsurf/global_rules.md pour des règles valables partout.

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.

Zed

1. Modifie la configuration. Ouvre ~/.config/zed/settings.json et ajoute Engram sous context_servers (la clé englobante propre à Zed, et non le standard mcpServers) :

{
  "context_servers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recharge. Lance zed: reload settings depuis la palette de commandes (Cmd+Shift+P). Dans les cas tenaces, quitte complètement Zed et rouvre-le.

3. Première authentification.

La première fois que l'assistant de Zed appelle Engram, ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et c’est terminé. l'assistant de Zed stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à Zed de l’utiliser. Ajoute l’extrait ci-dessous au prompt par défaut de ton assistant dans settings.json (sous assistant.default_prompt) ou via l’interface des paramètres de l’assistant.

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.

Other / Custom

1. Modifie la configuration. La plupart des clients MCP acceptent l’enveloppe standard mcpServers :

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Si ton client ne reconnaît pas cette forme, consulte sa documentation pour connaître la clé englobante attendue (VS Code utilise servers, Zed utilise context_servers).

2. Recharge. La plupart des clients ont besoin d’un redémarrage complet, et non d’un simple rechargement de fenêtre, pour enregistrer de nouveaux serveurs MCP.

3. Première authentification.

La première fois que le client appelle Engram, ton navigateur s’ouvre pour OAuth. Connecte-toi à Engram, approuve la connexion, et c’est terminé. le client stocke le jeton et le réutilise ensuite. L’autorisation accordée est aujourd’hui la portée complète mcp ; des portées granulaires par action figurent sur la feuille de route.

4. Dis à ton IA de l’utiliser. Place l’extrait ci-dessous là où ton client accepte des instructions système ou globales durables.

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.

Authentification par clé d’API

OAuth est la méthode par défaut. Utilise une clé d’API pour un accès sans interface ou scripté, pour un contrôle par connexion (bot en écriture ou agent en lecture seule), ou pour partager un coffre sans accorder une connexion complète. Une même clé authentifie à la fois MCP et l’API REST. Aujourd’hui, chaque clé porte l’accès complet de ton compte ; des portées fines par clé figurent sur la feuille de route.

Obtenir une clé

Génère-en une sur app.engram.page/settings/api-keys. Engram affiche la clé complète une seule fois, à la création, puis seulement son préfixe. Traite-la comme un mot de passe et garde-la en lieu sûr.

L’ajouter à ta configuration

Ajoute un bloc headers qui envoie la clé comme jeton Bearer. La clé englobante (mcpServers / servers / context_servers) dépend du client que tu configures ; utilise donc la même forme que celle de ton onglet ci-dessus. Pour les clients standard mcpServers :

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

Avec une clé d’API en place, aucun navigateur ne s’ouvre à la première connexion ; la clé authentifie immédiatement. Pour la renouveler, génère une nouvelle clé dans les paramètres et remplace la valeur dans ta configuration.

Attention

Traite la clé comme un mot de passe. Ne la valide pas dans le contrôle de version ; garde les clés d’API hors des fichiers mcp.json qui sont commités. Utilise la substitution de variables d’environnement là où ton client la prend en charge, ou place la configuration dans un fichier au niveau utilisateur (et non au niveau projet).

Dépannage

• Le client ne voit pas Engram après la modification. Redémarre complètement le client, pas seulement la fenêtre.
• Le navigateur ne s’ouvre jamais pour l’authentification. Vérifie qu’aucun bloqueur de fenêtres contextuelles n’interfère ; certains clients font passer la fenêtre OAuth par leur propre logique de navigateur, qui échoue silencieusement si elle est bloquée.
• Failed to connect. Vérifie que l’URL est joignable. Voir Dépannage pour les problèmes communs à tous les clients.

Pour les flux graphiques propres à chaque client, voir Intégrations IA.