Recursos para Desenvolvedores

Hosted MCP

Conecte o Claude Desktop, Cursor, VS Code, Windsurf ou outro cliente MCP ao RunAPI com OAuth.

O Hosted MCP é a forma recomendada de usar as ferramentas RunAPI. Seu cliente MCP se conecta diretamente ao RunAPI, portanto você não precisa instalar o Node.js nem manter um processo local em execução.

Use este endpoint:

TEXT

https://mcp.runapi.ai/mcp

Escolha seu cliente MCP abaixo. Quando o cliente abrir o RunAPI no seu navegador, faça login, selecione a conta a ser usada e aprove o acesso.

Claude Desktop

Abra Settings > Connectors e adicione um conector personalizado.
Nomeie-o RunAPI e insira o endpoint acima.
Selecione Connect e conclua a autorização do RunAPI no seu navegador.
Em uma conversa, abra + > Connectors e habilite o RunAPI.

Se o RunAPI não aparecer em uma conversa, vá para Configurações > Conectores, reconecte-o e confirme que está habilitado para aquela conversa.

Cursor

Adicione o RunAPI ao mcp.json do seu Cursor, como o .cursor/mcp.json no nível do projeto:

JSON

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

Abra Customize na barra lateral do Cursor, encontre RunAPI, ative-o e conclua a autorização no seu navegador.

O RunAPI deve aparecer como conectado e expor suas ferramentas. Em caso de erros de conexão ou autenticação, abra o painel Output e selecione MCP Logs.

VS Code

Abra a Paleta de Comandos e execute MCP: Add Server.
Escolha HTTP, insira o endpoint acima e nomeie o servidor RunAPI.
Inicie o servidor, confie nele quando solicitado e conclua a autorização no seu navegador.

As ferramentas do RunAPI devem aparecer no Chat. Em caso de erros, execute MCP: List Servers, selecione RunAPI e escolha Show Output.

Windsurf

Estas etapas se aplicam ao agente Cascade. O Devin Local usa a configuração da Devin CLI.

Abra Devin Settings > Cascade > MCP Servers e edite diretamente o arquivo ~/.codeium/windsurf/mcp_config.json.
Adicione o RunAPI como servidor HTTP remoto:

JSON

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

Salve o arquivo, atualize os servidores MCP, habilite o RunAPI e conclua a autorização no seu navegador.

Se as ferramentas não aparecerem, abra as configurações do MCP, confirme que o RunAPI está habilitado e reconecte-o.

Outros clientes MCP

Adicione o endpoint acima como servidor Streamable HTTP. O cliente deve suportar Remote MCP e OAuth baseado em navegador. Conclua a autorização quando solicitado e habilite as ferramentas RunAPI no cliente.

Verificar a conexão

Pergunte ao seu cliente:

Quais modelos de imagem do RunAPI estão disponíveis?

O cliente deve chamar list_models e retornar os modelos de imagem disponíveis. Isso confirma que a conexão e o despacho de ferramentas estão funcionando.

Use uma Chave de API

O OAuth é o caminho recomendado. Use uma Chave de API padrão dedicada somente para um cliente não supervisionado ou quando o OAuth não estiver disponível; siga o Guia de Autenticação para criar uma. Nunca inclua a chave na URL do endpoint nem a confirme em um repositório.

Claude Desktop: Se os cabeçalhos de requisição estiverem disponíveis para conectores personalizados, adicione um cabeçalho Authorization com o valor Bearer YOUR_API_KEY.
Cursor: Defina RUNAPI_API_KEY no ambiente visível para o aplicativo Cursor e use Authorization: Bearer ${env:RUNAPI_API_KEY} nos headers do servidor. Servidores remotos não leem as configurações de envFile do Cursor.
VS Code: Referencie um ${input:...} do tipo senha no cabeçalho Authorization do servidor para que o VS Code solicite e armazene a chave em vez de gravá-la no mcp.json.
Windsurf: Referencie ${env:RUNAPI_API_KEY} ou ${file:...} no cabeçalho Authorization em ~/.codeium/windsurf/mcp_config.json.

Revogue a chave na página de Chaves de API quando o cliente for desativado ou a chave puder ter sido exposta.

Solucionar problemas

A autorização não foi concluída: reconecte o RunAPI a partir do cliente e conclua o fluxo no navegador novamente.
O RunAPI está conectado, mas suas ferramentas estão ausentes: confirme que o servidor está habilitado, remova e adicione o endpoint exato novamente e inicie uma nova conversa.
A pergunta de verificação falha: verifique o log do cliente descrito na seção correspondente acima e reconecte o RunAPI antes de tentar novamente.

Precisa de um cliente para iniciar o RunAPI em sua máquina? Configure o Local MCP.