Okta MCP Server

Der Okta MCP Server verbindet KI-Assistenten wie Claude Code oder Cursor mit den Admin Management APIs Ihrer Okta-Organisation. Statt sich durch die Admin-Konsole zu klicken oder API-Aufrufe von Hand zusammenzusetzen, formulieren Sie eine Aufgabe in natürlicher Sprache, etwa „Zeige mir alle Anmeldefehler der letzten 24 Stunden“ oder „Lege einen Benutzer an und füge ihn der Gruppe Vertrieb hinzu“, und der Assistent ruft die passenden Werkzeuge auf. Das Projekt liegt in der GitHub-Organisation okta, trägt den Copyright-Vermerk „Okta, Inc.“, steht unter der Apache-2.0-Lizenz, hat aktuell rund 70 Sterne, ist nicht archiviert und wurde zuletzt am 20. Oktober 2026 aktualisiert. Laut README ist der Server allgemein verfügbar und nutzt das offizielle Python-SDK von Okta.

Was kann der Okta MCP Server?

Laut README deckt der Server die wichtigsten Verwaltungsbereiche einer Okta-Organisation ab. Bei Benutzern gibt es Auflisten, Abrufen, Anlegen, Aktualisieren, Deaktivieren, Löschen sowie das Anzeigen von Gruppenmitgliedschaften. Gruppen lassen sich anlegen, ändern und löschen, ebenso ihre Mitglieder und zugewiesenen Anwendungen verwalten. Bei Anwendungen reicht der Umfang vom Anlegen und Ändern über das Aktivieren und Deaktivieren bis zum Durchsuchen des Okta Integration Network und dem Installieren von Apps daraus. Hinzu kommen Richtlinien und Richtlinienregeln, Device-Assurance-Richtlinien, der Abruf von Systemprotokollen, Marken mit Themes, Logos und Anmeldeseiten, E-Mail-Vorlagen und -Einstellungen sowie benutzerdefinierte Domains samt Zertifikat und Verifizierung.

Wofür ist er besonders nützlich?

Der größte Nutzen liegt bei wiederkehrenden Administrationsaufgaben und bei der Fehlersuche. Wer Neueintritte, Rollenwechsel oder Austritte betreut, kann dem Assistenten die Schritte beschreiben, statt sie mehrfach in der Konsole auszuführen. Bei Support-Anfragen hilft der Zugriff auf die Systemprotokolle: Der Assistent filtert Anmeldeereignisse, fasst Auffälligkeiten zusammen und nennt mögliche Ursachen. Auch Aufräumarbeiten, etwa das Finden ungenutzter Gruppen oder das Prüfen, welche Anwendungen einer Gruppe zugewiesen sind, lassen sich so in einem Gespräch erledigen. Gegenüber einem reinen Skript bleibt der Ablauf flexibel, weil der Assistent Zwischenergebnisse liest und die nächste Abfrage darauf abstimmt.

Einrichtung und Konfiguration

Voraussetzung sind Python 3.13 oder neuer (oder Docker), das Werkzeug uv, ein MCP-Client wie Claude Desktop, Claude Code oder VS Code sowie ein Okta-Konto mit passenden Berechtigungen. Es gibt drei Installationswege: Docker (laut README empfohlen), uv aus dem Quellcode und das PyPI-Paket, das sich ohne Klonen per uvx okta-mcp-server starten lässt. Für die Anmeldung stehen zwei Verfahren bereit. Der interaktive Device Authorization Grant benötigt eine native OIDC-App mit aktiviertem Device-Authorization-Grant; die Anmeldung läuft im Browser, in Docker kopieren Sie die URL aus den Logs. Für Mandanten in einer privaten Cloud wird dieses Verfahren laut README nicht unterstützt. Das zweite Verfahren, Private Key JWT, kommt ohne Browser aus und nutzt eine „API Services“-App mit Schlüsselpaar; dafür muss DPoP deaktiviert sein, und es sind API-Scopes sowie Admin-Rollen zuzuweisen. Welche Werkzeuge der Server anbietet, richtet sich nach den in OKTA_SCOPES gesetzten Scopes.

Sicherheit: was Sie beachten sollten

Ein Identitätssystem ist ein besonders sensibles Ziel, deshalb lohnt sich Vorsicht. Laut README registriert der Server beim Start nur Werkzeuge, für die passende Scopes konfiguriert sind, und prüft jeden Aufruf zusätzlich zur Laufzeit. Destruktive Operationen wie Löschen oder Deaktivieren verlangen eine Bestätigung über die Elicitation-Funktion von MCP; Clients ohne Unterstützung erhalten stattdessen eine Bestätigungsanfrage im JSON-Format. Die README betont das Prinzip der minimalen Rechte: Vergeben Sie Schreib-Scopes (*.manage) nur, wenn Sie sie wirklich brauchen, und beginnen Sie mit Leserechten. Die Option OKTA_MCP_INCLUDE_RAW gibt Stack-Frames an den Client weiter und sollte nur gezielt zur Fehlersuche aktiviert werden. Beachten Sie außerdem, dass jeder Aufruf Ihr Rate-Limit der Management-API verbraucht. Rufen Sie nicht vertrauenswürdige Inhalte, etwa Benutzerprofilfelder, mit Bedacht ab, denn sie könnten den Assistenten zu unbeabsichtigten Aufrufen verleiten.

