---
title: Hosted MCP | RunAPI
description: Conecte o Claude Desktop, Cursor, VS Code, Windsurf ou outro cliente
  MCP ao RunAPI com OAuth.
url: https://runapi.ai/pt-BR/docs/resources/mcp/hosted.md
canonical: https://runapi.ai/pt-BR/docs/resources/mcp/hosted
locale: pt-BR
---

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

# Hosted MCP

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

1.  Abra **Settings > Connectors** e adicione um conector personalizado.
2.  Nomeie-o **RunAPI** e insira o endpoint acima.
3.  Selecione **Connect** e conclua a autorização do RunAPI no seu
    navegador.
4.  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

1.  Abra a Paleta de Comandos e execute **MCP: Add Server**.
2.  Escolha **HTTP**, insira o endpoint acima e nomeie o servidor
    **RunAPI**.
3.  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.

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

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

1.  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](https://runapi.ai/pt-BR/docs/guides/authentication.md) 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](https://runapi.ai/pt-BR/docs/resources/mcp/local.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": "Hosted MCP",
    "description": "Conecte o Claude Desktop, Cursor, VS Code, Windsurf ou outro cliente MCP ao RunAPI com OAuth.",
    "url": "https://runapi.ai/pt-BR/docs/resources/mcp/hosted",
    "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/mcp/hosted"
  }
]
```