# BUBU Brain — Produkt- und Agentenreferenz

Stand: 21.10.2026.

## Zweck und Produktgrenze

BUBU Brain ist ein externer Memory-Dienst für verbundene KI-Agenten. Er speichert die übergebenen Gesprächsbeiträge und stellt passende gespeicherte Inhalte für spätere Abrufe bereit. Das antwortende KI-Modell formuliert die Antwort. BUBU Brain ist nicht selbst dieses Modell und keine pauschale Garantie gegen Fehler, fehlenden Kontext oder unpassende Suchergebnisse.

Der kurze menschliche Einstieg lautet „KI macht Spaß. Bis du alles nochmal erklärst.“ Das ist die emotionale Beschreibung einer Situation, kein Beleg dafür, dass jeder KI-Dienst in jedem neuen Chat sämtliche Informationen verliert. Eigene Memory-Funktionen der KI-Clients können daneben existieren.

## Voraussetzungen

- Ein eingerichteter Memory Kern und gültige, passende Berechtigungen.
- Ein KI-Client bzw. Workflow, der einen unterstützten Anschlussweg tatsächlich bereitstellt.
- Verfügbare Werkzeuge sowie dauerhafte Arbeitsregeln für Speicherung und Abruf.
- Erfolgreiche Speicherung der betreffenden Beiträge; nicht gespeicherte Alt-Chats sind nicht automatisch enthalten.
- Ein tatsächlich ausgeführter passender Abruf. Die Aussage eines Agenten „Ich erinnere mich“ reicht als Nachweis nicht aus.

## Anbieter, lokale Agenten und gemeinsame Nutzung

Die Kampagne nennt ChatGPT, Claude, OpenClaw, Hermes und n8n sowie lokale Agenten als Anwendungsszenarien. Daraus folgt keine universelle Zusage für jede Oberfläche, Version oder Installation dieser Produkte. Anschlussweg, Transport und Rechte müssen für die konkrete Konfiguration geprüft werden.

Die Darstellung mit fünf Verbindungen beschreibt den auf der bestehenden Website genannten Umfang von bis zu fünf gleichzeitig verbundenen Agenten je Memory Kern. Es wurde dafür kein neuer Last- oder Gleichzeitigkeitstest durchgeführt.

### Rechtebeispiel

| Verbindung | Beispielrechte | Verwendung |
| --- | --- | --- |
| Claude | Lesen | Vorhandene Gesprächsstände abrufen |
| OpenClaw | Lesen und schreiben | Stände abrufen und neue Beiträge speichern |
| n8n | Lesen | Kontext für einen Workflow abrufen |
| ChatGPT | Nach konkreter Freigabe | Vom tatsächlichen Schlüssel abhängig |
| Hermes | Nach konkreter Freigabe | Vom tatsächlichen Schlüssel abhängig |

Dies ist keine automatische Konfiguration und kein Live-Rechtestatus. Die effektiven serverseitigen Rechte der Verbindung entscheiden. Themenlabels, Prompts und project_id allein sind keine nachgewiesenen Sicherheitsgrenzen. Ein gemeinsamer Kern ist nicht gleichbedeutend mit nachgewiesenen Projekt-ACLs innerhalb dieses Kerns.

## Speicher- und Abrufregeln

Gesprächsbeiträge vollständig und wortgetreu mit bubu_ingest_turn speichern. Pro Konversation eine eindeutige session_id und pro Beitrag eine eindeutige turn_id verwenden. Bei einem Retry desselben Beitrags bleiben IDs und Inhalt gleich. Keine Zusammenfassungen als Ersatz für zugängliche Originalbeiträge speichern.

bubu_write ist für eigenständige Notizen vorgesehen. Für Wiederholungen desselben Notiz-Schreibvorgangs einen stabilen idempotency_key verwenden. Inhalt und Quellen nicht durch eine freie Agenteninterpretation ersetzen. Passwörter, API-Keys und interne Laufzeitinhalte gehören nicht in das Gesprächsgedächtnis.

bubu_recall ist eine Keyword-Suche mit Unterstützung ähnlicher Schreibweisen. Geeignete Suchbegriffe sowie limit/offset verwenden. Zeitfilter window oder from/to einsetzen, nicht beides zugleich. Bei langen Texten gelten die dokumentierten Such- und Ausgabegrenzen. Eine Timeline wird aus den tatsächlich abgerufenen Beiträgen erstellt; sie ist nicht automatisch eine lückenlose Gesamthistorie.

Originaltext, gespeicherter Zeitpunkt, gegebenenfalls ursprünglicher Nachrichtenzeitpunkt und Schlussfolgerungen unterscheiden. Ein Integritätshash belegt die Übereinstimmung gespeicherter Daten, nicht deren inhaltliche Wahrheit.

