Persistentes KI-Gedächtnis auf Cloudflare aufbauen

Die Bedeutung eines persistenten KI-Gedächtnisses für Agenten

Da KI-Assistenten immer stärker in unseren Alltag integriert werden, stehen wir häufig vor dem Problem des leeren Kontexts (Blank-Context-Problem). Entscheidungen, die letzte Woche getroffen wurden, sind vergessen, was uns dazu zwingt, immer wieder dieselben Details zum Tech-Stack einzugeben und die Benutzerpräferenzen in jeder neuen Sitzung neu festzulegen.

Anstatt jedes Mal bei Null anzufangen, müssen wir ein Gedächtnissystem aufbauen, das sich weiterentwickelt, die Entscheidungen eines Benutzers kontinuierlich versteht und die Notwendigkeit einer ständigen Kontextwiederholung beseitigt.

Selbstgehostete vs. integrierte KI-Gedächtnissysteme

Viele KI-Agenten verfügen über ein integriertes Gedächtnis, aber wir nutzen selten nur einen einzigen Agenten für alle Zwecke. Wir verwenden Claude für den Entwurf und die Architektur eines Projekts, Kimi für die Programmierung und ChatGPT für die allgemeine Recherche. Der Kontext wird nicht zwischen diesen verschiedenen Agenten geteilt; er bleibt in jedem Tool isoliert.

Aus Sicht der Softwareentwicklung vertrauen wir keinen Blackboxes. Wir benötigen ein KI-Gedächtnissystem, das beobachtbar, überprüfbar und vollständig unter unserer Kontrolle ist. Das Open-Source-Projekt Second Brain, ein Fork von https://github.com/rahilp/second-brain-cloudflare, bietet ein persistentes und selbstgehostetes Gedächtnissystem mit Unterstützung für das Model Context Protocol (MCP). Jeder kompatible KI-Agent wie Claude, ChatGPT oder Kimi Code kann somit denselben einheitlichen Kontext nutzen.

So bauen Sie ein Second Brain KI-Gedächtnis auf Cloudflare auf

Das Second Brain-Gedächtnissystem wird auf Cloudflare Workers bereitgestellt, was eine global verteilte Serverless-Infrastruktur mit extrem niedriger Latenz bietet. Dadurch können Speicherabrufe (Recall) und andere Operationen nahezu verzögerungsfrei innerhalb der logischen Schleife der KI ausgeführt werden.

Das Embedding-Modell von Workers AI wird zur Generierung der Vektoren verwendet. Diese Einbettungen werden in Cloudflare Vectorize gespeichert, einer hochgradig optimierten, global verteilten Vektordatenbank. Cloudflare Vectorize führt Cosinus-Ähnlichkeitssuchen (Cosine Similarity) durch, um semantisch relevante Erinnerungen präzise zu identifizieren.

Second Brain verfügt zudem über intelligente Mechanismen zur Duplikaterkennung und -zusammenführung. Inhalte mit einer Ähnlichkeit von weniger als 85 % werden gespeichert; andernfalls werden sie blockiert oder als potenzielle Duplikate markiert. Längere Texte mit mehr als 1.600 Zeichen werden an Satzgrenzen oder Zeilenumbrüchen aufgeteilt, wobei ein Überlappungsbereich (Overlap) von 200 Zeichen beibehalten wird, um den Verlust von Kontext zu verhindern. Jeder Abschnitt wird anschließend vektorisiert, was eine hochpräzise Zuordnung ermöglicht.

Die folgenden Werkzeuge werden als MCP-Schnittstellen für die direkte Nutzung durch KI-Agenten bereitgestellt:

• remember: Speichert Ideen, Entscheidungen, Präferenzen und Projektkontexte.
• append: Fügt Aktualisierungen zu einer bestehenden Erinnerung hinzu.
• update: Ersetzt eine bestehende Erinnerung vollständig.
• recall: Findet Erinnerungen basierend auf ihrer semantischen Bedeutung anstatt exakter Formulierungen.
• list_recent: Listet die kürzlich gespeicherten Erinnerungen auf.
• forget: Löscht eine Erinnerung dauerhaft.
• link/connections: Verknüpft zusammenhängende Erinnerungen (V2-Graphenfunktion).

