Przejdź do treści
Zasoby dla deweloperów
Zasoby dla deweloperów

Local MCP

Uruchom serwer RunAPI MCP lokalnie z Claude Code, Cursor, VS Code, Windsurf lub innym klientem stdio.

Zobacz Markdown

Local MCP umożliwia klientowi MCP uruchomienie serwera RunAPI MCP na Twoim komputerze. Użyj tej opcji, gdy klient nie obsługuje Remote MCP lub jawnie potrzebujesz procesu lokalnego.

Zanim zaczniesz

Zainstaluj Node.js i potwierdź dostępność npx. Twój klient MCP musi obsługiwać lokalne serwery stdio.

Każdy klient poniżej uruchamia to samo polecenie:

SHELL 
npx -y @runapi.ai/mcp

Możesz połączyć się i korzystać z narzędzi katalogu bez logowania się.

Claude Code

Uruchom:

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

Użyj -s user, aby udostępnić RunAPI we wszystkich swoich projektach. Zrestartuj Claude Code, jeśli był już uruchomiony, a następnie sprawdź, czy RunAPI jest wymieniony jako serwer MCP.

Kursor

Dodaj serwer w sekcji mcpServers w .cursor/mcp.json lub w konfiguracji MCP użytkownika:

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

Otwórz Customize na pasku bocznym Cursor, znajdź RunAPI i włącz je. Jeśli proces nie uruchamia się, otwórz panel Output i wybierz MCP Logs.

VS Code

  1. Otwórz paletę poleceń i uruchom MCP: Add Server.
  2. Wybierz Command (stdio) i wprowadź npx -y @runapi.ai/mcp.
  3. Nadaj serwerowi nazwę RunAPI, wybierz zakres konfiguracji i uruchom go.
  4. Zaufaj serwerowi po wyświetleniu monitu. W przypadku błędów uruchom MCP: List Servers, wybierz RunAPI i wybierz Show Output.

VS Code przechowuje ręczną konfigurację pod kluczem najwyższego poziomu servers i używa type: "stdio".

Windsurf

Te kroki dotyczą agenta Cascade. Devin Local używa konfiguracji Devin CLI.

  1. Otwórz Devin Settings > Cascade > MCP Servers.
  2. Otwórz surową konfigurację MCP w pliku ~/.codeium/windsurf/mcp_config.json.
  3. Dodaj RunAPI z poleceniem npx i argumentami pokazanymi w powyższym przykładzie dla Cursora.
  4. Zapisz plik, odśwież serwery MCP i włącz RunAPI.

Inne klienty MCP

Dodaj lokalny serwer stdio o nazwie RunAPI. Ustaw jego polecenie na npx, a argumenty na -y i @runapi.ai/mcp. Uruchom ponownie lub odśwież klienta po zapisaniu konfiguracji.

Weryfikuj połączenie

Zapytaj klienta:

Jakie modele obrazów RunAPI są dostępne?

Klient powinien wywołać list_models i zwrócić dostępne modele obrazów. To publiczne narzędzie wykrywania nie wymaga uwierzytelniania.

Zaloguj się, gdy jest to wymagane

Kontynuuj korzystanie z narzędzi odkrywania bez logowania. Gdy po raz pierwszy poprosisz RunAPI o utworzenie zadania, pobranie zadania lub sprawdzenie salda, pozwól klientowi wywołać narzędzie login. Otwiera ono RunAPI w przeglądarce i zapisuje poświadczenie w lokalnej konfiguracji współdzielonej.

Jeśli wolisz zalogować się z terminala, zainstaluj RunAPI CLI i uruchom:

SHELL 
runapi login

W przypadku klientów bezgłowych lub CI postępuj zgodnie z Przewodnikiem po uwierzytelnianiu, aby utworzyć dedykowany standardowy klucz API, a następnie podaj go jako RUNAPI_API_KEY w zmiennych środowiskowych lub konfiguracji sekretów klienta. Klucz środowiskowy ma pierwszeństwo przed poświadczeniami zapisanymi przez Local MCP Login.

Rozwiązywanie problemów

  • Nie znaleziono npx: potwierdź, że node --version i npx --version działają, a następnie całkowicie uruchom ponownie klienta MCP, aby otrzymał zaktualizowane środowisko.
  • Lokalny serwer zamyka się natychmiast: uruchom npx -y @runapi.ai/mcp w terminalu, popraw zgłoszony błąd Node.js lub pakietu, a następnie uruchom ponownie klienta.
  • Narzędzia RunAPI nie pojawiają się: potwierdź, że serwer jest włączony i że polecenie używa stdio, a następnie sprawdź dziennik klienta opisany powyżej.
  • Uwierzytelnione narzędzie kończy się niepowodzeniem: poproś klienta o wywołanie narzędzia login. Jeśli ustawiono RUNAPI_API_KEY, zaktualizuj go lub usuń przed ponowną próbą logowania Local MCP Login.

Wolisz połączenie bez lokalnego procesu Node.js? Skonfiguruj hostowane MCP.