Clerk MCP Server

Offizieller gehosteter MCP-Server von Clerk: SDK-Snippets und Auth-Implementierungsmuster für KI-Agenten in der Entwicklung.

Beschreibung

Der Clerk MCP Server ist ein offizieller, von Clerk gehosteter Model-Context-Protocol-Server, der laut Anbieter KI-Agenten wie Claude, Cursor und GitHub Copilot mit aktuellen Clerk-SDK-Snippets und Implementierungsmustern versorgt. Er liefert keine generische Benutzerverwaltung im laufenden Betrieb, sondern richtet sich an Entwicklerinnen und Entwickler, die mit Clerk-Bibliotheken Code schreiben. Der Server gibt Antworten auf Fragen wie: „Welches Hook verwende ich, um einen eingeloggten Nutzer in React abzufragen?" oder „Wie schütze ich eine Route in Next.js mit Clerk?".

Der Server befindet sich laut Clerk-Dokumentation derzeit im Beta-Stadium. Funktionalität kann sich vor der allgemeinen Verfügbarkeit noch ändern.

Offizielles Produkt, Repository und Einordnung

Die primäre Dokumentation des Clerk MCP Servers ist unter clerk.com/docs/guides/ai/mcp/clerk-mcp-server erreichbar. Das GitHub-Repository clerk/mcp-tools enthält den Quellcode für Clerk-eigene MCP-Werkzeuge und -Integrationen – darunter Bibliotheksfunktionen für Client- und Server-seitige MCP-Implementierungen mit Clerk-Auth. Unmittelbar vor dem Erstellen dieses Eintrags am 8. September 2026 meldete die GitHub-API genau 48 Sterne für das mcp-tools-Repository. Diese Zahl bezieht sich auf das Gesamt-Repository, das sowohl den gehosteten Server als auch die Bibliothek für eigene MCP-Integrationen umfasst. Sterne sind ein momentanes Popularitätssignal, kein Qualitäts- oder Sicherheitsnachweis.

Der eigentliche Endpunkt des gehosteten Servers lautet https://mcp.clerk.com/mcp und unterstützt ausschließlich Streamable HTTP Transport – SSE wird laut offizielle FAQ nicht unterstützt. Das bedeutet: Ein Client muss Streamable HTTP sprechen können; ältere SSE-only-Clients können diesen Server nicht nutzen.

Verfügbare Werkzeuge und Anwendungsbereich

Der Clerk MCP Server stellt laut Dokumentation zwei Werkzeuge bereit:

clerk_sdk_snippet – Gibt SDK-Code-Schnipsel und Muster für konkrete Clerk-Features zurück, etwa für useUser, currentUser, Middleware, Organizations oder benutzerdefinierte Flows.

list_clerk_sdk_snippets – Listet alle verfügbaren Schnipsel und Bundle-Gruppen auf.

Diese Werkzeuge sind für die Entwicklungsphase gedacht, nicht für den Produktionsbetrieb. Sie helfen dabei, Integrationsmuster korrekt anzuwenden, und reduzieren veraltete oder fehlerhafte Code-Vorschläge eines KI-Modells, das ohne diese Quelle auf Trainingsdaten zurückgreifen müsste.

Verfügbare Snippet-Bundles

Laut Clerk-Dokumentation stehen folgende Bundles für umfassende Implementierungen bereit: b2b-saas (vollständiges B2B-SaaS-Setup mit Organizations, Billing und rollenbasiertem Zugriff), waitlist (Waitlist- und Early-Access-Flows), auth-basics (Core-Authentication-Hooks), custom-flows (individuelle Sign-in/Sign-up-Flows), organizations (Mandanten-Verwaltung) sowie server-side (serverseitige Auth-Muster).

Einrichtung: Clerk CLI oder manuelle Konfiguration

Der schnellste Weg ist der Clerk CLI-Befehl clerk mcp install. Dieser erkennt unterstützte KI-Clients automatisch und trägt den Server in deren Konfiguration ein, damit er projektübergreifend verfügbar ist. Für Claude Code lautet der direkte Befehl: claude mcp add clerk --transport http https://mcp.clerk.com/mcp. Nach der Installation sollte der Client neu gestartet werden.

Für Clients, die die CLI nicht unterstützen, ist eine manuelle Konfiguration über eine MCP-JSON-Datei möglich. Die Dokumentation deckt Claude Code, Claude Desktop, Cursor, Codex, VSCode, Windsurf und Zed ab.

Sicherheit, Grenzen und SDK-Versionen

Der Clerk MCP Server sendet Code-Schnipsel an den verbundenen KI-Client, der diese Informationen abhängig von seiner Architektur an einen Modellanbieter weiterleitet. Da es sich um einen Remote-Server unter Clerk-Kontrolle handelt, passiert der Datenfluss das Netzwerk. Folgende Punkte verdienen Aufmerksamkeit:

SDK-Versionen: Die bereitgestellten Snippets richten sich nach dem aktuellen Clerk SDK. Wer eine ältere SDK-Version nutzt, sollte Muster immer gegen die eigene installierte Version prüfen. KI-Agenten können Snippets unkritisch anwenden, obwohl eine API sich zwischen Versionen geändert hat.