Second Brain auf Cloudflare einrichten

1. Klicken Sie auf der Seite des Github-Repositorys auf Deploy to Cloudflare. [[]]
2. Füllen Sie das angezeigte Cloudflare Worker-Formular aus.
3. Geben Sie bei Dimensions '384' ein, wählen Sie bei Metric 'cosine' und klicken Sie auf den Button Deploy.
4. Folgendes ist die Übersicht Ihres Second Brain im Cloudflare Worker:
5. Klicken Sie auf 'Settings' (Einstellungen) und anschließend auf das Bearbeiten-Symbol bei 'AUTH_TOKEN', um einen Sicherheitsschlüssel zu erstellen:
6. Klicken Sie auf den Link 'Rotate', um einen neuen Wert einzugeben:
7. Führen Sie den Befehl openssl rand -base64 32 im macOS-Terminal aus, um einen sicheren Zufallswert zu generieren, und fügen Sie diesen in das Eingabefeld 'Value' ein.
8. Klicken Sie auf den Button 'Deploy', um den neuen Wert für 'AUTH_TOKEN' zu speichern.
9. Öffnen Sie die URL Ihres Second Brain Workers im Webbrowser.
10. Tragen Sie das erstellte 'AUTH_TOKEN' im Feld Bearer token ein und klicken Sie auf 'Connect', um sich auf der Web-Benutzeroberfläche (Web UI) anzumelden.

Claude Desktop via MCP integrieren

1. Klicken Sie im Claude Desktop auf 'Customize' (Anpassen).
2. Klicken Sie auf 'Developer', um die MCP-Server-Konfigurationsdatei manuell zu bearbeiten:
3. Fügen Sie den folgenden Code-Block zum Abschnitt mcpServers in der Datei claude_desktop_config.json hinzu:

    "second-brain": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker-url>/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }

4. Starten Sie Claude Desktop neu und überprüfen Sie die Liste der 'Local MCP servers'. Der Status sollte 'running' (aktiv) anzeigen.

Claude Code via MCP integrieren

• Führen Sie den folgenden Befehl im Terminal aus, um den neuen MCP-Server hinzuzufügen:

claude mcp add --transport http second-brain https://<your-worker-url>/mcp

• Claude Code erkennt automatisch, dass der Endpunkt OAuth erfordert, und öffnet eine Anmeldeseite im Webbrowser, auf der Sie Ihr AUTH_TOKEN bestätigen können.
• Erstellen Sie die Datei CLAUDE.md im Verzeichnis ~/.claude mit den Anweisungen aus CLAUDE_INSTRUCTIONS.md.

Gemini CLI via MCP integrieren

1. Fügen Sie die folgenden Einstellungen für den MCP-Server zu Ihrer Datei './.gemini/settings.json' hinzu:

    "second-brain": {
      "httpUrl": "https://<your-worker-url>/mcp",
      "oauth": {
        "enabled": true
      }
    }

2. Starten Sie das Gemini CLI.

Second Brain in KI-Agenten testen

1. Wenn Sie mit einer einfachen Marken-Farbpalette im Claude Desktop beginnen, wird Second Brain standardmäßig nicht aufgerufen.
2. Bei der Verwendung einfacher Schlüsselwörter wie 'remember' werden lediglich die lokalen Standardwerkzeuge memory_user-edits im Claude Desktop ausgeführt, nicht jedoch das Remote-Gedächtnis von Second Brain.
3. Nach der Eingabe des folgenden Prompts im Claude Code wurde Second Brain erfolgreich aufgerufen:

Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black."

4. Überprüfung der Farbeinstellungen direkt im Dashboard von Second Brain auf Cloudflare: - Claude Code funktionierte nahtlos, da die Datei CLAUDE_INSTRUCTIONS.md im Projekt Regeln enthielt, die auf die Schlüsselwörter von 'Second Brain' verweisen. 5. Um diese Integration im Claude Desktop zu nutzen, muss der Begriff 'Second Brain' explizit in Ihrem Prompt erwähnt werden, um das Speichern oder Auslesen auf dieser persistenten Gedächtnisschicht zu erzwingen. 6. Gleiches gilt für das Gemini CLI, bei dem Sie 'Second Brain' erwähnen müssen, um die zugehörigen MCP-Werkzeuge zu aktivieren. - Durch das Hinzufügen ähnlicher Anweisungen zu Ihrer GEMINI.md, analog zur Funktionsweise von CLAUDE_INSTRUCTIONS.md, kann das System Second Brain im Hintergrund nutzen, ohne dass Sie die Schlüsselwörter explizit eingeben müssen.

