Conectar ferramentas externas por MCP

Uma conexão MCP permite disponibilizar ferramentas de um servidor externo para o agente. Você cadastra o servidor uma vez e seleciona, em cada bloco Ferramenta MCP, a ferramenta autorizada para aquela tarefa.

Para uma API HTTP comum, use API HTTP. Um endpoint de API não se torna um servidor MCP apenas por ser informado neste cadastro.

Cadastre a conexão

Acesse Cadastrar uma conexão MCP e crie uma conexão.

Ampliar

1. Informe um nome que identifique o sistema, como Consulta de pedidos.
2. Em Endpoint MCP, use o endereço fornecido pelo responsável pelo servidor.
3. Escolha Autenticação: sem autenticação, Bearer token, Basic ou chave em header.
4. Preencha os campos exigidos pelo método escolhido.
5. Salve a conexão antes de descobrir ferramentas.
6. Com a conexão ativa e salva, clique em Descobrir ferramentas.

Credenciais pertencem ao cadastro da conexão. Não as inclua no objetivo do agente, em conhecimento ou em mensagens de teste.

Escolha uma ferramenta no agente

1. Abra o agente e adicione Ferramenta MCP.
2. Selecione a conexão e a ferramenta descoberta.
3. Em Esta integração, informe se consulta ou altera informações.
4. Revise Entradas da ferramenta: cada valor pode vir da conversa, do contexto ou de um valor fixo.
5. Em Campos devolvidos ao agente, selecione somente o necessário para a resposta.
6. Descreva Quando oferecer esta capacidade em termos do seu atendimento.

O contrato de entrada vem da ferramenta descoberta. Parâmetros obrigatórios ausentes devem ser coletados ou mapeados antes da execução. Uma ferramenta marcada como incompatível precisa ter seu contrato revisado no servidor; não invente outro formato de entrada no prompt.

Exemplo amigável

Para consultar um pedido, o servidor pode oferecer uma ferramenta que recebe um código e devolve situação e previsão de entrega. Configure o código para vir da conversa e exponha somente os campos relevantes do resultado. O agente pergunta o código quando faltar e usa o retorno para responder.

Os nomes reais da ferramenta, dos parâmetros e dos resultados dependem do servidor conectado. Confira-os na descoberta antes de montar o fluxo.

Teste e manutenção

Primeiro simule o resultado do bloco. Depois execute um teste real controlado, com registro de demonstração e sem ações indesejadas no sistema externo.

Se o endpoint, a autenticação ou o contrato mudar, salve a conexão, descubra novamente as ferramentas e revise os blocos que a utilizam. Para uso interno, confira a política de confirmação das ferramentas de escrita. No atendimento externo, a autorização é definida pelo fluxo.

Veja Ferramenta MCP: campos e conexões e Testar o agente.