Entwickler-Ressourcen

Hosted MCP

Claude Desktop, Cursor, VS Code, Windsurf oder einen anderen MCP-Client über OAuth mit RunAPI verbinden.

Hosted MCP ist die empfohlene Methode zur Verwendung von RunAPI-Tools. Ihr MCP-Client verbindet sich direkt mit RunAPI, sodass Sie weder Node.js installieren noch einen lokalen Prozess am Laufen halten müssen.

Verwenden Sie diesen Endpunkt:

TEXT

https://mcp.runapi.ai/mcp

Wählen Sie Ihren MCP-Client unten aus. Wenn der Client RunAPI in Ihrem Browser öffnet, melden Sie sich an, wählen Sie das zu verwendende Konto aus und genehmigen Sie den Zugriff.

Claude Desktop

Öffnen Sie Settings > Connectors und fügen Sie einen benutzerdefinierten Connector hinzu.
Benennen Sie ihn RunAPI und geben Sie den obigen Endpunkt ein.
Wählen Sie Connect und schließen Sie die RunAPI-Autorisierung in Ihrem Browser ab.
Öffnen Sie in einem Gespräch + > Connectors und aktivieren Sie RunAPI.

Wenn RunAPI nicht in einem Gespräch erscheint, kehren Sie zu Einstellungen > Konnektoren zurück, verbinden Sie es erneut und bestätigen Sie, dass es für dieses Gespräch aktiviert ist.

Cursor

Fügen Sie RunAPI zu Ihrer Cursor-mcp.json hinzu, z. B. der projektbezogenen .cursor/mcp.json:

JSON

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

Öffnen Sie Customize in der Cursor-Seitenleiste, suchen Sie RunAPI, aktivieren Sie es und schließen Sie die Autorisierung in Ihrem Browser ab.

RunAPI sollte als verbunden angezeigt werden und seine Tools verfügbar machen. Bei Verbindungs- oder Authentifizierungsfehlern öffnen Sie den Ausgabe-Bereich und wählen Sie MCP Logs.

VS Code

Öffnen Sie die Befehlspalette und führen Sie MCP: Add Server aus.
Wählen Sie HTTP, geben Sie den obigen Endpunkt ein und benennen Sie den Server RunAPI.
Starten Sie den Server, vertrauen Sie ihm, wenn Sie dazu aufgefordert werden, und schließen Sie die Autorisierung in Ihrem Browser ab.

RunAPI-Tools sollten im Chat erscheinen. Bei Fehlern führen Sie MCP: List Servers aus, wählen Sie RunAPI und dann Show Output.

Windsurf

Diese Schritte gelten für den Cascade-Agenten. Devin Local verwendet die Devin CLI- Konfiguration.

Öffnen Sie Devin Settings > Cascade > MCP Servers und bearbeiten Sie die Rohdatei ~/.codeium/windsurf/mcp_config.json.
Fügen Sie RunAPI als Remote-HTTP-Server hinzu:

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

Speichern Sie die Datei, aktualisieren Sie die MCP-Server, aktivieren Sie RunAPI und schließen Sie die Autorisierung in Ihrem Browser ab.

Wenn die Tools nicht erscheinen, öffnen Sie die MCP-Einstellungen, bestätigen Sie, dass RunAPI aktiviert ist, und verbinden Sie es erneut.

Andere MCP-Clients

Fügen Sie den obigen Endpunkt als Streamable-HTTP-Server hinzu. Der Client muss Remote MCP und browserbasiertes OAuth unterstützen. Schließen Sie die Autorisierung ab, wenn Sie dazu aufgefordert werden, und aktivieren Sie dann die RunAPI-Tools im Client.

Verbindung überprüfen

Fragen Sie Ihren Client:

Welche RunAPI-Bildmodelle sind verfügbar?

Der Client sollte list_models aufrufen und verfügbare Bildmodelle zurückgeben. Das bestätigt, dass die Verbindung und der Tool-Aufruf funktionieren.

Stattdessen einen API-Schlüssel verwenden

OAuth ist der empfohlene Weg. Verwenden Sie einen dedizierten Standard-API-Schlüssel nur für einen unbeaufsichtigten Client oder wenn OAuth nicht verfügbar ist; folgen Sie dem Authentifizierungsleitfaden, um einen zu erstellen. Fügen Sie den Schlüssel niemals in die Endpunkt-URL ein oder committen Sie ihn in ein Repository.

Claude Desktop: Falls Request-Header für benutzerdefinierte Connectoren verfügbar sind, fügen Sie einen Authorization-Header mit dem Wert Bearer YOUR_API_KEY hinzu.
Cursor: Setzen Sie RUNAPI_API_KEY in der für die Cursor-Anwendung sichtbaren Umgebung und verwenden Sie dann Authorization: Bearer ${env:RUNAPI_API_KEY} in den Server-headers. Remote-Server lesen keine Cursor-envFile-Einstellungen.
VS Code: Referenzieren Sie ein passwortgeschütztes ${input:...} aus dem Authorization-Header des Servers, damit VS Code den Schlüssel abfragt und speichert, anstatt ihn in mcp.json zu schreiben.
Windsurf: Referenzieren Sie ${env:RUNAPI_API_KEY} oder ${file:...} aus dem Authorization-Header in ~/.codeium/windsurf/mcp_config.json.

Widerrufen Sie den Schlüssel über die API-Schlüssel-Seite, wenn der Client eingestellt wird oder der Schlüssel möglicherweise offengelegt wurde.

Fehlerbehebung

Die Autorisierung wurde nicht abgeschlossen: Verbinden Sie RunAPI erneut über den Client und schließen Sie den Browser-Flow erneut ab.
RunAPI ist verbunden, aber seine Tools fehlen: Vergewissern Sie sich, dass der Server aktiviert ist, entfernen Sie den genauen Endpunkt und fügen Sie ihn erneut hinzu, und starten Sie dann eine neue Unterhaltung.
Die Überprüfungsfrage schlägt fehl: Prüfen Sie das Client-Protokoll, das im entsprechenden Abschnitt beschrieben wird, und verbinden Sie RunAPI anschließend erneut, bevor Sie es erneut versuchen.

Benötigen Sie einen Client, der RunAPI auf Ihrem Rechner startet? Local MCP einrichten.