Einen Assistenten verbinden

kumbuka wird von einem KI-Client als benutzerdefinierter MCP-Connector erreicht: Sie geben die Endpunkt-URL ein — sonst nichts. Sobald die Verbindung besteht, kann der Assistent die Gedächtnis-Tools in Ihrem Namen aufrufen — einschließlich Ihres eigenen privaten Scopes, denn die Verbindung ist auf Sie, den authentifizierten Benutzer, beschränkt.

Diese Seite beschreibt das Hinzufügen des Connectors in claude.ai. Für Claude Desktop, Claude Code und Claude Mobile siehe die kumbuka-server-Anleitung.

Was Sie benötigen

Aus dem Verbindungsbereich auf der Übersichtsseite der Admin-Konsole (oder von Ihrem Administrator):

• Endpunkt-URL — die /mcp-Adresse, z. B. https://mcp.kumbuka.ai/mcp (der Host Ihrer Bereitstellung; sie ist Konfiguration, kein fester Wert).

Das ist alles. Es gibt keine Client-ID und kein Client-Secret einzugeben: Der KI-Client weist sich gegenüber dem Autorisierungsserver selbst aus und registriert sich bei der ersten Autorisierung. Der Zugriff wird widerrufen, indem der registrierte Client im Identity-Provider deaktiviert wird — das ist der Notausschalter auf Connector-Ebene; es gibt kein Secret zu rotieren.

Remote-MCP-Connectoren in claude.ai erfordern einen kostenpflichtigen Plan. Ein im Web hinzugefügter Server wird von Claude Mobile übernommen.

In claude.ai hinzufügen

1. Gehen Sie zu Settings → Connectors → Add custom connector.
2. Geben Sie die Endpunkt-URL aus dem Verbindungsbereich ein.
3. Speichern Sie und klicken Sie dann auf Connect. claude.ai ermittelt den Autorisierungsserver aus dem Endpunkt und startet den OAuth-Flow.
4. Melden Sie sich an Ihrem Keycloak-Host an (z. B. https://auth.kumbuka.ai) und genehmigen Sie den Zugriff. Sie werden zurückgeleitet und der Connector wird aktiv.

Was im Hintergrund passiert

Der Connector ist ein OAuth-Client, der PKCE verwendet. claude.ai ermittelt den Autorisierungsserver über OAuth Protected Resource Metadata (/.well-known/oauth-protected-resource → der Keycloak-Realm kumbuka) und weist sich über seine veröffentlichten Client-Metadaten oder die dynamische Client-Registrierung selbst aus — deshalb wird keine Client-ID und kein Secret von Hand eingegeben. Anschließend durchläuft er den Authorization-Code-Flow und ruft /mcp mit einem audience-gebundenen Bearer-Token auf. Das Subject des Tokens sind Sie; Ihre Realm-Rolle (member oder admin) bestimmt, was Sie tun dürfen. Siehe Architektur für die vollständige Auth-Topologie.

Was der Assistent dann tun kann

Mit aktivem Connector verfügt der Assistent über die fünf memory_*-Tools (vollständige Referenz unter MCP-Tools):

• Kontext laden zu Beginn einer Sitzung mit memory_load_context — ein typisierter Auszug der Regeln, die seine Arbeit steuern sollen.
• Abrufen bestimmter Einträge mit memory_recall (Filter nach Scope, Typ oder einer Teilzeichenkette).
• Merken neuer Entscheidungen, Konventionen oder Status mit memory_remember.
• Vergessen von Einträgen, die nicht mehr gelten, mit memory_forget.
• Scopes auflisten, die er sehen kann, mit memory_scopes — einschließlich Ihres privaten Scopes, den nur Sie erreichen können.

Wo ein neues Gedächtnis landet, wenn Sie keinen Scope angeben, wird durch die Standard-Schreib-Scope-Richtlinie des Teams bestimmt (ask als Standard — der Assistent schlägt vor und Sie bestätigen). Siehe Konfiguration.

Ein guter erster Schritt in einem Projekt ist, den Assistenten anzuweisen, zu Sitzungsbeginn memory_load_context aufzurufen, damit er das steuernde Wissen des Teams anwendet, ohne dass es ihm erneut erklärt werden muss.