WorkOS MCP Server

Der WorkOS MCP Server verbindet einen KI-Assistenten mit Ihrem WorkOS-Workspace. WorkOS ist eine Plattform, mit der Softwareteams Anmeldung, Single Sign-on (SSO), Verzeichnissynchronisation und Audit-Protokolle in ihre Produkte einbauen, damit diese für Unternehmenskunden tauglich werden. Der Server nimmt Ihnen die Arbeit im Dashboard ab: Statt sich durch Menüs zu klicken, beschreiben Sie im Chat oder im Editor, was Sie brauchen, etwa eine Einladung versenden, eine fehlerhafte SSO-Verbindung untersuchen oder eine neue Organisation samt Nutzern anlegen. Betrieben wird der Server von WorkOS selbst; laut Anbieter wurde er im Juli 2026 als Verwaltungsschnittstelle für KI-Agenten vorgestellt.

Was ist der WorkOS MCP Server?

MCP, das Model Context Protocol, ist ein offener Standard, über den KI-Assistenten Werkzeuge externer Dienste aufrufen können. Der WorkOS-Server ist ein gehosteter Remote-Server unter https://mcp.workos.com/mcp, der per Streamable HTTP erreichbar ist. Sie installieren und betreiben nichts lokal. Bei der ersten Verbindung öffnet sich ein Zustimmungsbildschirm von WorkOS; die Anmeldung läuft über OAuth mit WorkOS Connect. Danach handelt der Agent mit Ihrem Konto und genau den Rechten, die Ihre Rolle im Dashboard hat.

Wie arbeitet der Server?

Laut dem Blogbeitrag des Anbieters deckt der Server hunderte Operationen ab, darunter Organisationen, SSO-Verbindungen, Verzeichnissynchronisation, AuthKit-Nutzer und Sitzungen, Rollen, Audit-Logs, Webhooks und Branding. Statt für jede Schnittstelle ein eigenes Werkzeug anzubieten, gibt es nur vier: whoami, list_operations, query und mutate. Der Agent sucht zuerst die passende Operation und führt sie dann aus. Das hält das Kontextfenster des Sprachmodells schlank, weil nicht hunderte Werkzeugbeschreibungen mitgeladen werden müssen.

Wofür ist er besonders nützlich?

Der größte Nutzen liegt im Support und in der Einrichtung. Als Beispiel nennt der Anbieter einen Supportfall: Der Agent findet eine SAML-Verbindung, deren Metadaten-Adresse einen 404-Fehler liefert, prüft die fehlgeschlagenen Anmeldungen und erzeugt einen Admin-Portal-Link für die IT-Abteilung des Kunden. Weitere Einsatzideen sind das Gestalten der Anmeldeseite anhand eines Screenshots, das Finden unvollständiger SSO-Einrichtungen oder das Konfigurieren von Audit-Log-Streams. Gegenüber der WorkOS-Kommandozeile, die lokal neben dem Code läuft, braucht der MCP-Server keine Installation und funktioniert auf jedem Gerät, etwa für Bots oder Agenten, die Tickets bearbeiten.

Einrichtung

Die Dokumentation beschreibt die Einrichtung für zahlreiche Clients. In Claude Code genügt claude mcp add --transport http workos https://mcp.workos.com/mcp, danach bestätigen Sie die Anmeldung im Browser; mit /mcp prüfen Sie den Status. In Cursor tragen Sie die Adresse in mcp.json ein, in Codex nutzen Sie codex mcp add workos --url https://mcp.workos.com/mcp und anschließend codex mcp login workos. Auch VS Code, Zed, Goose, OpenCode, Factory, Antigravity und Claude Desktop werden genannt. Bei ChatGPT wird für eigene Connectoren ein passender Tarif vorausgesetzt.

Berechtigungen und Sicherheit

Der Agent erbt exakt Ihre Dashboard-Rechte und kann nicht mehr. Standardmäßig arbeitet er in der Sandbox-Umgebung, Produktion nur auf ausdrückliche Anweisung. Geheimnisse wie API-Schlüssel und Client-Secrets werden aus den Antworten entfernt, bevor sie den Kontext des Agenten erreichen. Unumkehrbare Löschvorgänge verlangen laut Anbieter eine ausdrückliche Bestätigung nach einer Beschreibung der Folgen. Nicht möglich sind unter anderem das Erzeugen oder Rotieren von Schlüsseln, die Nachahmung von Nutzern, Abrechnung und das Löschen des Teams. Team-Admins können den Zugriff in den Einstellungen mit drei Schaltern steuern: MCP insgesamt, Produktionszugriff und Schreibzugriff.

Kosten

Der Server setzt einen WorkOS-Account voraus. Laut Preisseite gibt es einen kostenlosen Einstieg für die Benutzerverwaltung AuthKit, nutzungsbasierte Preise für Produkte wie SSO und Verzeichnissynchronisation sowie individuelle Enterprise-Verträge. Ob für den MCP-Zugang eine bestimmte Stufe nötig ist, nennt die Dokumentation nicht; Details finden Sie auf der offiziellen Preisseite von WorkOS.

