Developer Resources

Hosted MCP

Verbind Claude Desktop, Cursor, VS Code, Windsurf of een andere MCP-client met RunAPI via OAuth.

Hosted MCP is de aanbevolen manier om RunAPI-tools te gebruiken. Uw MCP-client maakt rechtstreeks verbinding met RunAPI, zodat u Node.js niet hoeft te installeren of een lokaal proces actief hoeft te houden.

Gebruik dit eindpunt:

TEXT

https://mcp.runapi.ai/mcp

Kies hieronder uw MCP-client. Wanneer de client RunAPI in uw browser opent, meldt u zich aan, selecteert u het te gebruiken account en verleent u toegang.

Claude Desktop

Open Settings > Connectors en voeg een aangepaste connector toe.
Geef het de naam RunAPI en voer het bovenstaande eindpunt in.
Selecteer Connect en voltooi de RunAPI-autorisatie in uw browser.
Open in een gesprek + > Connectors en schakel RunAPI in.

Als RunAPI niet verschijnt in een gesprek, ga dan terug naar Instellingen > Connectors, maak opnieuw verbinding en bevestig dat het is ingeschakeld voor dat gesprek.

Cursor

Voeg RunAPI toe aan uw Cursor-bestand mcp.json, zoals het .cursor/mcp.json op projectniveau:

JSON

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

Open Customize in de Cursor-zijbalk, zoek RunAPI, schakel het in en voltooi de autorisatie in uw browser.

RunAPI moet als verbonden worden weergegeven en zijn tools beschikbaar stellen. Bij verbindings- of authenticatiefouten opent u het paneel Uitvoer en selecteert u MCP-logboeken.

VS Code

Open het opdrachtenpalet en voer MCP: Add Server uit.
Kies HTTP, voer het bovenstaande eindpunt in en geef de server de naam RunAPI.
Start de server, vertrouw hem wanneer daarom wordt gevraagd en voltooi de autorisatie in uw browser.

RunAPI-tools moeten zichtbaar zijn in Chat. Voer bij fouten MCP: List Servers uit, selecteer RunAPI en kies Show Output.

Windsurf

Deze stappen zijn van toepassing op de Cascade-agent. Devin Local gebruikt Devin CLI-configuratie.

Open Devin Settings > Cascade > MCP Servers en bewerk het onbewerkte bestand ~/.codeium/windsurf/mcp_config.json.
Voeg RunAPI toe als een externe HTTP-server:

JSON

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

Sla het bestand op, vernieuw de MCP-servers, schakel RunAPI in en voltooi de autorisatie in uw browser.

Als de tools niet verschijnen, open dan de MCP-instellingen, bevestig dat RunAPI is ingeschakeld en maak opnieuw verbinding.

Andere MCP-clients

Voeg het bovenstaande eindpunt toe als een Streamable HTTP-server. De client moet Remote MCP en browsergebaseerde OAuth ondersteunen. Voltooi de autorisatie wanneer daarom wordt gevraagd en schakel vervolgens de RunAPI-tools in de client in.

De verbinding verifiëren

Vraag uw client:

Welke RunAPI-beeldmodellen zijn beschikbaar?

De client dient list_models aan te roepen en beschikbare afbeeldingsmodellen te retourneren. Dit bevestigt dat de verbinding en toolverzending werken.

Gebruik in plaats daarvan een API-sleutel

OAuth is de aanbevolen methode. Gebruik een toegewijde standaard API-sleutel alleen voor een onbeheerde client of wanneer OAuth niet beschikbaar is; volg de Authenticatiehandleiding om er een aan te maken. Zet de sleutel nooit in de eindpunt-URL en sla hem niet op in een repository.

Claude Desktop: Als Request headers beschikbaar zijn voor aangepaste connectors, voeg dan een Authorization-header toe met de waarde Bearer YOUR_API_KEY.
Cursor: Stel RUNAPI_API_KEY in de omgeving in die zichtbaar is voor de Cursor-applicatie en gebruik vervolgens Authorization: Bearer ${env:RUNAPI_API_KEY} in de server-headers. Externe servers lezen geen Cursor envFile-instellingen.
VS Code: Verwijs naar een ${input:...} van het type password vanuit de server-Authorization-header, zodat VS Code de sleutel opvraagt en opslaat in plaats van deze in mcp.json te schrijven.
Windsurf: Verwijs naar ${env:RUNAPI_API_KEY} of ${file:...} vanuit de Authorization-header in ~/.codeium/windsurf/mcp_config.json.

Trek de sleutel in via de pagina API-sleutels wanneer de client buiten gebruik wordt gesteld of wanneer de sleutel mogelijk is blootgesteld.

Probleemoplossing

Autorisatie is niet voltooid: verbind RunAPI opnieuw vanuit de client en doorloop de browserstroom opnieuw.
RunAPI is verbonden, maar de tools ontbreken: controleer of de server is ingeschakeld, verwijder het exacte eindpunt en voeg het opnieuw toe, en start vervolgens een nieuw gesprek.
De verificatievraag mislukt: raadpleeg het clientlogboek dat in het bijbehorende gedeelte hierboven wordt beschreven, en verbind RunAPI opnieuw voordat u het opnieuw probeert.

Heeft u een client nodig om RunAPI op uw machine te starten? Stel lokale MCP in.