Connecter Codex à 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. Codex, d’OpenAI, 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é, Codex 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 Codex 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 à Codex 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 Codex y attendent sous forme de diffs que vous les approuviez ou les refusiez. Les modifications de dossiers y sont alors refusées, et Codex 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? Codex
added to Codex (/Users/you/.codex/config.toml)
  previous file saved as /Users/you/.codex/config.toml.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). Elle trouve Codex grâce à son dossier ~/.codex.
3. Codex reçoit son entrée. La CLI ajoute Knowtarium à la configuration utilisateur de Codex, ~/.codex/config.toml (dans $CODEX_HOME si vous l’avez défini) : il est donc là dans chaque projet. Elle analyse d’abord le fichier et ne modifie que la table propre à Knowtarium, en laissant vos autres serveurs, réglages et commentaires 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 Codex.
4. Redémarrez Codex pour qu’il prenne en compte le nouveau serveur : quittez toute session déjà en cours et relancez Codex.

Aucun mot de passe, jeton ou clé n’est placé dans la configuration de Codex. 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 un terminal :

$ codex plugin marketplace add Knowtarium/knowtarium-plugins$ codex plugin add knowtarium@knowtarium

Ou, une fois la marketplace ajoutée, tapez /plugins dans Codex pour ouvrir le navigateur de plugins et installer Knowtarium depuis la marketplace knowtarium. Il ne figure pas dans l’annuaire public de plugins d’OpenAI : ajoutez donc d’abord la marketplace.

Connectez ensuite cet ordinateur une fois. Demandez à Codex 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 l’option laisse la configuration de Codex intacte.

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

Le plugin ou la commande connect ?

Dans les deux cas, Codex reçoit les mêmes outils et les mêmes conventions qui vont avec. Choisissez l’un des deux : la commande laisse Codex décoché quand il a déjà le plugin, pour que sa propre entrée ne remplace pas le serveur du plugin.

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 à Codex, relancez npx knowtarium connect, choisissez l’autre espace de travail et redémarrez Codex. 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 Codex à 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.

Codex tire ses instructions permanentes de fichiers AGENTS.md : un dans ~/.codex pour tous les projets, et ceux des dossiers situés entre la racine git et l’endroit où vous le lancez (documentation de Codex). Ils conviennent bien pour dire comment travailler dans un dépôt. Ils ne sont 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 s’appuient plusieurs agents et plusieurs personnes.

C’est le rôle de la base de connaissances. Gardez vos règles de code dans l’AGENTS.md de Codex, et laissez Codex chercher et consigner ce qu’il apprend dans Knowtarium, où tous les autres agents que vous connectez voient les mêmes notes, et où vous pouvez les lire et les modifier dans l’application. Notre guide du second cerveau avec Claude Code compare la façon dont Codex, Cursor et Claude Code lisent leurs fichiers d’instructions.

Pas besoin de commandes spéciales : demandez avec des mots simples et Codex 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 : Codex 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 Codex 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 Codex 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.

Codex ne voit pas Knowtarium

Redémarrez Codex 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 dans /plugins que Knowtarium est installé et n’est pas désactivé.

Codex n’est pas dans la liste des agents

La CLI trouve Codex grâce à son dossier ~/.codex (ou $CODEX_HOME). Si Codex garde sa configuration ailleurs, définissez CODEX_HOME dans ce terminal. Pour ajouter Knowtarium à Codex dans tous les cas, lancez npx knowtarium agents --agent codex depuis votre dossier personnel (sauf si vous utilisez le plugin).

Codex a été ignoré

La CLI n’écrit rien quand config.toml n’est pas du TOML valide, ou quand ses serveurs MCP sont écrits sous une forme qu’elle ne peut pas modifier sans risque, et elle dit lequel des deux. 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 mettez-le de côté), puis relancez npx knowtarium agents --agent codex.

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

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

Avec le plugin, mettez à niveau la marketplace (cela ne fait qu’actualiser la liste), puis ajoutez de nouveau le plugin, ce qui installe la nouvelle version, et redémarrez Codex :

$ codex plugin marketplace upgrade knowtarium$ codex plugin add knowtarium@knowtarium

Vous avez à la fois le plugin et l’entrée de la commande

Dans ce cas, l’entrée de config.toml tourne à la place du serveur du plugin. La CLI la tient à jour et vous le signale. Pour utiliser le serveur du plugin, supprimez la table [mcp_servers.knowtarium] de ~/.codex/config.toml (ou dans $CODEX_HOME) et redémarrez Codex.

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

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