Codex über MCP mit einer verschlüsselten Wissensdatenbank verbinden

Knowtarium ist eine Ende-zu-Ende-verschlüsselte Wissensdatenbank, in der Menschen und ihre eigenen KI-Agenten arbeiten. Codex von OpenAI verbindet sich per MCP damit, über einen kleinen Server, der auf deinem Computer läuft und die Notizen dort entschlüsselt. Sobald es verbunden ist, kann Codex:

• Deine Notizen durchsuchen und lesen, den Links zwischen ihnen folgen und verwandte Notizen finden, in dem Workspace und den Ordnern, die du ihm freigegeben hast.
• Notizen erstellen und bearbeiten. Jede Änderung wird sofort gespeichert, mit dem eigenen Schlüssel von Codex signiert und im Verlauf aufbewahrt. So siehst du, was es getan hat, und kannst es mit einem Klick rückgängig machen.
• Deinen Ordneranweisungen folgen. Was du in der App für einen Workspace oder Ordner schreibst (seine AGENTS.md), erreicht Codex überall, wo es dort liest und schreibt. Änderungen an diesen Anweisungen kann es nur vorschlagen, nie selbst vornehmen.
• Auf dich warten, wo du es willst. Schalte für einen Workspace oder Ordner Review ein („Ask me first“), und die Änderungen von Codex an Notizen dort warten als Diffs, bis du sie annimmst oder ablehnst. Änderungen an Ordnern werden dort stattdessen abgelehnt, und Codex sagt dir, was es ändern würde.
• Notizen verschieben oder löschen und Ordner ändern, nur wenn du ihm diese Berechtigungen gegeben hast, und es ist angewiesen, das nur zu tun, wenn du im Gespräch darum bittest.

Es kann keinen Workspace und keinen Ordner erreichen, den du ihm nicht freigegeben hast, nicht in deinem Namen signieren, keine Notiz als von dir geprüft markieren und Review nicht umgehen, wo du es eingeschaltet hast. Die vollständige Liste steht auf der Seite zu Agenten.

Du brauchst Node.js 20 oder neuer (22 oder 24 empfohlen) und ein kostenloses Knowtarium-Konto. Öffne ein Terminal und führe den Befehl in deinem Home-Ordner aus. npx vertraut dem Ordner, in dem es läuft. In einem Projekt ausgeführt, könnten die Dateien dieses Projekts sich also als die von Knowtarium ausgeben.

$ cd ~                          # dein Home-Ordner, kein Projekt$ 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. Bestätige diesen Computer. Dein Browser öffnet Knowtarium. Gib dem Agenten einen Namen, wähl aus, was er erreichen darf (siehe unten), und klick auf Allow, aber nur, wenn du den Befehl selbst ausgeführt hast. Über SSH, wo der Browser das Terminal nicht erreicht, bestätigst du stattdessen an beiden Stellen einen übereinstimmenden Code.
2. Wähl die Agenten. Die CLI listet die Agenten auf, die sie auf deinem Computer findet, alle angehakt. Drück Enter, um Knowtarium zu allen hinzuzufügen, oder nimm vorher bei einigen den Haken raus (Pfeiltasten bewegen, Leertaste schaltet um, a schaltet alle um, Esc fügt keinen hinzu). Sie erkennt Codex an seinem Ordner ~/.codex.
3. Codex bekommt seinen Eintrag. Die CLI fügt Knowtarium zur Benutzerkonfiguration von Codex hinzu, ~/.codex/config.toml (in $CODEX_HOME, wenn du das gesetzt hast), damit es in jedem Projekt da ist. Sie liest die Datei zuerst ein und ändert nur die eigene Tabelle von Knowtarium. Deine anderen Server, Einstellungen und Kommentare lässt sie, wie sie sind, und sichert die bisherige Datei daneben. Der Eintrag startet den Server aus deinem Home-Ordner, nie aus dem Projekt, das Codex gerade offen hat.
4. Starte Codex neu, damit es den neuen Server übernimmt: Beende jede Sitzung, die schon lief, und starte Codex neu.

Kein Passwort, kein Token und kein Schlüssel landet in der Konfiguration von Codex. Die Verbindung wird verschlüsselt gespeichert, mit ihrem Schlüssel im Schlüsselbund deines Systems (oder, wo es keinen gibt, in einer Datei, die nur du lesen kannst). Um zu sehen, was die CLI ändern würde, bevor sie etwas schreibt, führ npx knowtarium agents --dry-run aus. Die CLI ist Open Source: Der Code liegt auf GitHub.

(öffnet in voller Größe in einem neuen Tab) (öffnet in voller Größe in einem neuen Tab)

