Connecter Cursor à 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. Cursor 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é, l’agent de Cursor 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. Les décisions, les spécifications et les comptes rendus de réunion sont là pendant qu’il travaille sur votre code.
• Créer et modifier des notes. Chaque modification est enregistrée tout de suite, signée avec la propre clé de Cursor 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 à Cursor 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 Cursor y attendent sous forme de diffs que vous les approuviez ou les refusiez. Les modifications de dossiers y sont alors refusées, et Cursor 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? Cursor
added to Cursor (/Users/you/.cursor/mcp.json)
  previous file saved as /Users/you/.cursor/mcp.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. Cursor reçoit son entrée. La CLI ajoute Knowtarium aux réglages utilisateur de Cursor dans ~/.cursor/mcp.json : il est donc là dans chaque projet. 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 Cursor.
4. Redémarrez Cursor. Quittez-le et rouvrez-le, pour qu’il prenne en compte le nouveau serveur.

Aucun mot de passe, jeton ou clé n’est placé dans les réglages de Cursor. 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)

Si vous êtes déjà connecté à Knowtarium, l’application peut ajouter le serveur à Cursor pour vous. Il faut toujours Node.js 20 ou plus récent, car Cursor démarre le même serveur depuis npm.

1. Ouvrez Connect an agent. Dans l’application web, allez dans Settings, Agents, Connect an agent (app.knowtarium.com/settings/agents/new), sur l’ordinateur où tourne Cursor.
2. Cliquez sur Add to Cursor. Cursor s’ouvre et propose d’installer le serveur knowtarium. Confirmez.
3. Connectez cet ordinateur, si ce n’est pas encore fait. Demandez à l’agent de Cursor de connecter Knowtarium, ou lancez une fois la commande depuis votre dossier personnel avec --no-agents, qui laisse les réglages de Cursor intacts. Dans les deux cas, votre navigateur s’ouvre pour que vous approuviez cet ordinateur et choisissiez ce à quoi Cursor accède.

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

Le serveur du lien se place d’abord dans votre dossier personnel, puis lance npx, parce que Cursor démarre un serveur dans le dossier du projet ouvert, et qu’un projet pourrait sinon y substituer son propre code à celui de Knowtarium.

Le lien ou la commande connect ?

Dans les deux cas, Cursor reçoit le même serveur, les mêmes outils et les mêmes conventions qui vont avec. Utilisez une seule méthode, le lien ou la commande, pour rester simple.

La page qui s’ouvre dans votre navigateur 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 à Cursor, relancez npx knowtarium connect, choisissez l’autre espace de travail et redémarrez Cursor. La première connexion reste en place.
• Certains dossiers, si vous le souhaitez. Ne cochez que les dossiers dont il a besoin, comme vos notes d’ingénierie et vos décisions. 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 que Cursor consulte des informations pendant qu’il code.
• 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 Cursor à 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.

Cursor lit déjà les règles que vous écrivez : les règles de projet dans .cursor/rules, un AGENTS.md dans le dépôt, et les règles utilisateur que vous définissez dans Cursor. Elles conviennent bien pour dire comment travailler dans une base de code. Elles ne sont pas le bon endroit pour le savoir qui l’entoure : pourquoi une décision a été prise, les recherches, les comptes rendus de réunion et les faits sur lesquels s’appuient plusieurs agents et plusieurs personnes, dans tous les projets que vous ouvrez.

C’est le rôle de la base de connaissances. Gardez les règles de code dans le dépôt, et laissez Cursor chercher et consigner ce qu’il apprend dans Knowtarium, où Claude Code, Codex et tous les autres agents que vous connectez voient les mêmes notes.

Pas besoin de commandes spéciales : demandez à l’agent de Cursor avec des mots simples et il choisit les outils. Voici de bons premiers prompts, de la lecture seule à une petite modification précise :

> Que peux-tu faire dans mon espace de travail Knowtarium ?
 
> Cherche dans mes notes comment nous avons choisi le flux d’authentification
  et réponds avec des liens vers les notes que tu as utilisées.
 
> Lis le dossier decisions, puis relis ce fichier
  au regard de ce que nous avons décidé. Ne modifie aucune note.
 
> Décris ce que nous venons de changer dans le service de facturation
  dans une nouvelle note du dossier engineering.
 
> 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 : Cursor 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 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 Cursor 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 Cursor 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.

Cursor ne voit pas Knowtarium

Redémarrez Cursor après avoir ajouté Knowtarium. Vérifiez ensuite que knowtarium figure dans la liste et est activé là où Cursor liste ses serveurs MCP (Customize, dans les versions récentes). Si npx knowtarium connect n’a pas listé Cursor, ajoutez-le par son nom : npx knowtarium agents --agent cursor, depuis votre dossier personnel.

La CLI a ignoré les réglages de Cursor

Elle n’écrase jamais un fichier qu’elle ne peut pas modifier sans risque. Si ~/.cursor/mcp.json n’est pas du JSON valide ou contient des commentaires, la CLI le signale et n’y touche pas. Elle affiche aussi une ligne « add it by hand » avec une entrée de serveur : ignorez-la, car une entrée que vous écrivez vous-même lance npx dans le dossier du projet. Corrigez le fichier (ou retirez les commentaires, ou mettez-le de côté), puis relancez npx knowtarium agents.

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

Si vous avez utilisé la commande, lancez npx knowtarium@latest agents depuis votre dossier personnel. Elle met à jour l’entrée knowtarium de ~/.cursor/mcp.json (et celles de vos autres agents) vers la nouvelle version. Si vous avez utilisé le lien, cliquez de nouveau sur Add to Cursor dans l’application. Redémarrez ensuite Cursor.

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

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

Cursor 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 Cursor.