Naar inhoud springen
Developer Resources
Developer Resources

Lokale MCP

Voer de RunAPI MCP Server lokaal uit met Claude Code, Cursor, VS Code, Windsurf of een andere stdio-client.

Markdown bekijken

Lokale MCP laat uw MCP-client de RunAPI MCP Server op uw machine starten. Gebruik dit wanneer de client geen Remote MCP ondersteunt of wanneer u expliciet een lokaal proces nodig hebt.

Voordat u begint

Installeer Node.js en bevestig dat npx beschikbaar is. Uw MCP-client moet lokale stdio-servers ondersteunen.

Elke client hieronder start hetzelfde commando:

SHELL 
npx -y @runapi.ai/mcp

U kunt catalogustools verbinden en gebruiken zonder u aan te melden.

Claude Code

Uitvoeren:

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

Gebruik -s user om RunAPI beschikbaar te maken voor al uw projecten. Start Claude Code opnieuw als het al actief was, en bevestig vervolgens dat RunAPI wordt vermeld als een MCP-server.

Cursor

Voeg de server toe onder mcpServers in .cursor/mcp.json of uw gebruikers-MCP-configuratie:

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

Open Customize in de Cursor-zijbalk, zoek RunAPI en schakel het in. Als het proces niet start, open dan het Output-paneel en selecteer MCP Logs.

VS Code

  1. Open het opdrachtenpalet en voer MCP: Add Server uit.
  2. Kies Command (stdio) en voer npx -y @runapi.ai/mcp in.
  3. Geef de server de naam RunAPI, kies het configuratiebereik en start de server.
  4. Vertrouw de server wanneer daarom wordt gevraagd. Voer bij fouten MCP: List Servers uit, selecteer RunAPI en kies Show Output.

VS Code slaat handmatige configuratie op onder de servers-sleutel op het hoogste niveau en gebruikt type: "stdio".

Windsurf

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

  1. Open Devin Settings > Cascade > MCP Servers.
  2. Open de onbewerkte MCP-configuratie op ~/.codeium/windsurf/mcp_config.json.
  3. Voeg RunAPI toe met de npx-opdracht en de argumenten die in het Cursor-voorbeeld hierboven worden getoond.
  4. Sla het bestand op, vernieuw de MCP-servers en schakel RunAPI in.

Andere MCP-clients

Voeg een lokale stdio-server toe met de naam RunAPI. Stel de opdracht in op npx en de argumenten op -y en @runapi.ai/mcp. Start de client opnieuw op of vernieuw hem na het opslaan van de configuratie.

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 publieke detectiehulpmiddel vereist geen authenticatie.

Aanmelden wanneer nodig

Blijf detectietools gebruiken zonder in te loggen. Wanneer u RunAPI voor het eerst vraagt een task aan te maken, een task op te halen of een saldo te controleren, laat de client dan het login-tool aanroepen. Dit opent RunAPI in uw browser en slaat de referentie op in de gedeelde lokale configuratie.

Als u liever inlogt vanuit een terminal, installeer dan de RunAPI CLI en voer het volgende uit:

SHELL 
runapi login

Voor clients zonder weergave of CI-clients volgt u de Authenticatie- Handleiding om een toegewijd standaard API-sleutel aan te maken en stelt u die vervolgens in als RUNAPI_API_KEY via de omgeving of de geheime configuratie van de client. Een omgevingssleutel heeft voorrang op de opgeslagen credential van Lokale MCP-aanmelding.

Probleemoplossing

  • npx wordt niet gevonden: controleer of node --version en npx --version werken, en herstart vervolgens de MCP-client volledig zodat deze de bijgewerkte omgeving ontvangt.
  • De lokale server sluit onmiddellijk af: voer npx -y @runapi.ai/mcp uit in een terminal, los de gemelde Node.js- of pakketfout op en herstart vervolgens de client.
  • RunAPI-tools verschijnen niet: controleer of de server is ingeschakeld en of de opdracht stdio gebruikt, en raadpleeg vervolgens het clientlogboek dat hierboven wordt beschreven.
  • Een geverifieerde tool mislukt: vraag de client de login-tool aan te roepen. Als RUNAPI_API_KEY is ingesteld, werk deze bij of verwijder deze voordat u Local MCP Login opnieuw probeert.

Voorkeur voor een verbinding zonder een lokaal Node.js-proces? Stel Hosted MCP in.