Das Knowtarium-Plugin enthält denselben MCP-Server, festgelegt auf eine getestete knowtarium-Version, und einen Skill für die Arbeit in einem Knowtarium-Workspace (knowtarium-conventions). Es braucht ebenfalls Node.js 20 oder neuer, und sein Startskript startet den Server aus deinem Home-Ordner. In einem Terminal:

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

Oder, sobald der Marketplace hinzugefügt ist, tipp in Codex /plugins, um den Plugin-Browser zu öffnen, und installier Knowtarium aus dem Marketplace knowtarium. Es ist nicht im öffentlichen Plugin-Verzeichnis von OpenAI, füg also zuerst den Marketplace hinzu.

Dann verbindest du diesen Computer einmal. Bitte Codex, Knowtarium zu verbinden, und dein Browser öffnet sich, damit du diesen Computer bestätigen kannst. Oder führ den Befehl mit --no-agents in deinem Home-Ordner aus: Das Plugin startet den Server schon, und mit der Option lässt der Befehl die Konfiguration von Codex in Ruhe.

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

Plugin oder Verbindungsbefehl?

So oder so bekommt Codex dieselben Tools und dieselben Konventionen dazu. Entscheide dich für eins: Der Befehl lässt Codex abgewählt, wenn es schon das Plugin hat, damit sein eigener Eintrag den Server des Plugins nicht ersetzt.

Die Seite, die der Befehl öffnet, bestimmt, was diese Verbindung darf. Alles gilt nur für diesen einen Agenten, und der Server setzt es durch:

• Ein Workspace. Jede Verbindung erreicht genau einen. Um Codex einen weiteren zu geben, führ npx knowtarium connect noch einmal aus, wähl den anderen Workspace und starte Codex neu. Die erste Verbindung bleibt bestehen.
• Einzelne Ordner, wenn du willst. Hak nur die Ordner an, die es braucht. Es liest auch die Anweisungen der Ordner darüber, kann zu ihnen aber keine Änderungen vorschlagen.
• Lesen oder Lesen und Schreiben. Fang mit Nur-Lesen an, wenn du nur Antworten aus deinen Notizen willst.
• Mehr als Bearbeiten, nur wenn du es anhakst. Notizen verschieben, Notizen löschen und Ordner erstellen, umbenennen, verschieben oder löschen sind sechs separate Berechtigungen, jede standardmäßig aus.

Du kannst all das später in der App unter Settings, Agents ändern, und jedes Mal signierst du die neue Auswahl. Widerrufst du dort den Zugriff von Codex, ist es sofort ausgesperrt, und der Workspace bekommt einen neuen Schlüssel, sodass es nichts lesen kann, was danach geschrieben wird. Im Terminal widerruft npx knowtarium disconnect den Zugriff dieses Computers und löscht seine lokalen Schlüssel und seinen Cache.

Codex bezieht seine festen Anweisungen aus AGENTS.md-Dateien: einer in ~/.codex für jedes Projekt und denen in den Ordnern zwischen dem Git-Root und dem Ort, an dem du es startest (Codex-Dokumentation). Sie eignen sich gut dafür, wie in einem Repository gearbeitet wird. Für das Wissen selbst sind sie kein guter Ort: Entscheidungen, Recherchen, Meeting-Notizen und die Fakten, auf die sich mehrere Agenten und Menschen verlassen.

Dafür ist die Wissensdatenbank da. Behalte deine Coding-Regeln in der AGENTS.md von Codex, und lass Codex das, was es lernt, in Knowtarium nachschlagen und festhalten. Dort sieht jeder andere Agent, den du verbindest, dieselben Notizen, und du kannst sie in der App lesen und bearbeiten. Unsere Anleitung zum Second Brain mit Claude Code vergleicht, wie Codex, Cursor und Claude Code ihre Anweisungsdateien lesen.

Du brauchst keine besonderen Befehle: Frag in normalen Worten, und Codex wählt die Tools. Das hier sind gute erste Prompts, von Nur-Lesen bis zu kleinen, gezielten Änderungen:

> Was kannst du in meinem Knowtarium-Workspace tun?
 
> Such in meinen Notizen nach der Preisentscheidung und antworte
  mit Links zu den Notizen, die du verwendet hast.
 
> Lies den Ordner meetings und schreib die Zusammenfassung dieser
  Woche als neue Notiz. Ändere die Meeting-Notizen nicht.
 
> Füge die Notizen vom heutigen Anruf zur Projektnotiz Acme hinzu.
  Ändere sonst nichts daran.
 
> Was ist in meiner Inbox? Schlag zu jedem Clip eine Aktion vor.

