Criando Servidores MCP

O Model Context Protocol (MCP) é um protocolo aberto que permite conectar modelos de IA a ferramentas e fontes de dados externas. Um servidor MCP oferece ferramentas externas que os agentes vinculados a ele podem usar, ampliando o que o agente consegue fazer, como consultar o estoque da sua empresa, buscar dados de clientes ou criar tarefas em um sistema interno.

Onde criar

• Na página Competências & MCPs, no botão Criar servidor MCP. O servidor criado aqui fica disponível para ser selecionado em qualquer agente, no campo Competências & MCPs da edição do agente.
• Na edição de um agente, aba Competências & MCPs, em Habilidades e MCPs do agente, clique em "+ Criar" e escolha Servidor MCP. O servidor criado dessa forma é exclusivo deste agente: outros agentes não têm acesso a ele.

O que preencher

• Nome do servidor — um nome para você reconhecer o servidor.
• Descrição (opcional) — serve só como referência para a equipe. Quem descreve as ferramentas para a IA é o próprio servidor.
• E-mail para alertas de falha (opcional) — recebe um aviso quando uma ferramenta deste servidor falhar.
• URL do servidor — endereço HTTP do servidor (transporte HTTP streamable), como https://mcp.example.com/mcp.
• Prévia da URL — atualizada automaticamente, mostra como o endereço final será montado.

Abaixo desses campos, as abas permitem detalhar a conexão:

• Headers — cabeçalhos enviados ao servidor, como informações de acesso.
• Params — cada linha vira um segmento /valor depois da URL do servidor.
• Query Params — cada linha vai na query string da URL.
• Authorization — autenticação usada para acessar o servidor.

Clique em "Salvar servidor MCP" para concluir.

Exemplos práticos

Servidor aberto (sem senha)

Informe apenas o Nome do servidor e a URL do servidor, por exemplo https://ferramentas.minha-empresa.com/mcp. Não é necessário preencher cabeçalhos.

Servidor com token de acesso

Além da URL (https://api.minha-empresa.com/mcp), adicione em Headers o cabeçalho Authorization com o valor Bearer <seu_token>.

Servidor com mais de um campo de identificação

Adicione em Headers um cabeçalho para cada informação de acesso exigida pelo servidor, por exemplo Authorization com Bearer <seu_token> e X-API-Key com a sua chave.

Algo não está funcionando?

O que está acontecendo	O que pode ser	O que fazer
A ferramenta não aparece para a IA	O servidor pode estar desligado ou a URL incorreta	Verifique se o servidor está rodando e se a URL do servidor está correta
Erro de "acesso negado"	Token errado ou ausente	Confira os cabeçalhos em Headers ou a aba Authorization
A conexão cai no meio do caminho	Problema de rede ou servidor sobrecarregado	Tente novamente ou fale com quem mantém o servidor
Uma ferramenta falha com frequência	Erro no servidor	Preencha o E-mail para alertas de falha para ser avisado quando isso ocorrer

Quer saber mais sobre MCP?

Consulte a documentação oficial do Model Context Protocol.