Clerk MCP Server einrichten

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.

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.

Einrichtung mit dem Clerk CLI

Der einfachste Weg ist der automatische Setup-Befehl:

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:

# 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.

Manuelle Einrichtung in Claude Code

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.

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:

{
  "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.

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.