---
title: Local MCP | RunAPI
description: Execute o RunAPI MCP Server localmente com Claude Code, Cursor, VS Code,
  Windsurf ou outro cliente stdio.
url: https://runapi.ai/pt-BR/docs/resources/mcp/local.md
canonical: https://runapi.ai/pt-BR/docs/resources/mcp/local
locale: pt-BR
---

> Versão HTML: https://runapi.ai/pt-BR/docs/resources/mcp/local
> Índice do site para agentes: https://runapi.ai/llms.txt

# Local MCP

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](https://runapi.ai/pt-BR/docs/resources/cli.md) e execute:

```shell
runapi login
```

Para clientes headless ou de CI, siga o [Guia de
Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md) 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](https://runapi.ai/pt-BR/docs/resources/mcp/hosted.md).

---

## Mais de RunAPI

- [Início](https://runapi.ai/pt-BR/.md)
- [Catálogo de modelos](https://runapi.ai/pt-BR/models.md)
- [Preços](https://runapi.ai/pt-BR/pricing.md)
- [Provedores](https://runapi.ai/pt-BR/models)
- [Documentação](https://runapi.ai/pt-BR/docs/guides)
- [SDKs](https://runapi.ai/pt-BR/sdk.md)
- [CLI](https://runapi.ai/pt-BR/cli.md)
- [Servidor MCP](https://runapi.ai/pt-BR/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md)
- [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pt-BR/contact.md)
- [Contato](https://runapi.ai/pt-BR/contact.md)
- [Termos](https://runapi.ai/pt-BR/terms.md)
- [Privacidade](https://runapi.ai/pt-BR/privacy.md)
- [Índice do site para agentes](https://runapi.ai/llms.txt)

Contato: contact@runapi.ai

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/pt-BRicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "TechArticle",
    "headline": "Local MCP",
    "description": "Execute o RunAPI MCP Server localmente com Claude Code, Cursor, VS Code, Windsurf ou outro cliente stdio.",
    "url": "https://runapi.ai/pt-BR/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/mcp/local"
  }
]
```