# BUBU Brain × n8n: Ressourcen und Anschlusswege

Stand: 21.10.2026. Eigene Integration als Prüfstand. Kein behaupteter erfolgreicher Lauf in einer n8n-Instanz.

## Direkt verfügbare Ressourcen

- [Installierbares lokales Node-Paket](../n8n/n8n-nodes-bubu-brain-0.1.0.tgz)
- [Importierbarer Workflow: lesender Abruf](../n8n/bubu-brain-read-context.workflow.json)
- [Vollständiger Node-Quellcode](../n8n/n8n-nodes-bubu-brain-0.1.0.tgz)
- [Credentials-Quellcode](../n8n/n8n-nodes-bubu-brain-0.1.0.tgz)
- [Paketbeschreibung und Installation](../n8n/n8n-nodes-bubu-brain-0.1.0.tgz)
- [BUBU-Brain-Referenz und Agentenregeln](../agents/n8n-de.md)
- [English reference](../agents/n8n-en.md)

## Anschluss über die vorhandenen n8n-MCP-Nodes

Die offizielle n8n-Dokumentation unterscheidet:

1. **MCP Client**: externe Werkzeuge als normale Workflow-Schritte ausführen.
2. **MCP Client Tool**: externe Werkzeuge einem AI Agent verfügbar machen.

Beide Dokumentationen nennen Header-Authentifizierung. Die Anleitung des MCP Client bietet einen auswählbaren Server Transport; beim MCP Client Tool steht in der aktuellen Beschreibung ein SSE-Endpoint-Feld. Die Fähigkeiten der konkret eingesetzten n8n-Version und der tatsächlich akzeptierte BUBU-Brain-Transport müssen zusammen geprüft werden. Es wird kein ungetesteter Transport-Menüwert als garantierte Lösung ausgegeben.

Die BUBU-Brain-Referenz nennt:

```text
POST https://bubu-brain.com/mcp
X-API-Key: DEIN_API_KEY
```

Den Schlüssel in einem n8n-Credential hinterlegen, nicht im Seitentext, Workflow-JSON oder in Ausführungsbeispielen. Zunächst nur die benötigten Werkzeuge freigeben. Für einen rein lesenden Ablauf einen entsprechenden Schlüssel verwenden.

## Alternative: das enthaltene eigene Node-Paket

Das Paket implementiert den in der BUBU-Referenz dokumentierten JSON-RPC-POST direkt mit dem authentifizierten HTTP-Helfer von n8n. Es ist keine Implementierung des gesamten MCP-Protokolls und kein Ersatz für beliebige SSE-/Streaming-Server.

Die vollständigen JavaScript-Quellen sind enthalten; eine TypeScript-Kompilierung ist für diese Paketfassung nicht erforderlich. Das Paket ist lokal installierbar, aber nicht im npm-Registry veröffentlicht und nicht als n8n-Cloud-Integration verifiziert. In einer selbst gehosteten Testinstanz installieren und prüfen. Installationspfad und Neustart richten sich nach der eigenen n8n-Bereitstellung.

Enthaltene Werkzeuge: health, stats, recall, ingest_turn, write, verify, export. Berichtigung, Löschung und Einschränkung bestehender Einträge werden in dieser einfachen Integration nicht angeboten. Die serverseitigen Rechte gelten unabhängig von der Node-Oberfläche.

## Lesender Beispiel-Workflow

Der Workflow ist inaktiv und enthält keine Zugangsdaten. Er besteht aus Manual Trigger → BUBU Brain (bubu_recall, Beispielsuche „Kundenbriefing“). Nach dem Import den gewünschten Schlüssel als Credential zuweisen. Die Suche kann leer ausfallen, wenn keine passenden Daten gespeichert sind. Die Ausgabe enthält das vollständige Toolresultat.

Das Kampagnenschaubild zeigt zusätzlich einen möglichen Ablauf über einen AI Agent und anschließende Speicherung. Dieser Ablauf ist eine konzeptionelle Darstellung; er wird durch den einfachen lesenden Beispiel-Workflow nicht bereits vollständig implementiert.

Für schreibende Workflows jeden zugänglichen Gesprächsbeitrag vollständig und wortgetreu übernehmen. Eindeutige session_id pro Konversation, eindeutige turn_id pro Beitrag; bei Wiederholung derselben Speicherung Inhalt und IDs beibehalten. Eigenständige Notizen mit bubu_write getrennt halten. Das Paket erzeugt keine gekürzten Zusammenfassungen.

## Abnahme in der eigenen Instanz

1. Node laden und Credential auswählen; bubu_health ausführen.
2. Mit einem lesenden Schlüssel einen tatsächlich gespeicherten eindeutigen Suchtext abrufen.
3. Ausgabe und Originalwortlaut vergleichen, JSON-RPC-error und result.isError prüfen.
4. Schreibenden Test nur mit passendem Schlüssel und ausdrücklich vorgesehenen Testinhalten durchführen; stabile IDs verwenden.
5. Fehler und Wiederholungen prüfen. Ein HTTP 200 allein ist kein Nachweis einer erfolgreichen Werkzeugausführung.

Lokale Tests prüfen die Node-Logik mit einem nachgebildeten HTTP-Helfer. Sie belegen keine erfolgreiche Verbindung zu BUBU Brain und keine Kompatibilität mit einer bestimmten n8n-Instanz.

## Offizielle Quellen

- https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpclient
- https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp
- https://docs.n8n.io/connect/create-nodes/build-your-node
- https://github.com/n8n-io/n8n-nodes-starter
- https://bubu-brain.com/static/BUBU_BRAIN_TechDocs_DE_v2.3.html

## English

This distribution includes the complete source of a custom BUBU Brain n8n node, an installable local package and an inactive read-only example workflow. It is an evaluation integration, not an npm publication or verified n8n Cloud package. Native MCP Client / MCP Client Tool nodes are an alternative. Store API keys in n8n credentials. Validate transport support, permissions, health and retrieval in your own instance. The custom adapter uses the documented JSON-RPC POST endpoint and JSON responses; it is not a complete generic MCP client. Local mocked tests do not constitute a live integration test. The BUBU Brain server source is not included.