Einrichtung
Claude Code über MCP mit einer verschlüsselten Wissensdatenbank verbinden
Führ in deinem Home-Ordner aus, bestätige diesen Computer im Browser und starte Claude Code neu: Dann kann es die Notizen, die du ausgewählt hast, per MCP durchsuchen, lesen und schreiben. Jede Änderung trägt die Signatur von Claude Code und lässt sich mit einem Klick rückgängig machen, und deine Notizen bleiben Ende-zu-Ende-verschlüsselt.
Von Fadel Kaadan · Aktualisiert am
Was Claude Code kann, sobald es verbunden ist
Knowtarium ist eine Ende-zu-Ende-verschlüsselte Wissensdatenbank, in der Menschen und ihre eigenen KI-Agenten arbeiten. Claude Code 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 Claude Code:
- 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 Claude Code 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 Claude Code ü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 Claude Code an Notizen dort warten als Diffs, bis du sie annimmst oder ablehnst. Änderungen an Ordnern werden dort stattdessen abgelehnt, und Claude Code 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.
Was Anthropic sieht
Unsere Server haben deine Notizen immer nur als Chiffretext. Die knowtarium-CLI entschlüsselt sie auf deinem Computer und gibt Claude Code nur das, was seine Tools zurückliefern. Was Claude Code liest, geht an Anthropic, wie alles andere, was du ihm gibst. Verbinde es also nur mit den Notizen, die du mit ihm teilen würdest. Wie die Verschlüsselung funktioniert, steht auf der Seite zur Sicherheit.
Einrichten mit npx knowtarium connect
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.
Opening the browser to connect this computer to Knowtarium.Connected to workspace ws_8f2k (read and write).Add Knowtarium to which agents? Claude Codeadded to Claude Code (/Users/you/.claude.json)previous file saved as /Users/you/.claude.json.knowtarium-backup-<time>
- 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.
- 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,
aschaltet alle um, Esc fügt keinen hinzu). - Claude Code bekommt seinen Eintrag. Die CLI fügt Knowtarium zu den Benutzereinstellungen von Claude Code in
~/.claude.jsonhinzu (in$CLAUDE_CONFIG_DIR, wenn du das gesetzt hast). Deine anderen Server und Einstellungen 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 Claude Code gerade offen hat. - Starte Claude Code neu. Es übernimmt neue Server beim Start. Beende also jede Sitzung, die schon lief, und starte sie neu.
Kein Passwort, kein Token und kein Schlüssel landet in den Einstellungen von Claude Code. 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 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)Oder installier das Plugin für Claude Code
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 Claude Code:
Ab Claude Code 2.1.275 erledigt eine Zeile beides:
Aus einer Shell, ab Claude Code 2.1.292:
Dann verbindest du diesen Computer einmal. Bitte Claude, 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 ohne die Option würde der Befehl einen zweiten hinzufügen.
Unter Windows
Unter Windows sucht Claude Code das node des Plugins zuerst im Projektordner. Eine node.exe in einem Projekt, das du öffnest, würde also statt Node.js starten. Für die gehärtete Einrichtung lässt du das Plugin weg und nutzt in deinem Home-Ordner (oder , wenn dieser Computer schon verbunden ist). Der Eintrag, den es schreibt, nennt cmd.exe mit seinem vollständigen Pfad. Hast du das Plugin schon installiert, entferne es vorher oder schalte es in /plugin aus: Sonst hakt der Befehl Claude Code nicht an, und das Plugin läuft weiter.
Plugin oder Verbindungsbefehl?
| npx knowtarium connect | Plugin | |
|---|---|---|
| Was es hinzufügt | Den Server, zu Claude Code und den anderen Agenten, die es findet | Den Server und den Skill knowtarium-conventions, zu Claude Code |
| Diesen Computer verbinden | Teil des Befehls | Claude bitten, oder |
| Aktualisieren | Das Plugin in Claude Code aktualisieren | |
| Windows | Die gehärtete Einrichtung | Stattdessen den Befehl nutzen |
So oder so bekommt Claude Code dieselben Tools und dieselben Konventionen dazu. Entscheide dich für eins: Der Befehl lässt Claude Code abgewählt, wenn es schon das Plugin hat, damit der Server nicht doppelt läuft. Hast du zuerst den Befehl ausgeführt und später das Plugin installiert, aktualisiert die CLI weiter ihren eigenen Eintrag, der einen zweiten Server startet. Um nur den des Plugins zu behalten, führ aus.
Leg fest, was Claude Code erreichen darf
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 Claude Code einen weiteren zu geben, führ noch einmal aus, wähl den anderen Workspace und starte Claude Code 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 Claude Code, ist es sofort ausgesperrt, und der Workspace bekommt einen neuen Schlüssel, sodass es nichts lesen kann, was danach geschrieben wird. Im Terminal widerruft den Zugriff dieses Computers und löscht seine lokalen Schlüssel und seinen Cache.
Das Gedächtnis von Claude Code und deine Wissensdatenbank
Claude Code hat schon ein Gedächtnis: eine CLAUDE.md, die du schreibst und die in jeder Sitzung geladen wird, und das automatische Gedächtnis, das es selbst schreibt und das auf einem Rechner bleibt. Beide eignen sich gut dafür, wie in einem Projekt gearbeitet wird. Keins von beiden ist ein guter Ort für das Wissen selbst: Entscheidungen, Recherchen, Meeting-Notizen und die Fakten, auf die sich mehrere Agenten und Menschen verlassen.
Dafür ist die Wissensdatenbank da. Behalte deine Projektregeln in CLAUDE.md, und lass Claude Code das, was es lernt, in Knowtarium nachschlagen und festhalten, wo jeder andere Agent, den du verbindest, dieselben Notizen sieht. Unsere Anleitung zum Second Brain mit Claude Code behandelt CLAUDE.md und das automatische Gedächtnis im Detail.
In Knowtarium
Regeln für die Notizen selbst gehören in die eigenen Anweisungen des Workspace, eine AGENTS.md, die du in der App schreibst und der Claude Code und jeder andere verbundene Agent folgen. Unsere Anleitung zu AGENTS.md für Wissensdatenbanken hat eine Vorlage für den Anfang.
Prompts für den Anfang
Du brauchst keine besonderen Befehle: Frag in normalen Worten, und Claude Code 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 antwortemit Links zu den Notizen, die du verwendet hast.> Lies den Ordner meetings und schreib die Zusammenfassung dieserWoche 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: Claude Code nennt meist den Workspace und sagt, 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.
Prüfen und rückgängig machen, was Claude Code geändert hat
Jede Änderung von Claude Code 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 Claude Code 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.
Fehlerbehebung
Claude Code sieht Knowtarium nicht
Starte Claude Code neu, nachdem du Knowtarium hinzugefügt hast: Eine Sitzung, die schon lief, übernimmt keine neuen Server. Wenn du das Plugin nutzt, prüf in /plugin, ob es installiert und aktiviert ist.
Die Verbindung prüfen
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 in deinem Home-Ordner aus. Das stellt deine Agenten auf die neue Version um. Starte danach Claude Code neu. Mit dem Plugin aktualisierst du in Claude Code erst den Marketplace und dann das Plugin (, dann und Update now) und startest neu.
Änderungen warten auf Freigabe, obwohl du erwartet hast, dass sie gespeichert werden
Claude Code 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 noch einmal in deinem Home-Ordner aus und starte Claude Code dann neu.
Unter Windows
Nutze statt des Plugins (oder ) in deinem Home-Ordner, wie oben beschrieben.
Nicht von Hand hinzufügen
Nutze den Verbindungsbefehl oder das Plugin, keinen Server-Eintrag, den du selbst schreibst oder den eine MCP-Registry installiert (Knowtarium ist noch nicht in der MCP Registry). Die führen npx in dem Projekt aus, das Claude Code gerade offen hat, wo sich die Dateien des Projekts als die von Knowtarium ausgeben könnten.
Fragen
Sieht Anthropic meine Notizen?
Anthropic sieht, was Claude Code liest, wie alles andere, was du ihm gibst. Notizen werden nur auf deinem Computer entschlüsselt, und die Server von Knowtarium haben sie nur als Chiffretext. Verbinde Claude Code nur mit den Ordnern, die es braucht, oder nur lesend, um einzuschränken, was es lesen kann.
Kann Claude Code meine Notizen löschen?
Nur, wenn du ihm die Berechtigung zum Löschen von Notizen gegeben hast, die standardmäßig aus ist, und es ist angewiesen, nur zu löschen, wenn du im Gespräch darum gebeten hast. In Ordnern mit Ask me first wartet eine Löschung auf deine Freigabe. Jede Löschung steht mit Undo auf der Seite des Workspace, und die Notiz kommt zurück, solange dein Verlauf sie aufbewahrt.
Funktioniert Knowtarium in jedem Claude-Code-Projekt?
Ja. npx knowtarium connect fügt Knowtarium zu den Benutzereinstellungen von Claude Code in ~/.claude.json hinzu, nicht zu einem einzelnen Projekt. Es ist also da, egal in welchem Ordner du Claude Code startest. Der Server läuft immer aus deinem Home-Ordner, nie aus dem Projekt, das du offen hast.
Soll ich das Plugin oder npx knowtarium connect nutzen?
Beides funktioniert und startet denselben Server. Das Plugin bringt den Skill knowtarium-conventions mit und aktualisiert sich über Claude Code. Der Befehl richtet zusätzlich alle anderen Agenten ein, die er findet, etwa Codex oder Cursor. Unter Windows nutzt du den Befehl, nicht das Plugin.
Kann ich claude.ai im Browser verbinden?
Noch nicht. Connectoren für claude.ai und ChatGPT kommen später. Heute kannst du Claude Code, Claude Desktop (mit der Erweiterung oder dem Befehl), Codex, Cursor, OpenCode und VS Code verbinden.
Brauche ich CLAUDE.md noch?
Ja, dafür, wie in einem Projekt gearbeitet wird. Knowtarium enthält das Wissen selbst, und seine Ordneranweisungen, die du in der App schreibst, gelten für jeden Agenten, den du verbindest. Regeln für die Notizen gehören also dorthin.