Modellpfad: Ergebnisse dieses Servers werden an den KI-Client übergeben und können im Prompt oder im Kontext des Modells landen. Clerk-Snippets selbst enthalten keine Secrets, aber der Kontext einer Entwicklersitzung kann sensible Informationen umfassen, die zusammen mit Tool-Ergebnissen verarbeitet werden. Datarichtlinien des eigenen Clients und Modellanbieters separat prüfen.

Untrusted Input: Inhalte aus fremden Repositories, Issue-Kommentaren oder Websites, die ein Agent parallel verarbeitet, können die Interpretation von Clerk-Snippets beeinflussen (Prompt-Injection-Risiko). Der Clerk MCP Server selbst ist eine kontrollierte Quelle, aber er kann nicht steuern, welche anderen Quellen ein Agent gleichzeitig liest.

Beta-Status: Da der Server im Beta-Stadium ist, können sich Tool-Namen, Bundle-Bezeichnungen oder der Endpunkt ohne Vorankündigung ändern.

Häufige Fragen (FAQ)

Wann sollte ich den Clerk MCP Server nutzen? Laut Clerk empfiehlt der Anbieter ihn für alle, die aktiv mit Clerk entwickeln, damit KI-Agenten stets aktuelle Patterns statt veralteter Trainingsdaten verwenden.

Warum erscheint ein interner Serverfehler? Meist deutet das laut FAQ auf ein Netzwerk- oder Transport-Problem hin. Server trennen, neu verbinden und sicherstellen, dass der Client Streamable HTTP unterstützt.

