Pular para o conteúdo
Recursos para Desenvolvedores
Recursos para Desenvolvedores

Local MCP

Execute o RunAPI MCP Server localmente com Claude Code, Cursor, VS Code, Windsurf ou outro cliente stdio.

Ver Markdown

O Local MCP permite que seu cliente MCP inicie o RunAPI MCP Server em sua máquina. Use-o quando o cliente não oferecer suporte a Remote MCP ou quando você precisar explicitamente de um processo local.

Antes de iniciar

Instale o Node.js e confirme que o npx está disponível. Seu cliente MCP deve suportar servidores stdio locais.

Cada cliente abaixo inicia o mesmo comando:

SHELL 
npx -y @runapi.ai/mcp

Você pode conectar e usar ferramentas do catálogo sem fazer login.

Claude Code

Execute:

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

Use -s user para disponibilizar o RunAPI em todos os seus projetos. Reinicie o Claude Code caso já esteja em execução e confirme que o RunAPI está listado como servidor MCP.

Cursor

Adicione o servidor em mcpServers no .cursor/mcp.json ou na sua configuração MCP de usuário:

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

Abra Customize na barra lateral do Cursor, encontre RunAPI e ative-o. Se o processo não iniciar, abra o painel Output e selecione MCP Logs.

VS Code

  1. Abra o Paleta de Comandos e execute MCP: Add Server.
  2. Escolha Command (stdio) e insira npx -y @runapi.ai/mcp.
  3. Nomeie o servidor RunAPI, escolha o escopo de configuração e inicie-o.
  4. Confie no servidor quando solicitado. Em caso de erros, execute MCP: List Servers, selecione RunAPI e escolha Show Output.

O VS Code armazena a configuração manual na chave servers de nível superior e usa type: "stdio".

Windsurf

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

  1. Abra Devin Settings > Cascade > MCP Servers.
  2. Abra a configuração MCP diretamente em ~/.codeium/windsurf/mcp_config.json.
  3. Adicione o RunAPI com o comando npx e os argumentos mostrados no exemplo do Cursor acima.
  4. Salve o arquivo, atualize os servidores MCP e habilite o RunAPI.

Outros clientes MCP

Adicione um servidor stdio local chamado RunAPI. Defina seu comando como npx e seus argumentos como -y e @runapi.ai/mcp. Reinicie ou atualize o cliente após salvar a configuração.

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. Essa ferramenta de descoberta pública não requer Autenticação.

Entrar quando necessário

Continue usando as ferramentas de descoberta sem fazer login. Quando você pedir ao RunAPI pela primeira vez para criar uma task, recuperar uma task ou verificar um saldo, deixe o cliente chamar a ferramenta login. Ela abre o RunAPI no seu navegador e salva a credencial na configuração local compartilhada.

Se preferir fazer login a partir de um terminal, instale a CLI do RunAPI e execute:

SHELL 
runapi login

Para clientes headless ou de CI, siga o Guia de Autenticação para criar uma Chave de API padrão dedicada, depois forneça-a como RUNAPI_API_KEY por meio do ambiente do cliente ou da configuração de segredos. Uma chave de ambiente tem precedência sobre a credencial salva pelo Local MCP Login.

Solucionar problemas

  • npx não é encontrado: confirme que node --version e npx --version funcionam e reinicie completamente o cliente MCP para que ele receba o ambiente atualizado.
  • O servidor local encerra imediatamente: execute npx -y @runapi.ai/mcp em um terminal, corrija o erro de Node.js ou de pacote relatado e reinicie o cliente.
  • As ferramentas RunAPI não aparecem: confirme que o servidor está habilitado e que o comando usa stdio e verifique o log do cliente descrito acima.
  • Uma ferramenta autenticada falha: peça ao cliente para chamar a ferramenta login. Se RUNAPI_API_KEY estiver definida, atualize ou remova-a antes de tentar o Local MCP Login novamente.

Prefere uma conexão sem um processo Node.js local? Configure o MCP Hosted.