Connecter Claude Code à une base de connaissances chiffrée 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 Code s’y connecte via MCP, au moyen d’un petit serveur qui tourne sur votre ordinateur et y déchiffre les notes. Une fois connecté, Claude Code peut :

• Chercher 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.
• Créer et modifier des notes. Chaque modification est enregistrée tout de suite, signée avec la propre clé de Claude Code 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 Code partout où il lit et écrit à cet endroit. Il peut seulement proposer 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 Code y attendent sous forme de diffs que vous les approuviez ou les refusiez. Les modifications de dossiers y sont alors refusées, et Claude Code 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.

Il vous faut Node.js 20 ou plus récent (22 ou 24 recommandé) et un compte Knowtarium gratuit. Ouvrez un terminal et lancez la commande depuis votre dossier personnel. npx fait confiance au dossier dans lequel il s’exécute : 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 Code
added to Claude Code (/Users/you/.claude.json)
  previous file saved as /Users/you/.claude.json.knowtarium-backup-<time>

1. Approuvez cet ordinateur. Votre navigateur ouvre Knowtarium. Nommez l’agent, choisissez ce à quoi il peut accéder (voir plus bas) et cliquez sur Allow, mais seulement si vous avez lancé la commande vous-même. En SSH, quand le navigateur ne peut pas joindre le terminal, vous confirmez plutôt un code identique aux deux endroits.
2. Choisissez les agents. La CLI liste les agents qu’elle trouve sur votre ordinateur, 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, a coche ou décoche tout, Échap n’en ajoute aucun).
3. Claude Code reçoit son entrée. La CLI ajoute Knowtarium aux réglages utilisateur de Claude Code dans ~/.claude.json (dans $CLAUDE_CONFIG_DIR si vous l’avez défini). Elle laisse vos autres serveurs et réglages tels quels et sauvegarde le fichier précédent à côté. L’entrée lance le serveur depuis votre dossier personnel, jamais depuis le projet ouvert dans Claude Code.
4. Redémarrez Claude Code. Il prend en compte les nouveaux serveurs au démarrage : quittez toute session déjà en cours et relancez-la.

Aucun mot de passe, jeton ou clé n’est placé dans les réglages de Claude Code. La connexion est stockée chiffrée, avec sa clé dans le trousseau de votre système (ou, à défaut, dans un fichier que vous seul pouvez lire). Pour voir ce que la CLI changerait avant qu’elle n’écrive quoi que ce soit, lancez npx knowtarium agents --dry-run. La CLI est open source : le code est sur GitHub.

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

Le plugin Knowtarium contient le même serveur MCP, épinglé sur une version testée de knowtarium, et un skill pour travailler dans un espace de travail Knowtarium (knowtarium-conventions). Il demande lui aussi Node.js 20 ou plus récent, et son lanceur démarre le serveur depuis votre dossier personnel. Dans Claude Code :

/plugin marketplace add Knowtarium/knowtarium-plugins/plugin install knowtarium@knowtarium

Avec Claude Code 2.1.275 ou plus récent, une seule ligne fait les deux :

/plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

Depuis un shell, avec Claude Code 2.1.292 ou plus récent :

$ claude plugin install knowtarium --marketplace Knowtarium/knowtarium-plugins

Connectez ensuite cet ordinateur une fois. Demandez à Claude de connecter Knowtarium, et votre navigateur s’ouvre pour que vous approuviez cet ordinateur. Ou lancez la commande avec --no-agents, depuis votre dossier personnel : le plugin fait déjà tourner le serveur, et sans l’option la commande en ajouterait un second.

$ cd ~$ npx knowtarium connect --no-agents

Le plugin ou la commande connect ?

Dans les deux cas, Claude Code reçoit les mêmes outils et les mêmes conventions qui vont avec. Choisissez l’un des deux : la commande laisse Claude Code décoché quand il a déjà le plugin, pour que le serveur ne tourne pas deux fois. Si vous avez d’abord lancé la commande puis installé le plugin, la CLI continue de mettre à jour sa propre entrée, qui fait tourner un second serveur. Pour ne garder que celui du plugin, lancez claude mcp remove --scope user knowtarium.

La page qu’ouvre la commande décide de ce que cette connexion peut faire. Tout est limité à ce seul agent, et le serveur l’impose :

• Un espace de travail. Chaque connexion en atteint exactement un. Pour en donner un autre à Claude Code, relancez npx knowtarium connect, choisissez l’autre espace de travail et redémarrez Claude Code. La première connexion reste en place.
• Certains dossiers, si vous le souhaitez. Ne cochez que les dossiers dont il a besoin. Il lit aussi les instructions des dossiers parents, mais ne peut pas proposer 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 Code à 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. Depuis le terminal, npx knowtarium disconnect révoque l’accès de cet ordinateur et supprime ses clés et son cache locaux.

Claude Code a déjà une mémoire : un CLAUDE.md que vous écrivez, chargé à chaque session, et une mémoire automatique qu’il écrit lui-même, qui reste sur une seule machine. Les deux conviennent bien pour dire comment travailler dans un projet. Aucune n’est 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 s’appuient plusieurs agents et plusieurs personnes.

C’est le rôle de la base de connaissances. Gardez les règles de votre projet dans CLAUDE.md, et laissez Claude Code chercher et consigner ce qu’il apprend dans Knowtarium, où tous les autres agents que vous connectez voient les mêmes notes. Notre guide du second cerveau avec Claude Code détaille CLAUDE.md et la mémoire automatique.

Pas besoin de commandes spéciales : demandez avec des mots simples et Claude Code choisit les outils. 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 la décision sur les tarifs et réponds
  avec des liens vers les notes que tu as utilisées.
 
> Lis le dossier meetings et rédige le résumé de la semaine
  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 Code nomme en général l’espace de travail et dit si ses modifications sont enregistrées tout de suite ou attendent votre approbation. Le dernier lit les clips que vous avez enregistrés avec le Web Clipper. Gardez les premières modifications limitées, et dites ce qui ne doit pas changer : il est plus facile de relire quatre notes modifiées que quarante.

Chaque modification de Claude Code 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 que Claude Code l’a modifiée, avec See changes pour le diff 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.

Claude Code ne voit pas Knowtarium

Redémarrez Claude Code après avoir ajouté Knowtarium : une session déjà en cours ne prend pas en compte les nouveaux serveurs. Si vous utilisez le plugin, vérifiez qu’il est installé et activé dans /plugin.

Vérifier la connexion

npx knowtarium status affiche les espaces de travail connectés, leurs accès et leurs modifications, le jeton et le cache local, et indique où les clés sont conservées.

knowtarium demande une mise à jour

Lancez npx knowtarium@latest agents depuis votre dossier personnel. La commande fait pointer vos agents vers la nouvelle version. Redémarrez ensuite Claude Code. Avec le plugin, mettez à jour la marketplace puis le plugin dans Claude Code (/plugin marketplace update knowtarium, puis /plugin et Update now), puis redémarrez.

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

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

Claude Code vous dit si chaque modification a été enregistrée ou proposée, et pourquoi : le dossier demande une relecture, les réglages de l’espace de travail n’ont pas pu être vérifiés, la limite quotidienne de modifications directes est atteinte, ou cette connexion ne peut que proposer. Dans ce dernier cas, relancez npx knowtarium connect depuis votre dossier personnel, puis redémarrez Claude Code.

Sous Windows

Utilisez npx knowtarium connect (ou npx knowtarium agents) depuis votre dossier personnel plutôt que le plugin, comme décrit plus haut.