n8n

Voraussetzungen

• n8n-Instanz (Cloud oder Self-Hosted) ab Version 1.50
• knowmind-Konto im Tarif Business API oder Enterprise (für eigene API-Tokens)
• API-Token mit Scope write für Store und Link, Scope read genügt für Recall und Stats

Schritte

1. 1

   Variante A: HTTP-Request-Node gegen die MCP-API (empfohlen)

   Der einfachste und stabilste Weg. Sie rufen die knowmind-MCP-API über JSON-RPC 2.0 auf und sparen sich jede Node-Installation. Legen Sie zunächst eine HTTP-Header-Auth-Credential an:

   textkopieren

   Credentials → New → HTTP Header Auth
   Name:           knowmind Bearer
   Header Name:    Authorization
   Header Value:   Bearer kmt_…

   Anschließend ein HTTP-Request-Node mit folgender Konfiguration:

   textkopieren

   Method:         POST
   URL:            https://knowmind.de/api/mcp/v1
   Authentication: Generic Credential Type
   Generic Auth:   HTTP Header Auth (knowmind Bearer)
   Send Body:      ja, Body Content Type: JSON
   JSON Body:
   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "tools/call",
     "params": {
       "name": "knowmind.recall",
       "arguments": { "query": "{{ $json.subject }}", "k": 5 }
     }
   }

   Ergebnis: Der Node liefert ein JSON-RPC-Response-Objekt zurück. Die Treffer stehen unter result.content[0].text als JSON-Text. Parse-Node nachschalten, um die Liste der Erinnerungen zu erhalten.

2. 2

   Beispiel-Workflow: Memory bei jeder neuen E-Mail anlegen

   Typischer Anwendungsfall — eine eingehende E-Mail wird als Erinnerung im Wissensspeicher abgelegt:

   textkopieren

   1. IMAP Email Trigger (n8n)
      → fängt neue E-Mails ab
   2. HTTP Request (POST https://knowmind.de/api/mcp/v1)
      Body:
      {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "knowmind.store_memory",
          "arguments": {
            "memory_type": "episodic",
            "title": "Mail von {{ $json.from }}",
            "content": "{{ $json.subject }}\n\n{{ $json.text }}",
            "source": "imap",
            "tags": ["mail", "{{ $json.from.replace('@', '-at-') }}"]
          }
        }
      }
   3. Set-Node: gespeicherte memory_id für spätere Schritte sichern

   Ergebnis: Jede E-Mail landet als typisierte Erinnerung im Wissensspeicher und kann später per Recall gefunden werden.

3. 3

   Variante B: Webhook-Node als knowmind-Empfänger

   Wenn n8n auf Events aus knowmind reagieren soll (Memory angelegt, Tarif geändert), tragen Sie einen Webhook-Trigger ein und hinterlegen seine URL in den Webhook-Einstellungen Ihres Arbeitsbereichs.

   textkopieren

   1. Webhook-Trigger in n8n erstellen
      HTTP Method:   POST
      Path:          /knowmind-events
      Authentication: None (HMAC-Verifikation passiert im Workflow)
   
   2. Im knowmind-Dashboard unter „Webhooks":
      URL:    https://n8n.example.com/webhook/knowmind-events
      Events: memory.created, memory.updated, link.created
      Secret: vom Dashboard kopieren, im Workflow für HMAC-Prüfung verwenden
   
   3. Function-Node im Workflow zur HMAC-Prüfung:
      const crypto = require('crypto');
      const sig = $headers['x-knowmind-signature'];
      const computed = crypto
        .createHmac('sha256', $vars.KNOWMIND_WEBHOOK_SECRET)
        .update(JSON.stringify($json))
        .digest('hex');
      if (sig !== computed) throw new Error('Signatur ungültig');
      return [{ json: $json }];

   Ergebnis: knowmind schickt bei jedem konfigurierten Event einen POST-Request an Ihren Workflow. Inhalt sind Event-Typ, Memory-ID und Zeitstempel — keine vollständigen Erinnerungs-Inhalte (siehe Datenfluss-Pfad E).

4. 4

   Variante C: Code-Node mit dem knowmind-npm-Paket (experimentell)

   Im Self-Hosted-n8n mit erlaubten externen npm-Modulen lässt sich das knowmind-CLI-Paket als Code-Node-Library einsetzen. Diesen Weg empfehlen wir nur, wenn Sie ohnehin schon mit Code-Nodes arbeiten.

   javascriptkopieren

   // n8n Code Node — JavaScript, Mode: Run Once for All Items
   // Voraussetzung: NODE_FUNCTION_ALLOW_EXTERNAL=knowmind in n8n-Umgebung
   const { KnowmindClient } = require('knowmind');
   
   const client = new KnowmindClient({
     baseUrl: 'https://knowmind.de',
     token: $vars.KNOWMIND_TOKEN,
   });
   
   const hits = await client.recall({
     query: $input.first().json.subject,
     k: 5,
     hops: 2,
   });
   
   return hits.results.map((hit) => ({ json: hit }));

   Ergebnis: Das Paket abstrahiert JSON-RPC-Aufrufe und PKCE-Handling. Updates werden über npm update knowmind im n8n-Container eingespielt.

5. 5

   Rate-Limits und Retries einplanen

   Workflows, die in Schleifen knowmind aufrufen (etwa beim Bulk-Import historischer E-Mails), laufen schnell in die Rate-Grenze: 60 Anfragen pro Minute im Tarif Business API, 600 im Enterprise. Der HTTP-Request-Node bietet im Reiter Retry On Fail einen eingebauten Retry — aktivieren Sie ihn mit Max Tries: 3und Wait Between Tries: 2000 ms. Bei HTTP 429 prüft knowmind den Retry-After-Header.

Prüfung des Ergebnisses

Fehlerbehebung

Roadmap: offizieller Community-Node

Ein offizieller n8n-nodes-knowmind-Community-Node ist in Vorbereitung. Geplante Operationen: Recall, Store, Link, Unlink, List Relations, Stats, Health. Sobald der Node veröffentlicht ist, wandert die Empfehlung von Variante A auf den Community-Node und diese Seite wird aktualisiert. Stand 2026-05-23: in Planung, kein fixes Release-Datum.