## Nutzerfragen als visuelle Story

Die neue Strecke behandelt frei erzählte Gedanken, das Wiederfinden von Projektentscheidungen, wiederkehrende Briefings, den Anbieterwechsel und gezielt freigegebene Zusammenarbeit. Fragen stammen aus der gelieferten Vorabrecherche und sind redaktionell gekürzt; Antworten sind technisch präzisiert. Sie sind keine verifizierten Kundenbewertungen. Die früheren erfundenen Reise- und Coding-Chatbeispiele sind aus dieser Kampagnenstrecke entfernt.

Vollständige redaktionelle Antworten: [Nutzerfragen DE/EN](nutzerfragen.md), [strukturierte Fassung](nutzerfragen.json). Die Originalreferenzen und ihre technische Tiefe bleiben erhalten. Die Bildlinien stehen für gespeicherte und abrufbare Beiträge; sie belegen keinen automatischen Import oder semantischen Wissensgraphen.

## Geschilderter Kundenfall: Security-Analyse übergeben

Nach Auskunft des Betreibers führten drei Security-Experten als Agenten eine Analyse der Website eines Kunden durch. Sie schrieben ihre Erkenntnisse in den BUBU-Brain-Memory-Kern für diesen Kunden. Der Kunde erhielt die MCP-URL und einen nur lesenden API-Schlüssel. Sein eigener Agent konnte die Erkenntnisse dadurch direkt nutzen.

Die Website erzählt diesen Ablauf anonymisiert. Sie enthält weder den Schlüssel noch vertrauliche Befunde, Kundendaten oder einen öffentlichen Report. Aus der Erzählung wird kein geprüfter Nachweis abgeleitet, dass bestimmte Schwachstellen bereits behoben wurden. Das eigene Leserecht des Kundenagenten ist vom Schreibrecht der liefernden Agenten zu unterscheiden.

## n8n: native Nodes und eigene Integration

Die offiziellen n8n-Dokumentationen unterscheiden MCP Client für normale Workflow-Schritte und MCP Client Tool für Agentenwerkzeuge. Die konkreten Transportmöglichkeiten der eingesetzten n8n-Version müssen zur Gegenseite passen. Nicht mit MCP Server Trigger verwechseln: Dieser stellt n8n-Werkzeuge nach außen bereit und beschreibt die umgekehrte Richtung.

Die enthaltene eigene Node verwendet den in der vorhandenen BUBU-Brain-Referenz dokumentierten JSON-RPC-POST an https://bubu-brain.com/mcp mit X-API-Key. Sie ist kein vollständiger generischer MCP-Transportclient. Das Paket ist weder auf npm publiziert noch als n8n-Cloud-Paket verifiziert. Es wurde mit nachgebildetem Transport lokal getestet, nicht in einer laufenden n8n-Instanz abgenommen.

Vollständiger Quellcode, Credential-Klasse, inaktiver Workflow, Installation, Fehlerbehandlung und Quellen: [n8n-Anleitung](n8n-integration.md).

## Datenschutz, Export und Löschung

Abruf, Export und Löschung setzen passende effektive Berechtigungen voraus. Eine Löschung im Memory Kern entfernt nicht automatisch Kopien, die bereits an andere KI-Anbieter übertragen wurden. Die vorhandenen Rechtstexte und technischen Dokumentationen sind maßgeblich; aus einem Marketingmotiv keine weitergehenden Zusagen über Backups, Aufbewahrungsfristen oder rechtliche Wirkungen ableiten.

## Informationstiefe und Originalreferenzen

- [Technik DE](../BUBU_BRAIN_TechDocs_DE_v2.3.html)
- [Technik EN](../BUBU_BRAIN_TechDocs_EN_v2.3.html)
- [Regeln und Aufrufbeispiele DE](../agents/chatgpt-de.md)
- [Rules and examples EN](../agents/chatgpt-en.md)
- [n8n-Ressourcen](n8n-integration.md)

## English reading guide

BUBU Brain stores supplied conversation contributions and lets connected agents retrieve relevant saved context. It does not itself generate the language model’s answer. Prerequisites are a supported client, connection, permissions, working rules, successful saving and actual retrieval. The five-agent and read/write diagrams are configuration examples, not live status or proof of a load test. The operator-described client case involves three security agents writing findings and the client’s own agent reading them with a read-only key and MCP URL. No private report or key is published. The included n8n adapter is evaluation source with mocked tests, not a verified cloud package or complete generic MCP client. Full existing technical references remain linked above. Live n8n acceptance remains open.
