Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Local MCP

Esegui il RunAPI MCP Server localmente con Claude Code, Cursor, VS Code, Windsurf o un altro client stdio.

Visualizza Markdown

Local MCP consente al tuo client MCP di avviare il RunAPI MCP Server sulla tua macchina. Usalo quando il client non supporta Remote MCP o hai esplicitamente bisogno di un processo locale.

Prima di cominciare

Installa Node.js e verifica che npx sia disponibile. Il tuo client MCP deve supportare server stdio locali.

Ogni client qui sotto avvia lo stesso comando:

SHELL 
npx -y @runapi.ai/mcp

Puoi connetterti e usare gli strumenti del catalogo senza effettuare l’accesso.

Claude Code

Esegui:

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

Usa -s user per rendere RunAPI disponibile in tutti i tuoi progetti. Riavvia Claude Code se era già in esecuzione, quindi verifica che RunAPI sia elencato come server MCP.

Cursore

Aggiungi il server sotto mcpServers in .cursor/mcp.json o nella tua configurazione MCP utente:

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

Apri Customize nella barra laterale di Cursor, trova RunAPI e abilitalo. Se il processo non si avvia, apri il pannello Output e seleziona MCP Logs.

VS Code

  1. Apri il Command Palette ed esegui MCP: Add Server.
  2. Scegli Command (stdio) e inserisci npx -y @runapi.ai/mcp.
  3. Assegna al server il nome RunAPI, scegli l’ambito di configurazione e avvialo.
  4. Considera attendibile il server quando richiesto. In caso di errori, esegui MCP: List Servers, seleziona RunAPI e scegli Show Output.

VS Code salva la configurazione manuale sotto la chiave di primo livello servers e utilizza type: "stdio".

Windsurf

Questi passaggi si applicano all’agente Cascade. Devin Local utilizza la configurazione Devin CLI.

  1. Apri Devin Settings > Cascade > MCP Servers.
  2. Apri la configurazione MCP grezza in ~/.codeium/windsurf/mcp_config.json.
  3. Aggiungi RunAPI con il comando npx e gli argomenti mostrati nell’esempio Cursor precedente.
  4. Salva il file, aggiorna i server MCP e abilita RunAPI.

Altri client MCP

Aggiungi un server stdio locale denominato RunAPI. Imposta il suo comando su npx e i suoi argomenti su -y e @runapi.ai/mcp. Riavvia o aggiorna il client dopo aver salvato la configurazione.

Verifica la connessione

Chiedi al tuo client:

Quali modelli di immagini RunAPI sono disponibili?

Il client dovrebbe chiamare list_models e restituire i modelli di immagini disponibili. Questo strumento di rilevamento pubblico non richiede autenticazione.

Accedi quando necessario

Continua a utilizzare gli strumenti di rilevamento senza effettuare l’accesso. Quando chiedi per la prima volta a RunAPI di creare un task, recuperare un task o verificare un saldo, lascia che il client chiami lo strumento login. Apre RunAPI nel tuo browser e salva le credenziali nella configurazione locale condivisa.

Se preferisci accedere da un terminale, installa la CLI RunAPI ed esegui:

SHELL 
runapi login

Per client headless o CI, segui la Guida all’Autenticazione per creare una Chiave API standard dedicata, quindi forniscila come RUNAPI_API_KEY tramite l’ambiente del client o la configurazione dei segreti. Una chiave d’ambiente ha la precedenza sulla credenziale salvata da Local MCP Login.

Risoluzione dei problemi

  • npx non viene trovato: verifica che node --version e npx --version funzionino, quindi riavvia completamente il client MCP affinché riceva l’ambiente aggiornato.
  • Il server locale si chiude immediatamente: esegui npx -y @runapi.ai/mcp in un terminale, correggi l’errore Node.js o del pacchetto segnalato, quindi riavvia il client.
  • Gli strumenti RunAPI non compaiono: verifica che il server sia abilitato e che il comando utilizzi stdio, quindi controlla il log del client descritto in precedenza.
  • Uno strumento autenticato non funziona: chiedi al client di chiamare lo strumento login. Se RUNAPI_API_KEY è impostato, aggiornalo o rimuovilo prima di ritentare il Login MCP locale.

Preferisci una connessione senza un processo Node.js locale? Configura MCP ospitato.