Für wen lohnt sich der WorkOS MCP Server?

Er lohnt sich für Teams, die WorkOS bereits einsetzen und wiederkehrende Aufgaben wie Kundeneinrichtung, SSO-Fehlersuche und Nutzerverwaltung lieber im Gespräch mit einem Assistenten erledigen. Wer WorkOS nicht nutzt, hat davon nichts, denn der Server ist keine eigenständige Anmeldelösung. Empfehlenswert ist, zunächst nur Lesezugriff und die Sandbox freizugeben und Schreibrechte erst nach ersten Tests zu erteilen.

Ein WorkOS-Konto mit Dashboard-Rolle, ein MCP-Client mit Unterstützung für Remote-Server (Streamable HTTP) und ein vom Team-Admin freigegebener MCP-Zugriff.

Mit dem WorkOS MCP Server verwaltet ein KI-Assistent Ihren WorkOS-Workspace. Dieser Ratgeber führt von der Einrichtung bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen ein WorkOS-Konto mit einer Dashboard-Rolle und einen MCP-Client mit Unterstützung für Remote-Server. Lokal ist nichts zu installieren, denn der Server wird von WorkOS gehostet. Ein Team-Admin muss den MCP-Zugriff in den Authentifizierungseinstellungen des Teams freigegeben haben; laut Dokumentation ist er standardmäßig aktiv.

Schritt 2: Server in Claude Code eintragen

Die Adresse lautet https://mcp.workos.com/mcp, der Transport ist Streamable HTTP. In Claude Code genügt der Befehl claude mcp add --transport http workos https://mcp.workos.com/mcp. Mit /mcp prüfen Sie den Status oder melden sich neu an.

claude mcp add --transport http workos https://mcp.workos.com/mcp

Schritt 3: Andere Clients

In Cursor tragen Sie in ~/.cursor/mcp.json oder .cursor/mcp.json unter mcpServers einen Eintrag workos mit der Adresse als url ein und klicken dann in den Einstellungen auf Login. In Codex führen Sie codex mcp add workos --url https://mcp.workos.com/mcp und danach codex mcp login workos aus; starten Sie die Sitzung nach der Zustimmung neu. In VS Code nutzen Sie .vscode/mcp.json mit dem Typ http.

codex mcp add workos --url https://mcp.workos.com/mcp
codex mcp login workos

Zustimmen

Beim ersten Verbinden öffnet sich ein Zustimmungsbildschirm von WorkOS. Melden Sie sich an und geben Sie den Zugriff frei. Der Agent handelt danach mit Ihrem Konto und genau den Rechten Ihrer Dashboard-Rolle.

Schritt 4: Erste Anfragen

Beginnen Sie lesend, zum Beispiel mit „Welche Organisationen gibt es in meiner Sandbox?“. Der Server bietet laut Anbieter vier Werkzeuge: whoami, list_operations, query und mutate. Sie müssen sie nicht beim Namen nennen; der Agent sucht die passende Operation selbst.

Sandbox und Produktion

Standardmäßig arbeitet der Agent in der Sandbox. Produktion erreicht er nur auf ausdrückliche Anweisung und nur, wenn der Team-Admin den Produktionszugriff erlaubt hat. Testen Sie Änderungen zuerst in der Sandbox.

Rechte begrenzen

Team-Admins können in den Einstellungen MCP insgesamt, den Produktionszugriff und den Schreibzugriff getrennt ein- oder ausschalten. Wer anfangs nur lesen möchte, schaltet den Schreibzugriff aus. Löschvorgänge verlangen laut Anbieter eine ausdrückliche Bestätigung.

OAuth über WorkOS Connect: Beim ersten Verbinden erscheint ein Zustimmungsbildschirm, auf dem Sie sich anmelden und den Zugriff freigeben. Der Agent handelt danach als Ihr Konto.

Zugriff auf Organisationen, Verbindungen, Nutzer, Rollen, Audit-Logs und Branding des WorkOS-Teams im Rahmen der Dashboard-Rechte der angemeldeten Person. Team-Admins können Produktionszugriff und Schreibzugriff separat abschalten.

Der Server läuft gehostet bei WorkOS. Geheimnisse wie API-Schlüssel werden laut Anbieter aus Antworten entfernt; abgerufene Nutzer- und Konfigurationsdaten gelangen aber in den Kontext des KI-Clients und damit zum Modellanbieter.

Ungewollte Änderungen an Anmelde- und SSO-Einstellungen oder Löschungen, besonders bei automatisch bestätigten Aufrufen und freigegebenem Produktionszugriff, sowie Weitergabe personenbezogener Nutzerdaten an den Modellanbieter.