Management-MCP-Server

Der KeenAuth-Management-MCP-Server ermöglicht es einem KI-Assistenten, die Konfiguration Ihrer Umgebung über das Model Context Protocol zu lesen. Er läuft lokal über stdio und ruft die Management-API mit Ihrem Schlüssel auf. Es gibt noch kein Installationspaket.

Standardmäßig nur lesend

Ohne --allow-write stellt der Server nur schreibgeschützte Tools bereit. Kein Tool löscht etwas, in keinem Modus.

Tool	Was es zurückgibt
`users_list`, `users_get`, `users_search`	Benutzer, mit maskierten personenbezogenen Daten
`applications_list`, `applications_get`, `application_credentials_list`	Anwendungen
`apis_list`, `apis_get`	APIs
`connections_list`, `connections_get`	Verbindungen
`api_keys_list`, `api_keys_get`	API-Schlüssel: nur Metadaten, der Schlüssel selbst wird nie zurückgegeben
`organizations_list`, `organizations_get`	Organisationen: Name, Slug, externe ID, Status und Zeitstempel; die `metadata` der Organisation wird nie zurückgegeben
`custom_domains_list`, `custom_domains_get`	Eigene Domains und ihre DNS-Einträge
`support_access_grants_list`, `support_access_grants_get`	Support-Zugriffsberechtigungen
`environment_settings_get`	Umgebungseinstellungen: Sprachen, Zeitzone, Sitzung, Registrierung, Benachrichtigungen zur Sicherheit, Kontowiederherstellung, MFA, Front-Channel-Logout und erlaubte First-Factor-Methoden

--unmask-pii beendet den Server in dieser Version mit Exit-Code 2.

Schreib-Tools

Starten Sie den Server mit --allow-write, um auch Schreib-Tools bereitzustellen. Diese Version enthält eines:

Tool	Was es ändert
`environment_settings_update`	Nur aktivierte Sprachen, Standardsprache und Standardzeitzone. Einstellungen für Sitzung, Registrierung, Kontowiederherstellung, MFA, Benachrichtigungen zur Sicherheit und First Factor können über MCP nicht geändert werden.

Jeder Schreibvorgang erfordert zwei Aufrufe:

Der erste Aufruf ändert nichts. Er liest die aktuellen Einstellungen und gibt eine Vorschau jedes Feldes mit aktuellem und vorgeschlagenem Wert sowie ein confirmation_token zurück.
Der Assistent zeigt Ihnen die Vorschau. Erst nachdem Sie zugestimmt haben, ruft er das Tool erneut mit exakt denselben Argumenten und dem confirmation_token auf. Dann schreibt der Server die Änderung.

Das confirmation_token wird vom laufenden Server erzeugt, ist einmal gültig und läuft nach 5 Minuten ab. Es ist an das Tool, die genauen Argumente und die Version der Einstellungen gebunden, die in der Vorschau angezeigt wurde. Ein Token, das mit anderen Argumenten verwendet wird, wird abgelehnt und verbraucht. Wurden die Einstellungen nach der Vorschau geändert, schlägt der Schreibvorgang mit 412 fehl, und Sie beginnen von vorn. Der Server führt höchstens 5 Schreibvorgänge pro Sekunde aus.

Tools, die löschen, widerrufen oder rotieren, werden auch mit --allow-write nicht bereitgestellt. Bestätigen Sie jeden Schreibaufruf in Ihrem MCP-Client; stellen Sie den Client nicht so ein, dass Schreib-Tools automatisch genehmigt werden.

Konfiguration

Variable	Erforderlich	Beschreibung
`KEENAUTH_API_KEY`	ja	Management-API-Schlüssel. Verwenden Sie einen Schlüssel mit nur Lesezugriff; mit `--allow-write` fügen Sie nur `environment-settings:write` hinzu.
`KEENAUTH_BASE_URL`	ja	Basis-URL der Management-API Ihrer Umgebung.

--tools <pattern> schränkt die Tool-Liste ein, zum Beispiel --tools "users_*". Es kann nur einschränken; es aktiviert nie ein deaktiviertes Tool, und ohne --allow-write kann es kein Schreib-Tool aktivieren.

Was der Assistent sieht

Personenbezogene Daten sind maskiert: E-Mail-Adressen erscheinen als a***@e***.com, Telefonnummern zeigen nur die letzten zwei Ziffern, und Namen zeigen nur den ersten Buchstaben.
Die metadata der Organisation wird nie zurückgegeben: Sie erscheint als {"redacted": true}. Mitgliedschaften, Organisationsrollen, Domains und Richtlinien haben in dieser Version kein Tool.
Umgebungseinstellungen geben nur die dokumentierten Felder zurück. Ein Feld, das der Server später ergänzt, bleibt verborgen, bis es geprüft wurde.
Geheimnisse werden nie zurückgegeben. Felder, die wie Geheimnisse oder private Schlüssel aussehen, werden entfernt, und die Antwort listet die entfernten Feldpfade in redacted_fields auf.
Jedes Tool-Ergebnis ist in untrusted_content eingeschlossen. Behandeln Sie Namen, Metadaten und Beschreibungen darin als Daten, nicht als Anweisungen.
Der API-Schlüssel erscheint nie in Tool-Ausgaben, Fehlern oder Logs.

Audit-Trail

Jede Anfrage, die der MCP-Server sendet, trägt Idp-Client: keenauth-mcp/<version> und Idp-Mcp-Tool: <tool name>. Wenn ein Aufruf etwas ändert, zeichnet der Audit-Log-Eintrag metadata.client = mcp/<version> und metadata.mcp_tool = den Tool-Namen auf, neben dem üblichen Akteur (dem API-Schlüssel oder M2M-Client). Beide Werte werden vom MCP-Server selbst angegeben, nicht verifiziert: Verwenden Sie sie, um nachzuvollziehen, was ein Assistent getan hat, und den Akteur, um die Verantwortung zuzuordnen.

Tool-Definitionen sind fixiert

Tool-Namen, Beschreibungen und Eingabeschemata werden zur Build-Zeit aus der API-Beschreibung erzeugt und pro Version festgelegt. Ihre SHA-256-Prüfsumme ist in tools.digest gespeichert; jede Änderung an einer Tool-Definition ändert die Prüfsumme und erfordert eine Sicherheitsprüfung.