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

Hosted MCP

Połącz Claude Desktop, Cursor, VS Code, Windsurf lub innego klienta MCP z RunAPI przy użyciu OAuth.

Zobacz Markdown

Hosted MCP to zalecany sposób korzystania z narzędzi RunAPI. Twój klient MCP łączy się bezpośrednio z RunAPI, więc nie musisz instalować Node.js ani utrzymywać działającego lokalnego procesu.

Użyj tego punktu końcowego:

TEXT 
https://mcp.runapi.ai/mcp

Wybierz swojego klienta MCP poniżej. Gdy klient otworzy RunAPI w przeglądarce, zaloguj się, wybierz konto do użycia i zatwierdź dostęp.

Claude Desktop

  1. Otwórz Settings > Connectors i dodaj niestandardowy łącznik.
  2. Nadaj mu nazwę RunAPI i wprowadź powyższy adres punktu końcowego.
  3. Wybierz Connect i zakończ autoryzację RunAPI w przeglądarce.
  4. W rozmowie otwórz + > Connectors i włącz RunAPI.

Jeśli RunAPI nie pojawia się w rozmowie, wróć do Ustawienia > Konektory, połącz się ponownie i potwierdź, że jest włączony dla tej rozmowy.

Kursor

Dodaj RunAPI do pliku mcp.json w Cursorze, np. do pliku .cursor/mcp.json na poziomie projektu:

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

Otwórz Customize na pasku bocznym Cursor, znajdź RunAPI, włącz je i zakończ autoryzację w przeglądarce.

RunAPI powinien być widoczny jako podłączony i udostępniać swoje narzędzia. W przypadku błędów połączenia lub uwierzytelniania otwórz panel Wyjście i wybierz Dzienniki MCP.

VS Code

  1. Otwórz paletę poleceń i uruchom MCP: Add Server.
  2. Wybierz HTTP, wprowadź powyższy adres punktu końcowego i nadaj serwerowi nazwę RunAPI.
  3. Uruchom serwer, zaufaj mu po wyświetleniu monitu i zakończ autoryzację w przeglądarce.

Narzędzia RunAPI powinny pojawić się w oknie czatu. W przypadku błędów uruchom MCP: Lista serwerów, wybierz RunAPI i kliknij Pokaż dane wyjściowe.

Windsurf

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

  1. Otwórz Devin Settings > Cascade > MCP Servers i edytuj plik ~/.codeium/windsurf/mcp_config.json w trybie surowym.
  2. Dodaj RunAPI jako zdalny serwer HTTP:
JSON 
{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}
  1. Zapisz plik, odśwież serwery MCP, włącz RunAPI i zakończ autoryzację w przeglądarce.

Jeśli narzędzia nie pojawiają się, otwórz ustawienia MCP, potwierdź, że RunAPI jest włączony, i połącz się ponownie.

Inne klienty MCP

Dodaj powyższy punkt końcowy jako serwer Streamable HTTP. Klient musi obsługiwać Remote MCP oraz OAuth oparty na przeglądarce. Zakończ autoryzację po wyświetleniu monitu, a następnie włącz narzędzia RunAPI w kliencie.

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. Potwierdza to, że połączenie i wysyłka narzędzi działają poprawnie.

Użyj zamiast tego Klucza API

OAuth jest zalecaną metodą. Standardowego klucza API używaj wyłącznie dla bezobsługowego klienta lub gdy OAuth jest niedostępne; postępuj zgodnie z Przewodnikiem po uwierzytelnianiu, aby go utworzyć. Nigdy nie umieszczaj klucza w adresie URL punktu końcowego ani nie zatwierdzaj go do repozytorium.

  • Claude Desktop: jeśli nagłówki żądań są dostępne dla niestandardowych łączników, dodaj nagłówek Authorization z wartością Bearer YOUR_API_KEY.
  • Cursor: ustaw RUNAPI_API_KEY w środowisku widocznym dla aplikacji Cursor, a następnie użyj Authorization: Bearer ${env:RUNAPI_API_KEY} w nagłówkach (headers) serwera. Zdalne serwery nie odczytują ustawień envFile w Cursor.
  • VS Code: odwołaj się do hasła typu ${input:...} w nagłówku Authorization serwera, aby VS Code monitował o podanie klucza i zapisywał go, zamiast wpisywać go do mcp.json.
  • Windsurf: odwołaj się do ${env:RUNAPI_API_KEY} lub ${file:...} w nagłówku Authorization w pliku ~/.codeium/windsurf/mcp_config.json.

Unieważnij klucz na stronie Klucze API, gdy klient zostaje wycofany lub klucz mógł zostać ujawniony.

Rozwiązywanie problemów

  • Uwierzytelnianie nie zostało ukończone: ponownie połącz RunAPI z poziomu klienta i dokończ proces w przeglądarce.
  • RunAPI jest połączony, ale brakuje jego narzędzi: potwierdź, że serwer jest włączony, usuń i ponownie dodaj dokładny punkt końcowy, a następnie rozpocznij nową rozmowę.
  • Pytanie weryfikacyjne kończy się niepowodzeniem: sprawdź dziennik klienta opisany w odpowiedniej sekcji powyżej, a następnie ponownie połącz RunAPI przed kolejną próbą.

Potrzebujesz klienta, który uruchomi RunAPI na Twoim komputerze? Skonfiguruj Local MCP.