Kosten

Der MCP-Server selbst ist unter Apache-2.0 kostenlos. Voraussetzung ist eine Okta-Organisation. Laut Preisseite gibt es eine kostenlose Testphase und für Entwickler einen kostenlosen Integrator-Plan zum Ausprobieren von APIs und SDKs, der nur für Nicht-Produktivumgebungen gedacht ist und eine begrenzte Nutzerzahl hat. Für den produktiven Einsatz stehen kostenpflichtige Pläne für Mitarbeiter- und Kundenidentitäten zur Wahl. Aktuelle Konditionen finden Sie auf der offiziellen Preisseite von Okta.

Für wen lohnt sich der Okta MCP Server?

Er lohnt sich für Administratoren, Platform- und Security-Teams, die bereits Okta einsetzen und wiederkehrende Aufgaben oder Protokollanalysen im Gespräch erledigen wollen. Ohne Okta-Organisation bringt er nichts. Beginnen Sie mit einer Testorganisation und lesenden Scopes, bevor Sie Schreibrechte vergeben, und halten Sie die Bestätigungsabfragen für Löschen und Deaktivieren eingeschaltet.

Python 3.13 oder neuer (alternativ Docker) mit uv, ein MCP-Client wie Claude Code oder Cursor sowie eine Okta-Organisation mit einer OIDC-App (Device Authorization Grant) oder einer API-Services-App (Private Key JWT) und passenden Admin-Rollen.

Mit dem Okta MCP Server verwaltet ein KI-Assistent Benutzer, Gruppen und Anwendungen Ihrer Okta-Organisation und wertet Systemprotokolle aus. Dieser Ratgeber führt von den Voraussetzungen bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen Python 3.13 oder neuer mit uv (oder Docker), einen MCP-Client wie Claude Code oder Cursor und eine Okta-Organisation. Für erste Versuche nutzen Sie eine Test- oder Entwicklerorganisation, nicht Ihre Produktivumgebung.

App und Scopes vorbereiten

Für die interaktive Anmeldung legen Sie in Okta eine native OIDC-App mit aktiviertem Device-Authorization-Grant an. Für den Betrieb ohne Browser verwenden Sie stattdessen eine API-Services-App mit Schlüsselpaar, deaktiviertem DPoP sowie zugewiesenen API-Scopes und Admin-Rollen. Beginnen Sie mit lesenden Scopes; schreibende Scopes (*.manage) ergänzen Sie erst später.

Schritt 2: Im MCP-Client eintragen

In Claude Code lautet der Befehl claude mcp add okta -e OKTA_ORG_URL=<org-url> -e OKTA_CLIENT_ID=<client-id> -e OKTA_SCOPES=<scopes> -- uvx okta-mcp-server. Alternativ starten Sie den Server per Docker oder aus dem Quellcode, wie in der README beschrieben. Bei der ersten Anmeldung öffnet sich der Browser; in Docker kopieren Sie die URL aus den Logs.

claude mcp add okta -e OKTA_ORG_URL=<org-url> -e OKTA_CLIENT_ID=<client-id> -e OKTA_SCOPES=<scopes> -- uvx okta-mcp-server

Risiken begrenzen

Der Server registriert nur Werkzeuge, für die passende Scopes gesetzt sind. Halten Sie die Bestätigungsabfragen für Löschen und Deaktivieren eingeschaltet und vergeben Sie Schreibrechte so knapp wie möglich. Aktivieren Sie OKTA_MCP_INCLUDE_RAW nur zur gezielten Fehlersuche.

Schritt 3: Erste Abfragen

Beginnen Sie mit Leseaufgaben, etwa „Liste die Gruppen der Organisation auf“ oder „Zeige die Anmeldefehler der letzten 24 Stunden“. Änderungen wie das Anlegen eines Benutzers testen Sie zuerst in der Testorganisation.

Device Authorization Grant (interaktiv, Anmeldung im Browser) oder Private Key JWT über eine API-Services-App (ohne Browser).

Je nach konfigurierten Scopes lesender oder schreibender Zugriff auf Benutzer, Gruppen, Anwendungen, Richtlinien, Systemprotokolle, Marken, E-Mail-Vorlagen und Domains. Schreibende Scopes (*.manage) sollten nur bei Bedarf vergeben werden.

Der Server läuft lokal bei Ihnen und spricht mit der Okta-API. Abgerufene Benutzerdaten, Gruppen und Protokolleinträge gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Jeder Aufruf verbraucht Rate-Limits der Management-API.

Unbeabsichtigtes Löschen oder Deaktivieren von Benutzern, Gruppen und Anwendungen, Änderung von Richtlinien mit Folgen für alle Anmeldungen, zu weit gefasste Schreib-Scopes, Prompt Injection über Profil- oder Protokollinhalte sowie das Weitergeben von Stack-Frames bei aktiviertem OKTA_MCP_INCLUDE_RAW.