OpenRouter MCP: Einrichtung, Modellaufrufe und die tatsächlichen Abwägungen

Wer Modelle nicht nur nach Bauchgefühl auswählen will, bekommt mit OpenRouter MCP eine Recherche- und Testschicht direkt im Agenten: Preise, Benchmarks, Endpunkte und Dokumentation lassen sich live prüfen, bevor die Modellentscheidung fällt. Für den Produktivbetrieb ersetzt der gehostete Model-Context-Protocol-Server die OpenRouter API allerdings nicht.

Was OpenRouter MCP konkret verändert

Der offizielle Server ist unter https://mcp.openrouter.ai/mcp erreichbar. Kompatible Clients wie Claude Code, Cursor oder Claude Desktop verbinden sich per Remote-HTTP, sodass der Agent OpenRouter-Tools direkt im Gespräch aufrufen kann. Das eignet sich für Recherche und Tests im Katalog; in Anwendungen oder Provider-Konten bleiben die Produktions-API beziehungsweise ein Provider-eigenes MCP für die eigentlichen Aufgaben zuständig.

Die offizielle Ankündigung von OpenRouter nennt Live-Modellinformationen, Rankings, Preise, Dokumentation und Testinferenz. Maßgeblich für Endpunkt, Tools und Authentifizierungsverhalten ist die MCP-Dokumentation.

Erst den Ablauf definieren, dann den Server verbinden

In der Praxis bewährt sich der Ablauf finden, vergleichen, testen, prüfen. Damit wird aus „Welches Modell ist das beste?“ eine Entscheidung anhand klarer Anforderungen.

1. Finden: Fragen Sie nach Modellen, die zu Aufgabe, Preis, Kontext, Modalität oder Provider-Vorgabe passen. list-models und list-benchmarks liefern aktuelle Katalog- und Benchmarkdaten.
2. Vergleichen: Rufen Sie für jeden Kandidaten list-model-endpoints auf, um verfügbare Angaben zu Provider-Preis, Latenz, Durchsatz und Datenrichtlinien zu sehen.
3. Testen: Führen Sie denselben Prompt mit send-message und einem benannten Modell-Slug aus. Dafür können Inferenzkosten anfallen.
4. Prüfen: Übergeben Sie jede Generation-ID an get-generation, um Token-Anzahl, Kosten und bedienenden Provider abzurufen.

Diesen Prompt können Sie in Claude Code oder Cursor verwenden:

Verwende OpenRouter MCP, um drei Modelle für die Extraktion strukturierter Daten aus
Rechtsdokumenten zu finden. Anforderungen: mindestens 100k Kontext, Tool Calling und der
niedrigste verfügbare Eingabepreis. Vergleiche Provider und Datenrichtlinien. Verwende dann
send-message, um exakt diesen Prompt mit den zwei besten Kandidaten auszuführen:

"Extrahiere jedes Vertragsverlängerungsdatum aus dem untenstehenden Text. Gib ausschließlich JSON
mit einem Array namens renewals zurück; jedes Element soll party, date und evidence enthalten."

Verwende nach den Tests für jede Generation-ID get-generation und nenne die
tatsächlichen Kosten sowie den bedienenden Provider. Rufe kein Modell auf, bevor ich die
Kandidaten genehmige.

Die Freigabe vor dem Test ist sinnvoll, weil Katalogabfragen nur lesend arbeiten, während send-message Inferenzkosten verursachen kann. Für reproduzierbare Auswertungen sollten Modell und Provider explizit angegeben werden. Suffixe wie :free, :floor, :nitro und :online stehen, sofern verfügbar, für Routing-Präferenzen – nicht für feste Qualitätszusagen.

Den offiziellen Remote-Server einrichten

Eine lokale Installation ist nicht erforderlich. Fügen Sie den Remote-Endpunkt hinzu, schließen Sie den OAuth-Vorgang im Browser ab und autorisieren Sie einen dedizierten OpenRouter-Schlüssel, getrennt von Ihren anderen Schlüsseln. Standardmäßig gelten laut Dokumentation eine Laufzeit von 7 Tagen und ein Ausgabenlimit von $10; beides lässt sich im Freigabebildschirm anpassen. OpenRouter dokumentiert OAuth mit PKCE: Statt einen gewöhnlichen API-Schlüssel in die Client-Konfiguration einzutragen, autorisieren Sie im Browser.

