# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-10-30T16:29:21.430Z

## Página

- Título: Conectar ferramentas externas por MCP
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-mcp
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cadastre uma conexão MCP, descubra ferramentas e escolha quais ações o agente pode utilizar.

## Seções

- Cadastre a conexão
- Escolha uma ferramenta no agente
- Exemplo amigável
- Teste e manutenção

## Conteúdo da página

# 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](/docs/configuracao/referencias/nodes-agentes-avancados/api-http). Um endpoint de API não se torna um servidor MCP apenas por ser informado neste cadastro.

## Cadastre a conexão

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-mcp" label="Cadastrar uma conexão MCP" path="Configurações > Configuração Básica > IA > Agentes Avançados > MCP"} e crie uma conexão.

![Cadastro de conexão MCP com nome, endpoint e método de autenticação](/docs/screenshots/agentes-avancados/cadastro-mcp.png)

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](/docs/configuracao/referencias/nodes-agentes-avancados/ferramenta-mcp) e [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente).