Zum Inhalt springen
Entwickler-Ressourcen
Entwickler-Ressourcen

Local MCP

Den RunAPI MCP Server lokal mit Claude Code, Cursor, VS Code, Windsurf oder einem anderen stdio-Client ausführen.

Markdown anzeigen

Local MCP ermöglicht es Ihrem MCP-Client, den RunAPI MCP Server auf Ihrem Rechner zu starten. Verwenden Sie es, wenn der Client Remote MCP nicht unterstützt oder Sie explizit einen lokalen Prozess benötigen.

Bevor Sie starten

Node.js installieren und bestätigen, dass npx verfügbar ist. Ihr MCP-Client muss lokale stdio-Server unterstützen.

Jeder der folgenden Clients startet denselben Befehl:

SHELL 
npx -y @runapi.ai/mcp

Sie können Katalog-Tools verbinden und verwenden, ohne sich anzumelden.

Claude Code

Ausführen:

SHELL 
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

Verwende -s user, um RunAPI projektübergreifend verfügbar zu machen. Starte Claude Code neu, falls es bereits lief, und bestätige anschließend, dass RunAPI als MCP-Server aufgeführt ist.

Cursor

Fügen Sie den Server unter mcpServers in .cursor/mcp.json oder Ihrer Benutzer-MCP-Konfiguration hinzu:

JSON 
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

Öffnen Sie Customize in der Cursor-Seitenleiste, suchen Sie RunAPI und aktivieren Sie es. Wenn der Prozess nicht startet, öffnen Sie das Output-Panel und wählen Sie MCP Logs.

VS Code

  1. Öffnen Sie die Befehlspalette und führen Sie MCP: Add Server aus.
  2. Wählen Sie Command (stdio) und geben Sie npx -y @runapi.ai/mcp ein.
  3. Benennen Sie den Server RunAPI, wählen Sie seinen Konfigurationsbereich und starten Sie ihn.
  4. Vertrauen Sie dem Server, wenn Sie dazu aufgefordert werden. Bei Fehlern führen Sie MCP: List Servers aus, wählen Sie RunAPI und klicken Sie auf Show Output.

VS Code speichert die manuelle Konfiguration unter dem obersten Schlüssel servers und verwendet type: "stdio".

Windsurf

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

  1. Öffnen Sie Devin Settings > Cascade > MCP Servers.
  2. Öffnen Sie die MCP-Konfigurationsdatei unter ~/.codeium/windsurf/mcp_config.json.
  3. Fügen Sie RunAPI mit dem npx-Befehl und den Argumenten hinzu, die im Cursor-Beispiel oben gezeigt werden.
  4. Speichern Sie die Datei, aktualisieren Sie die MCP-Server und aktivieren Sie RunAPI.

Andere MCP-Clients

Fügen Sie einen lokalen stdio-Server namens RunAPI hinzu. Setzen Sie seinen Befehl auf npx und seine Argumente auf -y und @runapi.ai/mcp. Starten oder aktualisieren Sie den Client nach dem Speichern der Konfiguration.

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. Dieses öffentliche Erkennungs-Tool erfordert keine Authentifizierung.

Bei Bedarf anmelden

Discovery-Tools weiterhin ohne Anmeldung verwenden. Wenn Sie RunAPI zum ersten Mal auffordern, einen Task zu erstellen, einen Task abzurufen oder ein Guthaben zu prüfen, lassen Sie den Client das login-Tool aufrufen. Es öffnet RunAPI in Ihrem Browser und speichert die Berechtigung in der gemeinsamen lokalen Konfiguration.

Wenn Sie sich lieber über ein Terminal anmelden möchten, installieren Sie die RunAPI CLI und führen Sie aus:

SHELL 
runapi login

Folgen Sie für headless- oder CI-Clients dem Authentifizierungsleitfaden, um einen dedizierten Standard-API-Schlüssel zu erstellen, und stellen Sie ihn dann als RUNAPI_API_KEY über die Umgebung des Clients oder die Secret-Konfiguration bereit. Ein Umgebungsschlüssel hat Vorrang vor den durch Local MCP Login gespeicherten Anmeldedaten.

Fehlerbehebung

  • npx wird nicht gefunden: Vergewissern Sie sich, dass node --version und npx --version funktionieren, und starten Sie den MCP-Client vollständig neu, damit er die aktualisierte Umgebung erhält.
  • Der lokale Server beendet sich sofort: Führen Sie npx -y @runapi.ai/mcp in einem Terminal aus, beheben Sie den gemeldeten Node.js- oder Paketfehler und starten Sie den Client neu.
  • RunAPI-Tools erscheinen nicht: Vergewissern Sie sich, dass der Server aktiviert ist und der Befehl stdio verwendet, und prüfen Sie dann das oben beschriebene Client-Protokoll.
  • Ein authentifiziertes Tool schlägt fehl: Fordern Sie den Client auf, das login-Tool aufzurufen. Wenn RUNAPI_API_KEY gesetzt ist, aktualisieren oder entfernen Sie ihn, bevor Sie Local MCP Login erneut versuchen.

Bevorzugen Sie eine Verbindung ohne lokalen Node.js-Prozess? Gehostetes MCP einrichten.