# 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:44:48.597Z

## Página

- Título: Ferramenta MCP
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/ferramenta-mcp
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Seleciona uma ferramenta de uma conexão MCP cadastrada e define seu uso pelo agente.

## Seções

- Onde configurar
- Campos principais
- Entradas, saídas e execução
- Exemplo de uso
- Cuidados
- Como testar

## Conteúdo da página

# Ferramenta MCP

Use **Ferramenta MCP** para disponibilizar uma ação específica de um servidor conectado. O bloco não libera todas as ferramentas do servidor de uma vez.

## Onde configurar

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-builder" label="Configurar um agente avançado" path="Configurações > Configuração Básica > IA > Agentes Avançados > Construtor Agentes Avançados"}, abra o editor visual e selecione **Ferramenta MCP**.

![Configuração do bloco Ferramenta MCP no construtor de Agentes Avançados](/docs/screenshots/agentes-avancados/ferramenta-mcp.png)

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Conexão MCP** | Escolha uma conexão cadastrada e ativa. |
| **Ferramenta MCP** | Selecione uma ferramenta descoberta com formato de entrada suportado. |
| **Esta integração** | Declare consulta ou alteração. |
| **Contrato recebido do MCP** | Consulte o schema recebido para entender as entradas. |
| **Entradas da ferramenta** | Mantenha o contrato e escolha a origem de cada parâmetro. |
| **Campos devolvidos ao agente** | Exponha apenas caminhos úteis ao atendimento. |
| **Resposta para simulação** | Retorno JSON de demonstração para o teste. |

## Entradas, saídas e execução

Recebe uma entrada e possui **Depois · sequência**. Os parâmetros vêm da conversa, do contexto ou de valores fixos, respeitando o contrato recebido do servidor.

## Exemplo de uso

Disponibilize uma ferramenta de consulta de pedido. O agente solicita o código ausente e usa o retorno autorizado para informar a situação. Para alterar o pedido, disponibilize separadamente a ferramenta de escrita e sua política adequada.

## Cuidados

Salve a conexão antes de descobrir ferramentas. Conexão desativada ou ferramenta incompatível não deve ser usada. Alterações no servidor podem exigir nova descoberta e revisão do bloco. Credenciais permanecem no cadastro da conexão.

## Como testar

Confira entrada obrigatória, resposta selecionada e indisponibilidade do servidor. Simulação valida a sequência; execução real é necessária para comprovar a integração. Veja [Conectar ferramentas por MCP](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-mcp).

Veja [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente) e [todos os nodes](/docs/configuracao/referencias/nodes-agentes-avancados).