Webbrowser-Erweiterungen

• Erweiterungen sind für die Webbrowser Chrome, Firefox und Microsoft Edge verfügbar.
• Die Erweiterungen dienen folgenden Zwecken:
  • Aktuelle Seite erfassen — speichert den Titel und die URL im Second Brain.
  • Ausgewählten Text erfassen — markieren Sie einen beliebigen Textabschnitt auf einer Webseite vor dem Klick auf das Erweiterungssymbol; der Textauszug wird zusammen mit Titel und URL gespeichert.
  • Notizen hinzufügen — schreiben Sie Notizen oder weisen Sie #hashtags direkt im Popup der Erweiterung zu; Hashtags werden automatisch als Tags indexiert.

Persönliches Wissen mit dem Obsidian-Plugin synchronisieren

• Es ist ein Obsidian-Plugin verfügbar, um Notizen aus Ihrem Obsidian-Vault direkt mit Ihrem Second Brain auf Cloudflare zu synchronisieren.
• Notizen können mit spezifischen Tags versehen werden, um sie für den persistenten Speicher freizugeben.

Obsidian-Plugin installieren

1. Öffnen Sie Obsidian → Settings → Community Plugins
2. Klicken Sie auf den Button 'Browse' (Durchsuchen).
3. Suchen Sie nach 'Second Brain Sync'.
4. Klicken Sie auf 'Install' (Installieren) und anschließend auf 'Enable' (Aktivieren).

Obsidian-Plugin konfigurieren

1. Gehen Sie zu Obsidian → Settings → Second Brain Sync
2. Tragen Sie Ihre 'URL' und Ihr 'Auth token' (Sicherheitsschlüssel) ein.
3. Klicken Sie auf den Button 'Test', um die Verbindung zu überprüfen.
4. Konfigurieren Sie das Synchronisationsverhalten. Definieren Sie das Synchronisations-Tag unter 'Sync tag' und aktivieren Sie 'Auto-sync on save'.
5. Erstellen Sie eine neue Notiz in Ihrem Obsidian-Ordner mit dem Tag 'second-brain' (wie in den Einstellungen konfiguriert).
6. Die Notiz wurde gespeichert und sofort mit Ihrer Cloudflare-Instanz synchronisiert.

Fazit

Second Brain bietet eine intelligente Open-Source-Lösung für eines der frustrierendsten Probleme im Bereich der KI: das Fehlen eines persistenten Gedächtnisses. Durch die Kombination des Projekts mit der skalierbaren Infrastruktur von Cloudflare erhalten wir eine vollständig selbstgehostete semantische Gedächtnisschicht, die global verteilt ist und extrem niedrige Latenzen aufweist. Dank der MCP-Unterstützung ist diese Wissensbasis nahtlos zwischen verschiedenen KI-Assistenten portierbar.

Die Integration des Obsidian-Plugins erweitert diese Architektur, indem sie Ihre persönliche Wissensdatenbank direkt mit der logischen Analyse der KI verbindet. Rohe Notizen werden in einen strukturierten Kontext umgewandelt, den KI-Agenten jederzeit semantisch verstehen und abfragen können.

Durch die Zusammenführung von Self-Hosting, semantischer Vektorsuche und offenen Integrationsstandards wie dem MCP beweist Second Brain, dass es weit mehr als nur ein Speicherort ist — es ist das praktische Fundament für den Aufbau eines eigenen, leistungsstarken KI-Ökosystems.

Referenzen:

• https://www.thesecondbrain.dev/
• https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works
• Connect to AI Clients
• Second Brain Obsidian Plugin
• https://github.com/rahilp/second-brain-obsidian-plugin