Claude Code

Führen Sie Folgendes aus:

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

Der erste Befehl registriert den Remote-HTTP-Server, der zweite startet den OAuth-Ablauf. Auch über /mcp in einer Claude-Code-Sitzung lässt sich laut Claude Code MCP-Dokumentation der OpenRouter-Server auswählen und authentifizieren.

Testen Sie die Verbindung zunächst mit einer reinen Leseabfrage, etwa: „Verwende OpenRouter MCP, um zwei aktuelle Modelle mit mindestens 128k Kontext aufzulisten, und zeige ihre Eingabepreise.“

Cursor

Fügen Sie den Remote-Server zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Falls der Server nicht erscheint, laden Sie Cursor neu. Die Authentifizierung beginnt in den MCP-Einstellungen von Cursor oder beim ersten Tool-Aufruf. Die dokumentierte CLI heißt cursor-agent; prüfen Sie den Eintrag mit:

cursor-agent mcp list

Die MCP-Dokumentation von Cursor erläutert Konfigurationen auf Benutzer- und Projektebene. Legen Sie den Eintrag dort an, wo Sie ihn benötigen, und versionieren Sie keine persönliche Authentifizierungskonfiguration in einem gemeinsam genutzten Repository.

Claude Desktop und Claude Web

Falls OpenRouter nicht im Connector-Verzeichnis von Claude auftaucht, verweist der Verbindungsleitfaden von OpenRouter auf einen benutzerdefinierten Remote-Connector:

1. Öffnen Sie Settings > Connectors > Customize > Connectors.
2. Klicken Sie auf + und wählen Sie anschließend Add custom connector.
3. Vergeben Sie den Namen OpenRouter MCP.
4. Tragen Sie https://mcp.openrouter.ai/mcp als URL des Remote-MCP-Servers ein.
5. Lassen Sie die OAuth-Felder leer, fügen Sie den Connector hinzu, öffnen Sie ihn und klicken Sie auf Connect.
6. Schließen Sie die Browser-Freigabe bei OpenRouter ab.

Einige Organisationen deaktivieren benutzerdefinierte Connectoren. Fehlt die Option in einem verwalteten Account, wenden Sie sich an die Administration. Die MCP-Dokumentation von Anthropic erklärt die Protokollkonzepte auf Client-Seite.

Welche Aufgaben sich gefahrlos delegieren lassen

Die meisten offiziellen Tools von OpenRouter MCP sind Live-Abfragen. Praktischer als die vollständige Tool-Liste auswendig zu lernen, ist eine Einteilung nach Nebenwirkung.

Für die Auswahl sollte die Entscheidungsregel ausdrücklich formuliert sein: „Finde das günstigste Modell mit Tool Calling und einem Kontextfenster von 64k und zeige anschließend den schnellsten verfügbaren Endpunkt.“ Dokumentierte Filter umfassen Preis, Mindestkontext, Modellfamilie, Autor, Provider, Modalität, unterstützte Parameter, Benchmark-Bereiche, Erfolgsquote beim Tool Calling, Verfügbarkeit von Zero Data Retention und Region.

Für einen kontrollierten Modelltest benennen Sie den Slug und machen den Prompt reproduzierbar:

Verwende OpenRouter MCP send-message mit dem Modell "openai/gpt-4o".
Sende exakt diese Nutzernachricht und füge keinen System-Prompt hinzu:

"Gib ein JSON-Objekt mit den Schlüsseln title und risks zurück. Analysiere diese Release-Note:
[Text hier einfügen]"

Zeige mir die Antwort und die Generation-ID. Führe kein weiteres Modell aus.

Der Slug dient nur als Beispiel; verwenden Sie einen, dessen Verfügbarkeit list-models bestätigt. Für nachvollziehbare Vergleiche sollten Sie die Abfrage-Tools, Rückgabewerte und eine Generation-ID ausdrücklich verlangen, statt eine nicht belegte Modellempfehlung zu akzeptieren.

