Claude Desktop

L’interface Connectors de Claude Desktop est le chemin le plus simple pour connecter Engram. C’est un flux où tu colles l’URL et te connectes, sans fichier de configuration et sans clé d’API à copier. Pour comprendre ce qui se passe en coulisses, 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.

Configuration

1. Ouvre la page Add Engram connector. Elle lance la configuration de connecteur de Claude avec le nom et l’URL d’Engram déjà remplis. Ces paramètres s’appliquent à l’application de bureau comme à claude.ai.

   Tu préfères le faire à la main ? Va sur claude.ai/customize/connectors et appuie sur le bouton + pour ajouter un connecteur personnalisé.

2. Remplis les deux champs, puis clique sur Add. Les deux sont préremplis si tu as ouvert la fenêtre depuis le lien ci-dessus ; sinon, saisis-les toi-même.

   Name : ce que tu veux, par exemple :

   Engram

   Remote MCP server URL :

   https://mcp.engram.page

3. Une fenêtre d’autorisation s’ouvre dans le navigateur. Voir Première authentification pour ce à quoi t’attendre.

4. Examine les autorisations demandées sur l’écran des portées et approuve.

5. Dis à Claude comment l’utiliser pour qu’il pense à Engram automatiquement.

6. Essaie pour confirmer que le connecteur fonctionne.

Première authentification

La première fois que tu te connectes, Claude Desktop ouvre automatiquement 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 Claude Desktop. 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.

Dis à Claude comment l’utiliser

Ajouter le connecteur, c’est la moitié du travail. Claude ne pensera pas à Engram si tu ne le lui dis pas. Ajoute une courte instruction dans les préférences globales de Claude pour que chaque conversation sache utiliser Engram comme mémoire.

1. Ouvre claude.ai/settings/general.
2. Trouve le champ What personal preferences should Claude consider in responses? (la zone d’instructions globales).
3. Colle cet extrait. Garde-le sur sa propre ligne pour qu’il reste actif dans chaque conversation :

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.

Désormais, Claude pense automatiquement à Engram quand il doit chercher ou enregistrer quelque chose que tu as partagé.

Essaie

Une fois connecté et le prompt global en place, le connecteur apparaît dans ta barre latérale. Essaie de demander :

• 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.
• Lis ma note intitulée 'Q3 planning' et extrais les actions à mener.
• Montre-moi le frontmatter et les liens sortants de 'project-ideas.md'.
• Rédige une nouvelle note intitulée 'Sync with design, May 21' dans mon dossier 'Meeting notes' avec les points à retenir d'aujourd'hui.
• Ajoute une section 'Decisions' à 'roadmap.md' avec ces trois éléments.
• Liste les dossiers de premier niveau de mon coffre.
• Déplace tout ce qui mentionne 'Q4' dans 'inbox' vers 'Q4-planning'.

Claude appelle l’outil search d’Engram (ou get_note, write_note, etc.), ramène les résultats et répond en contexte.

Portées accordées

Claude Desktop demande la portée mcp sur l’écran d’approbation. C’est une autorisation unique qui couvre toute la surface d’outils MCP sur ton coffre. Des portées granulaires par action (lecture seule, sans suppression, etc.) figurent sur la feuille de route. Voir Portées pour les détails et le flux de révocation.

Dépannage (spécifique à Claude Desktop)

• La fenêtre d’autorisation ne s’ouvre jamais. Vérifie que Claude Desktop est à jour et qu’aucun bloqueur de fenêtres contextuelles n’est actif.
• « Connector failed to load. » Vérifie que l’URL MCP est joignable. Colle-la dans un onglet de navigateur. Si tu vois une page de réponse structurée plutôt qu’une erreur, la connexion est bonne et le problème vient de Claude Desktop. Redémarre-le et réessaie.

Pour les échecs communs à tous les clients (authentification refusée, erreurs de portée, écarts de synchronisation), voir Dépannage.

Révocation

La déconnexion prend effet des deux côtés. Choisis celui qui t’arrange :

Depuis l’application Claude : ouvre Settings → Connectors, trouve Engram et choisis Disconnect.

Depuis Claude sur le web : va sur claude.ai/customize/connectors, clique sur le connecteur Engram et choisis Disconnect.

Depuis Engram : va sur app.engram.page/settings/connections et déconnecte la session.

Dans tous les cas, le jeton OAuth est invalidé côté serveur, et Claude Desktop devra se réauthentifier pour se reconnecter.

Prochaines étapes

MCPVue d'ensemble du protocole.

PortéesChoisis le minimum d'autorisations.

Toutes les intégrationsChoisis un autre client.