Risorse per sviluppatori

Hosted MCP

Connetti Claude Desktop, Cursor, VS Code, Windsurf o un altro client MCP a RunAPI con OAuth.

Hosted MCP è il modo consigliato per utilizzare gli strumenti RunAPI. Il tuo client MCP si connette direttamente a RunAPI, quindi non è necessario installare Node.js o mantenere in esecuzione un processo locale.

Usa questo endpoint:

TEXT

https://mcp.runapi.ai/mcp

Scegli il tuo client MCP qui sotto. Quando il client apre RunAPI nel tuo browser, accedi, seleziona l’account da utilizzare e approva l’accesso.

Claude Desktop

Apri Settings > Connectors e aggiungi un connettore personalizzato.
Assegnagli il nome RunAPI e inserisci l’endpoint indicato sopra.
Seleziona Connect e completa l’autorizzazione RunAPI nel browser.
In una conversazione, apri + > Connectors e abilita RunAPI.

Se RunAPI non appare in una conversazione, torna a Impostazioni > Connettori, riconnettilo e conferma che sia abilitato per quella conversazione.

Cursore

Aggiungi RunAPI al file mcp.json di Cursor, ad esempio il .cursor/mcp.json a livello di progetto:

JSON

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

Apri Customize nella barra laterale di Cursor, trova RunAPI, abilitalo e completa l’autorizzazione nel browser.

RunAPI dovrebbe risultare connesso ed esporre i propri strumenti. Per errori di connessione o autenticazione, apri il pannello Output e seleziona MCP Logs.

VS Code

Apri il Command Palette ed esegui MCP: Add Server.
Scegli HTTP, inserisci l’endpoint indicato sopra e assegna al server il nome RunAPI.
Avvia il server, consideralo attendibile quando richiesto e completa l’autorizzazione nel browser.

Gli strumenti RunAPI dovrebbero apparire in Chat. In caso di errori, esegui MCP: List Servers, seleziona RunAPI e scegli Show Output.

Windsurf

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

Apri Devin Settings > Cascade > MCP Servers e modifica direttamente il file ~/.codeium/windsurf/mcp_config.json.
Aggiungi RunAPI come server HTTP remoto:

JSON

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

Salva il file, aggiorna i server MCP, abilita RunAPI e completa l’autorizzazione nel browser.

Se gli strumenti non appaiono, apri le impostazioni MCP, conferma che RunAPI sia abilitato e riconnettilo.

Altri client MCP

Aggiungi l’endpoint indicato sopra come server Streamable HTTP. Il client deve supportare Remote MCP e OAuth basato su browser. Completa l’autorizzazione quando richiesto, quindi abilita gli strumenti RunAPI nel client.

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. Ciò conferma che la connessione e il dispatching degli strumenti funzionano correttamente.

Usa invece una Chiave API

OAuth è il percorso consigliato. Usa una Chiave API standard dedicata solo per un client non presidiato o quando OAuth non è disponibile; segui la Guida all’Autenticazione per crearne una. Non inserire mai la chiave nell’URL dell’endpoint né salvarla in un repository.

Claude Desktop: Se le intestazioni di richiesta sono disponibili per i connettori personalizzati, aggiungi un’intestazione Authorization con il valore Bearer YOUR_API_KEY.
Cursor: Imposta RUNAPI_API_KEY nell’ambiente visibile all’applicazione Cursor, quindi usa Authorization: Bearer ${env:RUNAPI_API_KEY} nelle headers del server. I server remoti non leggono le impostazioni envFile di Cursor.
VS Code: Fai riferimento a un ${input:...} di tipo password dall’intestazione Authorization del server, in modo che VS Code richieda e memorizzi la chiave invece di scriverla in mcp.json.
Windsurf: Fai riferimento a ${env:RUNAPI_API_KEY} o ${file:...} dall’intestazione Authorization in ~/.codeium/windsurf/mcp_config.json.

Revoca la chiave dalla pagina Chiavi API quando il client viene dismesso o la chiave potrebbe essere stata esposta.

Risoluzione dei problemi

L’Autenticazione non è stata completata: riconnetti RunAPI dal client e completa di nuovo il flusso del browser.
RunAPI è connesso ma i suoi strumenti sono assenti: verifica che il server sia abilitato, rimuovi e aggiungi di nuovo l’endpoint esatto, quindi avvia una nuova conversazione.
La domanda di verifica non va a buon fine: controlla il log del client descritto nella sezione corrispondente, quindi riconnetti RunAPI prima di riprovare.

Hai bisogno di un client per avviare RunAPI sulla tua macchina? Configura Local MCP.