Integration

knowmind in jeden Chat — sieben Wege.

knowmind spricht das Model Context Protocol (Stand 2025-06-18) unter https://knowmind.de/api/mcp/v1 über JSON-RPC 2.0 mit optionalem Streamable-HTTP-Transport (SSE). Damit funktioniert es in Browser-Chats wie claude.ai und ChatGPT, in Desktop-Apps und in der Kommandozeile — überall gleich.

Token — einmaliger Schritt

Sie brauchen einen Bearer-Token im Format kmt_…. Es gibt zwei Wege:

  • Bestehenden Token wiederverwenden: Wenn Sie die knowmind-CLI bereits eingerichtet haben, liegt Ihr Token unter ~/.knowmind/config.json. knowmind config zeigt den Prefix an; der Vollwert ist nur in der Datei selbst lesbar. Derselbe Token funktioniert in jedem Connector — Browser, App, CLI.
  • Neuen Token erzeugen: Im Dashboard unter Tokens einen weiteren anlegen — sinnvoll, wenn Sie pro Gerät oder pro App einen eigenen Token wollen (gezielter widerrufbar). Scope read reicht für Recall-Anfragen, write ist nötig zum Speichern und Beziehungen-Pflegen. Token wird einmal beim Anlegen angezeigt, danach speichert knowmind nur den Hash.

claude.ai (Browser)

In claude.ai unter Settings → Connectors → Add custom connector.

text
Name:       knowmind
URL:        https://knowmind.de/api/mcp/v1
Auth-Typ:   Bearer
Token:      kmt_… (aus Dashboard kopiert)

Nach dem Verbinden tauchen die knowmind-Tools rechts in jedem Chat-Fenster auf. Frage etwa: „Was wissen wir über Projekt Helios?"Claude erkennt die Frage als Recall-Trigger, ruft knowmind_recall auf und antwortet mit dem Doku-Kontext. Schreibanfragen wie „Speichere als neue Erinnerung: …" lösen knowmind_store_memory aus.

ChatGPT (Plus/Team/Pro)

Unter Settings → Connectors → New Custom Connector. Identisches Vorgehen wie bei claude.ai — URL, Bearer-Token. ChatGPT zeigt die Tools anschließend in der seitlichen Werkzeugleiste.

Falls Sie ChatGPT Free nutzen oder einen eigenen GPT verteilen wollen: knowmind funktioniert auch als Custom GPT mit OpenAPI-Action — Schemata auf Anfrage unter info@schuebeler-consulting.de.

Claude Code (CLI)

bash
claude mcp add knowmind \
  --transport http \
  --url https://knowmind.de/api/mcp/v1 \
  --header "Authorization: Bearer kmt_…"

Danach steht knowmind in jedem Claude-Code-Chat zur Verfügung — Recall, Store, Link, Unlink, Update.

Claude Desktop (Mac, Windows)

Konfigurations-Datei öffnen: ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) bzw. %APPDATA%\Claude\claude_desktop_config.json (Windows).

json
{
  "mcpServers": {
    "knowmind": {
      "type": "http",
      "url": "https://knowmind.de/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer kmt_…"
      }
    }
  }
}

Claude Desktop neu starten, danach erscheint knowmind im Tool-Drawer.

Cursor / Continue / Cline

Alle drei verwenden dasselbe MCP-Format wie Claude Desktop. In Cursor unter Settings → MCP, in Continue über config.json, in Cline über die Extension-Settings.

LM Studio (lokales LLM)

Seit Version 0.3.5 unterstützt LM Studio MCP-Server. knowmind unter Settings → MCP Servers eintragen — Ihre Anfragen gehen an das lokal laufende Modell, die Erinnerungen bleiben in knowmind.

Eigene Anwendung — JSON-RPC direkt

JSON-RPC 2.0 über HTTP POST, optional Streamable-HTTP via SSE (Accept: text/event-stream).

bash
curl -X POST https://knowmind.de/api/mcp/v1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kmt_…" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "knowmind_recall",
      "arguments": { "query": "Wann ist die nächste Q3-Review?", "k": 5 }
    }
  }'

Verfügbare Tools

Alle Tools sind über tools/list abrufbar. Schreibend wirken nur Tools mit Scope write oder admin.

ToolZweckScope
knowmind_recallHybrid-Recall (BM25 + Vektor + Graph-Hops)read
knowmind_recall_at_timeRecall mit Zeitfilter (bi-temporal)read
knowmind_healthService-Status
knowmind_statsKorpus-Statistik (Memories, Edges)read
knowmind_list_recentNeueste Erinnerungen chronologisch auflistenread
knowmind_store_memoryNeue Erinnerung anlegenwrite
knowmind_upload_documentLängeren Text als Dokument ingesten (mit Chunking)write
knowmind_update_factBi-temporales Update (alte Aussage SUPERSEDED)write
knowmind_linkTypisierte Beziehung zwischen Memories anlegenwrite
knowmind_unlinkBeziehung löschenwrite
knowmind_list_relationsAlle Beziehungen einer Memory anzeigenread

Sicherheit

  • • Tokens sind tenant-gebunden — ein Token kann nur Memories des eigenen Arbeitsbereichs sehen.
  • • Scope-Modell (read/write/admin) wird auf jedem Tool-Call serverseitig geprüft.
  • • Alle Token-Aktionen landen im Sicherheits-Protokoll (Audit-Log).
  • • Token-Widerruf jederzeit über Dashboard → Tokens.