Aller au contenu

Connecter Engram à ton IA

Engram est un serveur MCP distant. Chaque client ci-dessous se connecte à la même URL, te connecte via OAuth, puis lit et écrit les notes de ton coffre. Rien à installer, et Obsidian n’a pas besoin d’être ouvert.

https://mcp.engram.page

Le serveur parle Streamable HTTP et s’authentifie avec OAuth 2.1. Les clients s’enregistrent automatiquement, tu n’as donc jamais à copier d’identifiant ni de secret client.

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.
  1. Ouvre claude.ai/customize/connectors. Les paramètres définis ici s’appliquent à claude.ai et à l’application de bureau.
  2. Clique sur +, puis sur Add custom connector.
  3. Saisis Engram comme nom et https://mcp.engram.page comme URL du serveur MCP distant. Laisse Advanced settings vide.
  4. Clique sur Add, puis sur Connect, et approuve la fenêtre de connexion.

L’offre Free de Claude autorise un seul connecteur personnalisé. Pas-à-pas complet : Claude Desktop.

Les connecteurs personnalisés se trouvent derrière le Developer mode de ChatGPT, dans l’application web, sur les offres payantes éligibles. Sur un espace de travail Business ou Enterprise, un administrateur doit d’abord l’autoriser.

  1. Va dans Settings → Apps → Advanced settings et active Developer mode.
  2. Retour dans Settings → Apps, clique sur Create app.
  3. Nomme-la Engram, définis l’URL du serveur MCP sur https://mcp.engram.page et choisis OAuth comme authentification.
  4. Clique sur Scan Tools et attends la fin.
  5. Clique sur Create et approuve la fenêtre de connexion.
  6. Dans une conversation, choisis Engram dans le menu des outils du champ de saisie.

Sur un espace de travail Business, l’application arrive dans Workspace settings → Apps → Drafts jusqu’à ce qu’un administrateur la publie.

Pas-à-pas complet : ChatGPT.

Grok n’a pas de fiche Engram dans son annuaire de connecteurs. Tu l’ajoutes comme connecteur personnalisé via son URL.

  1. Ouvre grok.com/connectors.
  2. Clique sur New Connector, puis sur Custom.
  3. Colle https://mcp.engram.page et termine la connexion.

Tu développes sur l’API xAI plutôt que dans l’application Grok ? Voir Grok (xAI API).

Ajoute Engram à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json (un seul projet) :

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

Quitte complètement Cursor et rouvre-le. La fenêtre de connexion s’ouvre la première fois que l’agent appelle un outil Engram. Pas-à-pas complet : Cursor.

VS Code lit les serveurs MCP dans le mode Agent de Copilot Chat. Lance MCP: Add Server depuis la palette de commandes, ou ajoute ceci à .vscode/mcp.json :

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

Clique sur le code-lens Auth au-dessus de l’entrée engram pour te connecter. Pas-à-pas complet : GitHub Copilot.

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

Redémarre claude, lance /mcp, choisis engram, puis Authenticate. Ajoute --scope user pour rendre Engram disponible dans tous les projets. Pas-à-pas complet : Claude Code.

Si ton client prend en charge les serveurs MCP distants, donne-lui :

  • URL : https://mcp.engram.page
  • Transport : Streamable HTTP
  • Auth : OAuth. Engram publie les métadonnées de son serveur d’autorisation et accepte le Dynamic Client Registration, donc un client conforme n’a besoin de rien d’autre.

Un client qui ne peut pas faire de connexion via navigateur peut envoyer une clé d’API Engram dans un en-tête Bearer. Les clés d’API demandent l’offre Pro. Les formes de configuration pour les deux sont dans Configuration MCP.

La première fois que tu te connectes, le client ouvre une fenêtre de navigateur te demandant de te connecter à Engram. Connecte-toi, coche les autorisations que tu souhaites accorder, puis clique sur Approve. Le navigateur te ramène automatiquement vers le client. Pas de jetons à copier-coller, pas de variables d’environnement. C’est le même type de connexion que celui utilisé pour relier n’importe quelle application à Google, Dropbox ou GitHub.

Si tu préfères éviter le flux navigateur (installations sans interface, scriptées ou à coffre partagé), tu peux t’authentifier avec une clé d’API à la place. Voir Configuration MCP → Authentification par clé d’API.

Pose à ton IA une question à laquelle seules tes notes peuvent répondre, par exemple :

Quelle valeur ai-je définie pour POOL_SIZE dans mes notes de déploiement ?

Si elle répond à partir de ton coffre, tu es connecté. Sinon, voir Dépannage.

Supprime le connecteur dans ton client IA, puis révoque sa session dans app.engram.page/settings/connections.