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 configzeigt 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
readreicht für Recall-Anfragen,writeist 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.
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)
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).
{
"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).
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.
| Tool | Zweck | Scope |
|---|---|---|
knowmind_recall | Hybrid-Recall (BM25 + Vektor + Graph-Hops) | read |
knowmind_recall_at_time | Recall mit Zeitfilter (bi-temporal) | read |
knowmind_health | Service-Status | — |
knowmind_stats | Korpus-Statistik (Memories, Edges) | read |
knowmind_list_recent | Neueste Erinnerungen chronologisch auflisten | read |
knowmind_store_memory | Neue Erinnerung anlegen | write |
knowmind_upload_document | Längeren Text als Dokument ingesten (mit Chunking) | write |
knowmind_update_fact | Bi-temporales Update (alte Aussage SUPERSEDED) | write |
knowmind_link | Typisierte Beziehung zwischen Memories anlegen | write |
knowmind_unlink | Beziehung löschen | write |
knowmind_list_relations | Alle Beziehungen einer Memory anzeigen | read |
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.