Connecter Claude Desktop à vos notes via MCP

Knowtarium est une base de connaissances chiffrée de bout en bout dans laquelle travaillent des personnes et leurs propres agents IA. Claude Desktop, l’application Claude pour votre ordinateur, s’y connecte via MCP, au moyen d’un petit programme qui tourne sur votre ordinateur et y déverrouille vos notes. Une fois Claude connecté, vous pouvez lui demander, dans n’importe quelle conversation, de :

• Trouver et lire vos notes, suivre les liens entre elles et trouver les notes liées, dans l’espace de travail et les dossiers que vous lui avez donnés.
• Écrire et modifier des notes. Chaque modification est enregistrée tout de suite, signée au nom de Claude et conservée dans l’historique : vous voyez ce qu’il a fait et pouvez l’annuler en un clic.
• Suivre les instructions de vos dossiers. Ce que vous écrivez pour un espace de travail ou un dossier dans l’application (son AGENTS.md) parvient à Claude partout où il lit et écrit à cet endroit. Il peut seulement suggérer des modifications de ces instructions, jamais les faire.
• Vous attendre là où vous le voulez. Activez la relecture (« Ask me first ») pour un espace de travail ou un dossier, et les modifications de notes de Claude y attendent que vous les approuviez ou les refusiez. Les modifications de dossiers y sont alors refusées, et Claude vous dit ce qu’il changerait.
• Déplacer ou supprimer des notes et modifier des dossiers, seulement si vous lui avez donné ces autorisations, et il a pour consigne de ne le faire que si vous le lui demandez dans la conversation.

Il ne peut pas accéder à un espace de travail ou à un dossier que vous ne lui avez pas donné, signer en votre nom, marquer une note comme vérifiée par vous, ni contourner la relecture là où vous l’avez activée. La liste complète se trouve sur la page des agents.

C’est la méthode la plus simple, et celle que nous recommandons. Vous n’avez besoin ni d’un terminal ni de Node.js, seulement de Claude Desktop et d’un compte Knowtarium gratuit.

1. Téléchargez l’extension. Récupérez knowtarium.mcpb, la dernière version. Elle est construite à partir du code open source de Knowtarium sur GitHub, et chaque version publiée indique ses sommes de contrôle si vous voulez vérifier le fichier.
2. Ouvrez-la. Double-cliquez sur le fichier, et Claude Desktop propose d’installer l’extension. Il affiche le nom, l’icône, les outils et les liens d’assistance de l’extension avant que vous ne l’installiez. Si Claude Desktop n’ouvre pas le fichier, allez dans ses réglages, sous Extensions, et installez-la depuis cet endroit.
3. Demandez à Claude de connecter Knowtarium. Commencez une conversation et tapez quelque chose comme la ligne ci-dessous. Claude ouvre Knowtarium dans votre navigateur.
4. Approuvez cet ordinateur. Dans le navigateur, nommez l’agent, choisissez ce à quoi Claude peut accéder (voir plus bas) et cliquez sur Allow. Revenez ensuite à la conversation et dites à Claude que c’est fait : il vérifie que vous avez approuvé et liste votre espace de travail. À partir de là, chaque conversation peut utiliser vos notes.

> Connecte Knowtarium et liste mes espaces de travail

La page d’approbation est commune avec l’installation par le terminal : elle mentionne donc une commande et votre terminal. C’est Claude Desktop qui fait la demande : continuez si vous venez de demander à Claude de se connecter. Si votre navigateur demande si la page peut accéder aux appareils de votre réseau local, autorisez-le.

Aucun mot de passe, jeton ou clé n’est placé dans les réglages de Claude. La connexion est stockée chiffrée sur votre ordinateur, avec sa clé dans le trousseau de votre système, s’il en a un. Si cet ordinateur est déjà connecté (vous avez lancé npx knowtarium connect auparavant), l’extension utilise cette connexion et il n’y a rien à approuver. Si vous l’avez lancée avec Claude Desktop coché, Knowtarium est déjà dans Claude Desktop et vous n’avez pas besoin de l’extension.

(s’ouvre en grand dans un nouvel onglet) (s’ouvre en grand dans un nouvel onglet)

Si vous êtes à l’aise dans un terminal, une seule commande connecte cet ordinateur et ajoute Knowtarium à Claude Desktop et aux autres agents qu’elle trouve, comme Claude Code ou Cursor. Il vous faut Node.js 20 ou plus récent (22 ou 24 recommandé). Lancez-la depuis votre dossier personnel : npx fait confiance au dossier dans lequel il s’exécute, et le lancer dans un projet permettrait aux fichiers de ce projet de se faire passer pour ceux de Knowtarium.