OpenRouter MCP oder offizielles Provider-MCP?

OpenRouter MCP ist eine providerübergreifende Ebene für Recherche und Tests. Ein offizielles Provider-MCP passt meist besser, wenn die Aktion zum Produkt, Account oder zur Datenebene dieses Providers gehört.

OpenRouter MCP ist die richtige Wahl für die Frage: „Welches Modell oder Routing sollte ich nutzen?“ Ein First-Party-Provider-MCP passt zur Frage: „Was kann ich innerhalb des Dienstes dieses Providers tun?“ Wenn beide Fähigkeiten benötigt werden, können sie mit demselben Agenten verbunden werden.

Community-entwickelte lokale oder multimodale MCP-Server bilden eine eigene Kategorie. Die Works With OpenRouter page beschreibt einen Server für mehrere Clients sowie Text-, Bild-, Audio- und Video-Workflows. Er benötigt einen OpenRouter-API-Schlüssel und Guthaben und ist nicht mit dem offiziellen gehosteten Dienst unter mcp.openrouter.ai gleichzusetzen.

Die wichtigen Grenzen im Projektalltag

„@OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰“ — @CodewithP, X, über einen Anwendungsfall zur Abfrage von Modellinformationen.

Das MCP cookbook von OpenRouter behandelt auch die umgekehrte Richtung: OpenRouter-Modelle als LLM-Backend für andere MCP-Tool-Server einzusetzen, statt einen Coding-Client mit OpenRouter MCP zu verbinden.

Wenn der erste Aufruf fehlschlägt

1. Der Server erscheint, aber die Tools schlagen bei der Authentifizierung fehl. Starten Sie den client-spezifischen OAuth-Schritt erneut. Der dedizierte Schlüssel hat eine dokumentierte Laufzeit von 7 Tagen und kann auch über das OpenRouter-Dashboard getrennt werden.
2. Es öffnet sich kein Browserfenster. Verwenden Sie claude mcp login openrouter, die Aktion /mcp von Claude Code, die MCP-Einstellungen von Cursor oder die Schaltfläche Connect des Claude-Connectors.
3. Claude Desktop bietet keine Option für benutzerdefinierte Connectoren. Prüfen Sie, ob die Administration Ihrer Organisation benutzerdefinierte Connectoren deaktiviert hat.
4. Eine Modellantwort wirkt veraltet. Fordern Sie explizit list-models, list-benchmarks oder list-model-endpoints an und lassen Sie sich die Rückgabewerte ausgeben.
5. Ein Test kostet mehr oder wird anders geroutet als erwartet. Prüfen Sie seine Generation-ID mit get-generation und legen Sie für den nächsten reproduzierbaren Durchlauf einen konkreten Provider fest.

FAQ

Kann OpenRouter MCP jedes OpenRouter-Modell aufrufen?

Es kann Modell-Slugs aus dem Live-Katalog testen, vorbehaltlich Verfügbarkeit, Fähigkeiten, Guthaben und Routing-Einschränkungen. Prüfen Sie den Slug vorher mit list-models.

Kann ich OpenRouter MCP gleichzeitig mit Claude Desktop, Cursor und Claude Code verwenden?

Sie können denselben offiziellen Endpunkt in jedem Client hinzufügen und dabei die jeweils dokumentierte Konfiguration und Authentifizierung verwenden. Gemeinsame Konfigurationen sollten keine persönlichen Zugangsdaten enthalten.

Sollte ich stattdessen ein Community-Paket namens openrouter-mcp installieren?

Nur wenn Sie einen lokalen stdio-Workflow oder multimodale Orchestrierung benötigen, die der offizielle gehostete Server nicht anbietet. Prüfen Sie zuvor Repository, Umgang mit Zugangsdaten, Paketquelle und Wartungsstatus.

Beginnen Sie mit einer schreibgeschützten Katalogabfrage. Einen kontrollierten Inferenzaufruf sollten Sie erst autorisieren, wenn Modell, Routing und Ausgabengrenze eindeutig feststehen.