Der erste prüft schnell, ob die Verbindung funktioniert: Codex sollte den Workspace nennen und sagen, ob seine Änderungen sofort gespeichert werden oder auf deine Freigabe warten. Der letzte liest die Clips, die du mit dem Web Clipper gespeichert hast. Halte die ersten Änderungen klein und sag, was sich nicht ändern darf: Vier geänderte Notizen sind leichter zu prüfen als vierzig.

Jede Änderung von Codex ist mit seinem eigenen Schlüssel signiert, du weißt also immer, welche Änderungen von ihm stammen:

• Ein Punkt in der Seitenleiste markiert jede Notiz, die es bearbeitet hat, bis du sie öffnest, und die Seite des Workspace listet sie unter Edited by agents auf.
• Unter dem Titel einer Notiz steht, dass Codex sie bearbeitet hat, mit See changes für den Diff und Undo, um die vorherige Version zurückzuholen.
• Löschungen, Verschiebungen und Änderungen an Ordnern stehen zwei Wochen lang auf der Seite des Workspace, oder so lange, wie dein Verlauf aufbewahrt wird, falls das kürzer ist, unter Deleted and reorganized by agents, mit Undo und Undo this agent's last 24 hours. Eine gelöschte Notiz kommt zurück, solange dein Verlauf sie aufbewahrt.
• Der Verlauf bewahrt jede Version so lange auf, wie du festlegst, von einem Tag bis zu einem Jahr. In Ordnern mit Review warten Änderungen stattdessen in der Review-Warteschlange.

(öffnet in voller Größe in einem neuen Tab) (öffnet in voller Größe in einem neuen Tab)

Unsere Anleitung zum Prüfen von Agenten-Änderungen hat eine Routine, mit der du prüfst, was ein Agent geändert hat, bevor du dich darauf verlässt.

Codex sieht Knowtarium nicht

Starte Codex neu, nachdem du Knowtarium hinzugefügt hast: Eine Sitzung, die schon lief, übernimmt keine neuen Server. Wenn du das Plugin nutzt, prüf in /plugins, ob Knowtarium installiert und nicht ausgeschaltet ist.

Codex fehlt in der Liste der Agenten

Die CLI erkennt Codex an seinem Ordner ~/.codex (oder $CODEX_HOME). Liegt die Konfiguration von Codex woanders, setz in diesem Terminal CODEX_HOME. Um Knowtarium in jedem Fall zu Codex hinzuzufügen, führ npx knowtarium agents --agent codex in deinem Home-Ordner aus (nicht, wenn du das Plugin nutzt).

Codex wurde übersprungen

Die CLI schreibt nichts, wenn config.toml kein gültiges TOML ist oder seine MCP-Server in einer Form stehen, die sie nicht sicher bearbeiten kann, und sie sagt, was davon zutrifft. Sie gibt außerdem eine Zeile „add it by hand“ mit einem Server-Eintrag aus: Ignorier sie, denn ein Eintrag, den du selbst schreibst, führt npx im Projektordner aus. Korrigier die Datei (oder leg sie beiseite) und führ dann npx knowtarium agents --agent codex noch einmal aus.

Die Verbindung prüfen

npx knowtarium status zeigt die verbundenen Workspaces, ihren Zugriff und ihre Änderungen, das Token und den lokalen Cache und sagt, wo die Schlüssel liegen.

knowtarium fordert ein Update

Führ npx knowtarium@latest agents in deinem Home-Ordner aus. Das stellt deine Agenten auf die neue Version um. Starte danach Codex neu.

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

Mit dem Plugin aktualisierst du den Marketplace (das frischt nur die Liste auf), fügst dann das Plugin erneut hinzu, was die neue Version installiert, und startest Codex neu:

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

Du hast das Plugin und den Eintrag des Befehls

Dann läuft der Eintrag in config.toml statt des Servers aus dem Plugin. Die CLI hält ihn aktuell und sagt dir das. Um den Server des Plugins zu nutzen, entferne die Tabelle [mcp_servers.knowtarium] aus ~/.codex/config.toml (oder in $CODEX_HOME) und starte Codex neu.

Änderungen warten auf Freigabe, obwohl du erwartet hast, dass sie gespeichert werden

Codex sagt dir bei jeder Änderung, ob sie gespeichert oder vorgeschlagen wurde, und warum: Der Ordner verlangt Review, die Einstellungen des Workspace ließen sich nicht überprüfen, das Tageslimit für direkte Änderungen ist erreicht, oder diese Verbindung kann nur vorschlagen. Im letzten Fall führ npx knowtarium connect noch einmal in deinem Home-Ordner aus und starte Codex dann neu.