$ cd ~                          # votre dossier personnel, pas un projet$ npx knowtarium connect
Opening the browser to connect this computer to Knowtarium.
Connected to workspace ws_8f2k (read and write).
Add Knowtarium to which agents? Claude Desktop
added to Claude Desktop (/Users/you/Library/Application Support/Claude/claude_desktop_config.json)

1. Approuvez cet ordinateur dans la page qui s’ouvre dans le navigateur, comme avec l’extension.
2. Choisissez les agents. La commande liste les agents qu’elle trouve, tous cochés. Appuyez sur Entrée pour ajouter Knowtarium à tous, ou décochez-en d’abord certains (les flèches déplacent, Espace coche ou décoche).
3. Claude Desktop reçoit son entrée. La commande ajoute Knowtarium au fichier de réglages de Claude Desktop, claude_desktop_config.json, et laisse vos autres réglages tels quels. Elle sauvegarde le fichier précédent à côté.
4. Quittez complètement Claude Desktop et rouvrez-le. Fermer la fenêtre ne suffit pas : sur un Mac, choisissez Claude, Quit Claude, ou appuyez sur Cmd+Q ; sous Windows, faites un clic droit sur l’icône de Claude dans la zone de notification (à côté de l’horloge) et choisissez Quit.

Le fichier de réglages qu’elle modifie se trouve dans le dossier propre à Claude Desktop :

Pour voir ce que la commande changerait avant qu’elle n’écrive quoi que ce soit, lancez npx knowtarium agents --dry-run. La commande est open source : le code est sur GitHub.

La page qui s’ouvre dans votre navigateur décide de ce que cette connexion peut faire. Tout est limité à ce seul agent, et notre serveur l’impose :

• Un espace de travail. Chaque connexion en atteint exactement un.
• Certains dossiers, si vous le souhaitez. Ne cochez que les dossiers dont Claude a besoin. Il lit aussi les instructions des dossiers parents, mais ne peut pas suggérer de les modifier.
• Lecture ou lecture-écriture. Commencez en lecture seule si vous voulez seulement des réponses tirées de vos notes.
• Au-delà de la modification, seulement si vous cochez la case. Déplacer des notes, supprimer des notes, et créer, renommer, déplacer ou supprimer des dossiers sont six autorisations distinctes, toutes désactivées par défaut.

Vous pouvez tout changer plus tard dans l’application, sous Settings, Agents, et vous signez le nouvel ensemble à chaque fois. Révoquez Claude à cet endroit et il est exclu sur-le-champ, et l’espace de travail reçoit une nouvelle clé : il ne peut rien lire de ce qui est écrit ensuite.

Pour donner à Claude un deuxième espace de travail, lancez npx knowtarium connect --no-agents depuis votre dossier personnel (cette commande demande Node.js), choisissez l’autre espace de travail, puis quittez et rouvrez Claude Desktop. La première connexion reste en place.

Claude peut déjà se souvenir d’éléments de vos conversations, et un projet dans Claude contient les fichiers que vous y ajoutez. Cette mémoire vit dans votre compte Claude, et seul Claude s’en sert. Elle convient bien pour votre façon de travailler avec Claude. Ce n’est pas le bon endroit pour le savoir lui-même : les décisions, les recherches, les comptes rendus de réunion et les faits sur lesquels vous, votre équipe et vos autres outils d’IA vous appuyez.

C’est le rôle de la base de connaissances. Vos notes restent les vôtres, en markdown simple que vous pouvez exporter, et tous les agents que vous connectez voient les mêmes notes. Claude y cherche des informations et consigne ce qu’il apprend, et vous pouvez voir et annuler chaque modification. Notre guide du second cerveau IA développe l’idée.

Pas besoin de commandes spéciales : demandez avec des mots simples et Claude choisit les bons outils. Dire « Knowtarium » ou « mes notes » aide Claude à savoir où chercher. Voici de bons premiers prompts, de la lecture seule à de petites modifications précises :

> Que peux-tu faire dans mon espace de travail Knowtarium ?
 
> Cherche dans mes notes Knowtarium notre processus d’intégration
  et réponds avec des liens vers les notes que tu as utilisées.
 
