Ferramentas MCP

Um agente com base de conhecimento sabe o que está escrito. Um agente com ferramenta MCP consegue consultar: olhar o status de um pedido no seu sistema, checar um número, buscar um registro. Esta página explica como fazer essa ligação. Ao contrário do resto da documentação, aqui você vai precisar de alguém que saiba o endereço técnico do sistema a conectar.

O que é MCP, em uma frase

MCP é um padrão aberto para expor ferramentas a um agente de IA. Alguém publica um servidor MCP com um conjunto de funções, e o agente passa a poder chamá-las.

No ChatMade, o agente é cliente. Ele se conecta a servidores MCP que já existem — os seus ou os de terceiros — e usa as ferramentas que eles oferecem. O ChatMade não é um servidor MCP e não expõe ferramentas próprias para outros agentes consumirem. Se você procura o caminho contrário, ele não existe aqui.

Onde fica

1. Vá em AI Agents (“Agentes de IA”) → Configure (“Configurar”).
2. Abra a aba MCP Tools (“Ferramentas MCP”).

A tela se apresenta assim: “Connect external tools and services to your agent using the Model Context Protocol (MCP). These tools extend your agent’s capabilities with access to file systems, APIs, databases, and more.” (“Conecte ferramentas e serviços externos ao seu agente usando o Model Context Protocol. Elas ampliam a capacidade do agente com acesso a sistemas de arquivos, APIs, bancos de dados e mais.”)

Há dois botões: Create Tool (“Criar ferramenta”), para cadastrar um servidor novo, e Link Existing (“Vincular existente”), para reaproveitar um servidor já cadastrado na organização.

Bom saber: as ferramentas pertencem à organização, não ao agente. Cadastre uma vez e vincule aos agentes que precisarem dela. Um agente de vendas e um de suporte podem usar o mesmo servidor.

Cadastrar um servidor

Clique em Create Tool. O formulário começa com Quick start presets (“Modelos rápidos”), com dois exemplos prontos — File System (“Sistema de arquivos”) e Weather (“Clima”) — que servem para você ver o formato antes de configurar o seu.

Em Basic information (“Informações básicas”):

• Tool name (“Nome da ferramenta”) — obrigatório. É como você identifica o servidor no painel.
• Description (“Descrição”) — opcional, respondendo à pergunta What does this tool do?

Em seguida vem Transport type (“Tipo de transporte”), a escolha que determina o resto do formulário. São três:

Opção	Como o painel descreve	Quando usar
STDIO	Standard input/output communication	O servidor MCP roda como programa no mesmo servidor do ChatMade.
Server-Sent Events	HTTP streaming communication	Servidor remoto que fala o transporte SSE, mais antigo.
HTTP	Request/response communication	Servidor remoto por HTTP. É o caminho mais comum hoje.

O padrão é STDIO.

Campos do transporte STDIO

• Command (“Comando”) — obrigatório. O programa a executar, como uvx, npx ou node.
• Arguments (“Argumentos”) — adicionados um a um pelo botão Add (“Adicionar”).
• Environment Variables (“Variáveis de ambiente”) — pares de nome e valor. É aqui que entra a chave de acesso do sistema que você está conectando.

Campos dos transportes HTTP e SSE

• Server URL (“URL do servidor”) — obrigatório, no formato https://exemplo.com/mcp.
• Timeout (seconds) (“Tempo limite em segundos”) — padrão 30, aceita de 1 a 300.
• SSE Read Timeout (seconds) — só no transporte SSE. Padrão 60, aceita de 1 a 600.
• HTTP Headers (“Cabeçalhos HTTP”) — pares de nome e valor. É por aqui que passa a autenticação de servidores remotos, tipicamente um cabeçalho Authorization.

Termine em Create Tool (“Criar ferramenta”).

Testar a conexão

Cada ferramenta cadastrada aparece como um cartão com um botão Test (“Testar”), cuja dica diz Connect to the server and list its tools (“Conectar ao servidor e listar suas ferramentas”). É o teste que importa: ele abre a conexão de verdade e enumera o que o servidor oferece.

Dando certo, aparece a lista: ✓ Connected — N tools available, seguida dos nomes.

Dando errado, o cartão mostra a razão. As mensagens mais frequentes:

• “Tool is misconfigured — check its command/args (STDIO) or URL (SSE/HTTP)” — algo está errado na configuração; comece pelo comando ou pela URL.
• “Timed out after 10s connecting to the server” — o servidor não respondeu em dez segundos. Servidor fora do ar, endereço errado ou bloqueio de rede.
• “Connected, but the server exposed no tools” — a conexão funcionou, mas o servidor não oferece nada. Normalmente é autenticação faltando: o servidor conecta e esconde tudo.
• “Failed to connect to the server” — falha genérica de conexão.

Atenção: o rótulo que aparece no cartão como connected ou disabled reflete apenas se a ferramenta está habilitada no cadastro — não é uma verificação ao vivo. A única forma de saber se o servidor está de pé é clicar em Test.

Vincular a um agente

Uma ferramenta cadastrada ainda não está em uso. Clique em Link Existing (“Vincular existente”), encontre a ferramenta na lista e clique em Link (“Vincular”). O botão Unlink (“Desvincular”) desfaz.

Para tirar uma ferramenta de um agente pelo cartão, use Remove (“Remover”) e confirme em Remove Tool.

O que pensar antes de conectar

Uma ferramenta MCP é acesso real a um sistema real, e quem decide chamá-la é um modelo de linguagem conversando com um desconhecido do outro lado. Três cuidados que valem a pena:

Conecte apenas leitura. Consultar status de pedido é uma coisa; cancelar pedido é outra. Prefira servidores que só leem.

Restrinja o escopo da credencial. A chave que você coloca nas variáveis de ambiente ou nos cabeçalhos deve ter o menor acesso possível. Não use a chave de administrador do sistema.

Lembre-se de que o visitante influencia a chamada. O agente decide os parâmetros a partir da conversa. As proteções descritas em Escopo e guardrails elevam bastante o custo de manipular isso, mas não eliminam o risco. Não conecte nada cujo uso indevido você não conseguiria reverter.

Próximo passo

Para o agente responder sobre os seus produtos e as suas políticas, veja Base de conhecimento.