Unterstützt der Server SSE? Nein. Nur Streamable HTTP ist verfügbar (https://mcp.clerk.com/mcp).

Voraussetzungen

Ein MCP-fähiger Client mit Streamable-HTTP-Unterstützung (z. B. Claude Code, Cursor, Codex); für den schnellsten Einstieg optional die Clerk CLI.

Installationsanleitung

Zweck und Abgrenzung

Der Clerk MCP Server ist ein gehosteter Entwicklungsassistent, der aktuelle Clerk-SDK-Snippets und Implementierungsmuster für KI-Agenten bereitstellt. Er hilft dabei, Fragen wie „Wie schütze ich eine Route in Next.js mit Clerk?" oder „Wie implementiere ich ein B2B-SaaS-Setup mit Organizations?" direkt im Agenten zu beantworten – auf Basis aktueller Clerk-Dokumentation, nicht veralteter Trainingsdaten. Er liefert keine Laufzeit-Nutzerverwaltung und hat keinen Zugriff auf Clerk-Konten oder produktive Daten.

Der Server befindet sich im Beta-Stadium. Tool-Namen, Bundle-Bezeichnungen und der Endpunkt können sich vor der allgemeinen Verfügbarkeit ändern.

Schritt 1: Voraussetzungen

Benötigt wird ein MCP-kompatibler Client, der Streamable HTTP unterstützt: Claude Code, Cursor, Codex, VSCode, Windsurf oder Zed. Der Server-Endpunkt ist https://mcp.clerk.com/mcp. Ältere SSE-only-Clients können diesen Server laut Clerk-FAQ nicht nutzen. Kein Clerk-Account oder API-Key ist für die Verbindung erforderlich; der Server ist ohne Authentifizierung zugänglich.

Optional: die Clerk CLI, die unterstützte Clients automatisch erkennt und konfiguriert.

Schritt 2: Einrichtung mit dem Clerk CLI

Der einfachste Weg ist der automatische Setup-Befehl:

bash
clerk mcp install

Der CLI erkennt alle unterstützten Clients auf dem Rechner und fragt, in welchen er den Server eintragen soll. Die Verbindung wird in der benutzerspezifischen Konfiguration gespeichert, sodass der Server in jedem Projekt des gewählten Clients verfügbar ist.

Nützliche Variationen:

bash
# Direkt bestimmte Clients auswählen, ohne Abfrage
clerk mcp install --client claude --client cursor
clerk mcp install --all

# Alle eingetragenen Clerk-MCP-Einträge anzeigen
clerk mcp list

# Eintrag entfernen
clerk mcp uninstall

# Erreichbarkeit des Servers prüfen
clerk doctor

Nach dem Eintragen den Client vollständig neu starten.

Schritt 3: Manuelle Einrichtung in Claude Code

bash
claude mcp add clerk --transport http https://mcp.clerk.com/mcp

Nach Ausführung des Befehls /mcp in einer Claude-Code-Sitzung eingeben, um die Verbindung zu bestätigen. Der Server sollte als aktiv erscheinen und die Werkzeuge clerk_sdk_snippet und list_clerk_sdk_snippets listen.

Schritt 4: Manuelle Einrichtung in Cursor, Claude Desktop und anderen Clients

In der MCP-JSON-Konfiguration des Clients (meist ~/.cursor/mcp.json, ~/Library/Application Support/Claude/claude_desktop_config.json oder .vscode/mcp.json) folgenden Block hinzufügen:

json
{
  "mcpServers": {
    "clerk": {
      "type": "http",
      "url": "https://mcp.clerk.com/mcp"
    }
  }
}

Für Clients ohne nativen HTTP-MCP-Support kann eine mcp-remote-Bridge als Zwischenschicht verwendet werden. Die Clerk-Dokumentation beschreibt dies für jeden Client separat.

Schritt 5: Verfügbare Werkzeuge und Snippet-Bundles testen

Nach der Verbindung eine neue Unterhaltung starten und zunächst alle verfügbaren Snippets auflisten lassen:

> „Liste alle verfügbaren Clerk-Snippet-Bundles."

Dann ein konkretes Thema abfragen:

> „Zeige mir, wie ich die useUser-Hook in React verwende."
> „Wie richte ich B2B-SaaS mit Clerk Organizations ein?"
> „Wie schütze ich Routen in Next.js mit Clerk-Middleware?"

Die folgenden Bundles stehen laut Dokumentation bereit: b2b-saas, waitlist, auth-basics, custom-flows, organizations, server-side. Ein Bundle kann mit einer Frage wie „Zeige mir das auth-basics-Bundle" vollständig abgerufen werden.

Sicherheitshinweise für Entwicklungssitzungen

SDK-Versionen prüfen: Snippets richten sich nach dem aktuellen Clerk SDK. Wer eine ältere Version nutzt, sollte Muster gegen die eigene package.json-Version abgleichen. Ein Agent kann ein Snippet direkt anwenden, ohne auf eine Versionsabweichung hinzuweisen.

Datenpfad beachten: Der Remote-Server verarbeitet Aufrufe auf Clerk-Infrastruktur. Ergebnisse gehen an den KI-Client und können zum Modellanbieter weitergeleitet werden. Keine sensiblen Sitzungsinhalte (z. B. Produktionsvariablen) zusammen mit Clerk-Snippet-Abfragen im selben Kontext nutzen.

Beta-Verhalten: Falls ein Werkzeug oder Bundle nicht mehr verfügbar ist, die offizielle Clerk-Dokumentation konsultieren und den Server-Verbindungsstatus mit clerk doctor prüfen. Verbindungsprobleme deuten laut FAQ meist auf Transport- oder Netzwerkprobleme hin.

Prompt-Injection: Wenn ein Agent gleichzeitig externe Quellen (Repositories, Websites, Issues) liest, können diese Inhalte die Interpretation von Clerk-Snippets beeinflussen. Den Kontext auf das Wesentliche beschränken.

FAQ

Muss ich einen Clerk-Account haben, um den Server zu nutzen? Nein. Der Endpunkt ist ohne Account oder API-Key erreichbar. Die bereitgestellten Snippets beziehen sich auf die öffentliche Clerk SDK-Dokumentation.

Warum sehe ich einen internen Serverfehler? Laut Clerk-FAQ deutet das auf ein Netzwerk- oder Transportproblem hin. Server trennen, neu verbinden und sicherstellen, dass der Client Streamable HTTP unterstützt – SSE wird nicht unterstützt.

Wie häufig werden die Snippets aktualisiert? Clerk aktualisiert den Server bei SDK-Änderungen. Beta-Status bedeutet, dass sich dies noch entwickeln kann.

clerk mcp install

Authentifizierung

Der Endpunkt https://mcp.clerk.com/mcp ist ohne API-Key über Streamable HTTP erreichbar. Die verwendeten Snippet-Tools setzen kein Clerk-Konto voraus.

Benötigte Zugriffsrechte

Der Server liefert nur lesende SDK-Informationen. Er hat keinen Zugriff auf Clerk-Konten, Nutzer-Daten oder produktive Systeme.

Übertragene oder gespeicherte Daten

Clerk verarbeitet Werkzeugaufrufe auf seinen Servern und gibt Snippet-Texte zurück. Der verbundene KI-Client kann diese Inhalte an seinen Modellanbieter senden; dessen Datenschutzrichtlinie separat prüfen.

Sicherheitsrisiken

SDK-Snippets können auf eine andere Clerk-Version passen als die installierte. Beta-Status bedeutet mögliche Breaking Changes. Ergebnisse können neben untrusted content aus anderen Quellen im Kontext des Agents landen (Prompt-Injection-Risiko). Datenpfad über Netzwerk und Modellanbieter beachten.

Lizenz und Kosten

Lizenz
MIT
Kosten
kostenlos

Der gehostete Server ist laut Anbieter kostenlos nutzbar. Aktuelle Clerk-Plan-Konditionen unter clerk.com prüfen; dieser Eintrag enthält keine Preisangaben.

Alternativen

Noch nicht erfasst.

Auf einen Blick

Anbieter
Clerk
Status
Offizieller Server
Betriebsart
Remote
Aktuelle Version
beta
GitHub-Sterne
53
Zuletzt geprüft
08.09.2026

Repository und Dokumentation

Kategorien

Unterstützte Clients