Adicionar seu próprio servidor MCP

Conecte um servidor MCP remoto pela URL e escolha o que o Runner Agent pode fazer com cada ferramenta.

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

Abra seu projeto e selecione Agente → Ferramentas.
Na linha Adicione seu próprio servidor MCP, selecione Adicionar servidor.
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.
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.
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.
Quais agentes podem usá-lo mostra Todos os agentes. Você pode mudar isso por agente depois.
Selecione Confio neste servidor.
Selecione Conectar e encontrar ferramentas. O Runner se conecta ao servidor e lista as ferramentas dele.
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.