Servidores MCP

Um servidor MCP (Model Context Protocol) é um sistema externo que oferece ferramentas prontas para os agentes usarem. Em vez de criar uma API Externa por operação, você registra o servidor uma vez e ele publica o próprio catálogo de ferramentas.

São dois passos: registrar o servidor na solução e liberá-lo no agente.

1. Registrar na solução

Vá a Configurações → MCP Servers e clique em Adicionar MCP Server.

Campo	O que informar
Nome	Um rótulo para identificar o servidor nas telas
URL	O endereço do servidor MCP
Credencial	Uma credencial delegada a esta solução, quando o servidor exige autenticação
Habilitado	Desmarque para desligar o servidor sem apagar o cadastro
Avançado	Opções adicionais, como o tratamento do conteúdo devolvido e o limite de tamanho do resultado

Depois de salvar, o servidor aparece na lista da aba.

2. Liberar no agente

Registrar não basta: cada agente escolhe quais ferramentas daquele servidor pode usar. Abra o editor do agente e vá até a aba MCP.

1. Habilite o servidor para este agente.
2. Selecione as ferramentas que ele pode acionar — a seleção pode ser parcial.

Libere apenas o que o agente realmente precisa. Ferramenta liberada é ferramenta que o agente pode chamar, e excesso de opções piora a escolha.

Quando algo não funciona

Sintoma	Causa provável
O servidor não lista nenhuma ferramenta	URL errada, servidor fora do ar ou credencial inválida
O agente não usa a ferramenta	O servidor não foi habilitado no agente, ou a ferramenta não foi selecionada
A ferramenta some depois de uma atualização do servidor	Ela foi renomeada do outro lado; volte à aba MCP do agente e selecione o novo nome
O resultado chega cortado	O limite de tamanho de resultado, em Avançado

Renomear ferramenta quebra a seleção

A seleção é gravada pelo nome da ferramenta. Se o servidor renomear uma delas, o agente perde a ferramenta silenciosamente — nada falha, ela apenas deixa de existir para ele. Depois de qualquer atualização do servidor, confira a aba MCP dos agentes que o utilizam.