---
lastModified: 2026-11-13
title: Adicionar seu próprio servidor MCP
description: Conecte um servidor MCP remoto pela URL e escolha o que o Runner Agent pode fazer com cada ferramenta.
seo:
  description: "Conecte seu próprio servidor MCP remoto ao Runner pela URL, com ou sem chave de API, e defina cada ferramenta como Permitir, Perguntar antes ou Desativado antes que o Agent possa usá-la."
---

Se um serviço que você usa tem um servidor MCP, você pode dar as ferramentas dele ao Runner Agent. Cole
a URL do servidor. O Runner encontra as ferramentas do servidor. Depois, você escolhe o que o Agent pode
fazer com cada ferramenta.

Use isso para um serviço que não está em **Conecte suas ferramentas**, como seu próprio ERP, um
sistema de estoque ou uma ferramenta que sua equipe administra.

## Antes de começar

**Caminho de entrada:** **Projeto → Agente → Ferramentas → Adicione seu próprio servidor MCP**

Você precisa de:

- a função de proprietário ou administrador da loja. Outros membros não podem adicionar, alterar ou remover um servidor;
- a URL de um servidor MCP remoto, como `https://example.com/mcp`; e
- a chave de API e o nome do cabeçalho dela, se o servidor precisar de uma chave.

O servidor precisa atender a estas condições:

- Ele precisa estar na internet pública. O Runner não se conecta a `localhost` nem a um endereço de
  rede privada.
- Ele precisa usar o transporte HTTP do MCP (Streamable HTTP). O Runner não executa um servidor local
  de linha de comando (stdio) para você.
- Ele precisa funcionar sem login ou com uma chave de API em um cabeçalho da requisição. **OAuth** ainda
  não está disponível.

Uma loja pode ter até 10 servidores MCP. O Runner mantém até 100 ferramentas de cada servidor.

**Importante:** O Runner não consegue verificar o que um servidor próprio faz com seus dados. Adicione
só servidores que você administra ou conhece bem.

## Adicionar um servidor

1. Abra seu projeto e selecione **Agente → Ferramentas**.
2. Na linha **Adicione seu próprio servidor MCP**, selecione **Adicionar servidor**.
3. Digite a **URL do servidor**. Ou cole a configuração JSON da documentação do servidor em
   **Colar configuração JSON**. O Runner preenche a URL e o cabeçalho da chave a partir da configuração.
4. Opcional: digite um **Nome**. Se você deixar vazio, o Runner usa o nome do próprio servidor.
   O Runner mostra esse nome no chat quando usa uma ferramenta.
5. Em **Como o Runner entra**, selecione **Sem login** ou **Chave de API**. Para **Chave de API**,
   digite o **Nome do cabeçalho** e a **Chave**, como `Authorization` e `Bearer sk-…`.
   O Runner salva a chave com criptografia. Ninguém, nem você, consegue lê-la de novo.
6. **Quais agentes podem usá-lo** mostra **Todos os agentes**. Você pode mudar isso por agente depois.
7. Selecione **Confio neste servidor**.
8. Selecione **Conectar e encontrar ferramentas**. O Runner se conecta ao servidor e lista as ferramentas dele.
9. Escolha uma regra para cada ferramenta. Depois, selecione o botão com o nome do servidor, como
   **Adicionar Shop ERP**.

Depois que o servidor é adicionado, ele aparece em **Conectadas** com a tag **MCP próprio**.

## Escolher o que cada ferramenta pode fazer

Cada ferramenta recebe uma de três regras:

- **Permitir:** o Agent usa a ferramenta sem perguntar a você.
- **Perguntar antes:** o Agent mostra a chamada no chat. A ferramenta só é executada depois que você aprova.
- **Desativado:** o Agent não pode usar a ferramenta.

O Runner deduz uma regra inicial pelo nome de cada ferramenta e agrupa as ferramentas por essa regra:

| Grupo | Regra inicial | Nomes de ferramentas que o Runner coloca aqui |
| --- | --- | --- |
| **Lê dados** | **Permitir** | Nomes que começam com uma palavra de leitura, como `list`, `get` ou `search`. Também todo nome que o Runner não reconhece. |
| **Altera dados** | **Perguntar antes** | Nomes que contêm `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` ou `price`. |
| **Exclui dados** | **Desativado** | Nomes que contêm `delete` ou `trash`. |

**Confira a regra de cada ferramenta antes de adicionar o servidor.** O Runner lê só o nome
da ferramenta, não o que ela faz. Uma ferramenta como `update_inventory` ou `create_customer`
começa em **Permitir** em **Lê dados**, então o Agent poderia alterar dados sem perguntar a você.
Mude ferramentas assim para **Perguntar antes** ou **Desativado**.

Você pode mudar a regra de qualquer ferramenta antes de adicionar o servidor. Depois, mude a regra em
**O que qualquer agente pode fazer** na página do servidor. Uma ferramenta que o servidor adicionar
depois começa em **Perguntar antes**, ou em **Desativado** se o nome contiver `delete` ou `trash`.

As regras valem para todos os chats deste projeto. O Runner as verifica em cada chamada de ferramenta.

## Gerenciar um servidor

Abra o servidor em **Conectadas** na página **Agente → Ferramentas**. A página dele tem estes controles:

| Controle ou informação | O que faz |
| --- | --- |
| URL do servidor e botão de copiar | Em **Conexão**. **Copiar URL do servidor** copia a URL. |
| **Status** | Mostra quando o servidor respondeu pela última vez, ou **Ainda não verificado**. |
| **Login** | Mostra **Sem login** ou os últimos quatro caracteres da chave. **Adicionar chave** ou **Substituir** muda a chave. |
| **Testar conexão** ou **Atualizar ferramentas** | Conecta ao servidor de novo e obtém a lista atual de ferramentas. Novas ferramentas começam em **Perguntar antes**, ou em **Desativado** se forem ferramentas de exclusão. |
| **Remover servidor** | Remove o servidor. Os agentes perdem as ferramentas dele, e as regras das ferramentas são excluídas. Você pode adicioná-lo de novo depois. |

## Se algo der errado

| Mensagem | O que fazer |
| --- | --- |
| **Digite a URL completa do servidor, como https://example.com/mcp.** | Digite a URL completa, incluindo o caminho. |
| **O Runner só acessa servidores públicos. Esta URL aponta para uma rede privada.** | Use uma URL acessível pela internet. |
| **Esta URL respondeu, mas não como servidor MCP. Confira o caminho.** | Confira o caminho MCP na documentação do servidor. Ele costuma terminar em `/mcp`. |
| **O Runner não consegue acessar este servidor. Confira a URL e se ele está online.** | Verifique se o servidor está em execução e se a URL está correta. |
| **O servidor recusou a chave. Confira o nome do cabeçalho e a chave.** | Confira os dois valores. Alguns servidores precisam de `Bearer ` antes da chave. |
| **O servidor respondeu, mas não tem ferramentas.** | O servidor não tem ferramentas para esta chave. Confira as configurações do servidor. |
| **Esta loja já tem o máximo de servidores MCP. Remova um primeiro.** | Remova um servidor que você não usa. |

Em **Conectadas**, um servidor que parou de funcionar mostra **Inacessível** ou **Chave recusada**.
Selecione **Corrigir** para abrir o servidor e, depois, substitua a chave ou verifique o servidor.

## Guias relacionados

- [Conectar e controlar aplicativos de agente](./agent-apps)
- [Visão geral de aplicativos e integrações](../apps-and-integrations)
- [Solucionar problemas de conexão de um aplicativo](./troubleshooting)