> Lis mes comptes rendus de réunion de cette semaine et rédige
  un court résumé dans une nouvelle note. Ne modifie pas les comptes rendus.
 
> Ajoute les notes de l’appel d’aujourd’hui à la note du projet Acme.
  N’y change rien d’autre.
 
> Qu’y a-t-il dans ma boîte de réception ? Propose une action pour chaque clip.

Le premier vérifie rapidement que la connexion fonctionne : Claude devrait nommer l’espace de travail et dire si ses modifications sont enregistrées tout de suite ou attendent votre approbation. Le dernier lit les pages que vous avez enregistrées avec le Web Clipper. Gardez les premières modifications petites, et dites ce qui ne doit pas changer : il est plus facile de vérifier quatre notes modifiées que quarante.

Chaque modification de Claude est signée avec sa propre clé : vous savez toujours quelles modifications sont les siennes.

• Un point dans la barre latérale signale chaque note qu’il a modifiée jusqu’à ce que vous l’ouvriez, et la page de l’espace de travail les liste sous Edited by agents.
• Sous le titre d’une note, une ligne indique quel agent l’a modifiée, avec See changes pour comparer et Undo pour revenir à la version précédente.
• Les suppressions, déplacements et modifications de dossiers sont listés sur la page de l’espace de travail pendant deux semaines, ou pendant votre durée d’historique si elle est plus courte, sous Deleted and reorganized by agents, avec Undo et Undo this agent's last 24 hours. Une note supprimée revient tant que votre durée d’historique la conserve.
• L’historique conserve chaque version aussi longtemps que vous le décidez, d’un jour à un an. Dans les dossiers où la relecture est activée, les modifications attendent plutôt dans la file de relecture.

(s’ouvre en grand dans un nouvel onglet) (s’ouvre en grand dans un nouvel onglet)

Notre guide pour relire les modifications des agents propose une routine pour vérifier ce qu’un agent a changé avant de vous y fier.

Knowtarium se connecte à Claude Desktop sur votre ordinateur, pas encore à claude.ai dans le navigateur ni à l’application Claude pour téléphone. Celles-ci ne tournent que dans le cloud : elles ont donc besoin d’un connecteur que nous hébergeons, et il arrivera plus tard.

La raison tient au chiffrement : aujourd’hui, vos notes ne sont déverrouillées que sur votre propre ordinateur, par l’extension ou la commande. Le connecteur hébergé est prévu pour ne les déverrouiller que sur un serveur verrouillé qui exécute du code que tout le monde peut vérifier. D’ici là, utilisez Claude Desktop, ou un autre agent sur votre ordinateur comme Claude Code.

Claude ne voit pas Knowtarium

Vérifiez que l’extension est installée et activée dans les réglages de Claude Desktop, sous Extensions. Si vous avez utilisé la commande, quittez complètement Claude Desktop et rouvrez-le : il ne prend en compte les nouveaux réglages qu’au démarrage.

Claude dit que Knowtarium n’est pas connecté

Demandez à Claude de connecter Knowtarium, et approuvez cet ordinateur dans la page qui s’ouvre dans le navigateur. Si vous avez fermé cette page, demandez à nouveau.

Vérifier la connexion

L’application liste chaque agent connecté sous Settings, Agents, avec ce à quoi chacun peut accéder. Dans un terminal, npx knowtarium status affiche les espaces de travail connectés, leurs accès et l’endroit où les clés sont conservées.

Knowtarium demande une mise à jour

Avec l’extension, téléchargez de nouveau knowtarium.mcpb (le lien donne toujours la dernière version) et ouvrez-le : Claude Desktop propose de mettre à jour l’extension installée. Avec la commande, lancez npx knowtarium@latest agents depuis votre dossier personnel. Dans les deux cas, quittez et rouvrez ensuite Claude Desktop.

$ cd ~$ npx knowtarium@latest agents$ npx knowtarium status

Les modifications attendent une approbation alors que vous les pensiez enregistrées

Claude vous dit si chaque modification a été enregistrée ou suggérée, et pourquoi. Peut-être que le dossier demande une relecture, que les réglages de l’espace de travail n’ont pas pu être vérifiés, ou que Claude a atteint la limite quotidienne de modifications directes. Ou bien cette connexion ne peut que suggérer des modifications : relancez npx knowtarium connect depuis votre dossier personnel (avec --no-agents si vous utilisez l’extension), puis quittez et rouvrez Claude Desktop.