Atende Direito · Docs

Appearance

Ferramenta MCP · mcp / mcp.call_tool ​

Para que serve

Imagina um controle remoto com botões programados: você aperta o botão "enviar e-mail" e o e-mail é enviado; aperta "gerar boleto" e o boleto é criado — sem interpretação, sem variação, direto ao ponto. O nó Ferramenta MCP funciona assim: você escolhe uma ferramenta de um serviço conectado (Asaas, ElevenLabs, Resend, etc.) e ela é executada de forma determinística, sem passar por um modelo de IA.

A diferença para o Nó Agent é justamente essa: o MCP não raciocina, não interpreta, não escolhe. Ele simplesmente executa a ferramenta exata que você configurou, com os parâmetros que você definiu — confiável como um script.

Quando usar
  • Gerar um boleto ou cobrar via Asaas
  • Enviar um e-mail transacional via Resend
  • Coletar assinatura eletrônica via ZapSign
  • Converter texto em áudio via ElevenLabs
  • Rastrear processos no AdvBox
  • Qualquer integração que precisa de precisão, sem variação comportamental

Pré-requisitos ​

Antes de usar este nó, o servidor MCP correspondente precisa estar cadastrado e conectado na plataforma. Veja como fazer isso em Cadastrar um Servidor MCP.

Passo a passo
  1. Arraste o nó **Ferramenta MCP** para o canvas e conecte ao fluxo.
    CAPTURAR: nó mcp.call_tool no canvas conectado a um nó anterior de dados

    CAPTURAR: nó mcp.call_tool no canvas conectado a um nó anterior de dados

  2. No painel, selecione o **Servidor MCP** que você quer usar. A lista mostra apenas servidores conectados e com status `connected`.
    CAPTURAR: dropdown de servidor MCP mostrando servidores disponíveis com status connected

    CAPTURAR: dropdown de servidor MCP mostrando servidores disponíveis com status connected

  3. Escolha a **Ferramenta** disponível naquele servidor. A lista é carregada automaticamente após selecionar o servidor.
    CAPTURAR: dropdown de ferramenta mostrando as tools disponíveis no servidor selecionado

    CAPTURAR: dropdown de ferramenta mostrando as tools disponíveis no servidor selecionado

  4. Mapeie os **Parâmetros** — cada ferramenta tem seus próprios campos obrigatórios e opcionais. Use expressões {{ }} para preencher com dados do fluxo.
    CAPTURAR: painel de parâmetros do nó mcp.call_tool com campos preenchidos usando variáveis do fluxo como <span v-pre>{{contact.name}}</span> e <span v-pre>{{contact.phone}}</span>

    CAPTURAR: painel de parâmetros do nó mcp.call_tool com campos preenchidos usando variáveis do fluxo como <span v-pre>{{contact.name}}</span> e <span v-pre>{{contact.phone}}</span>

  5. Salve. O resultado da ferramenta fica disponível como {{mcp.result}} para os nós seguintes.
Campos
CampoO que faz
Servidor MCPQual serviço usar (mcp_server_id) — ex.: Asaas, Resend, ZapSign
FerramentaQual ação executar (tool_name) — ex.: create_invoice, send_email
ParâmetrosOs dados necessários para a ferramenta — mapeados via expressões do fluxo

Saídas ​

VariávelConteúdo
resultResposta da ferramenta (JSON)
successBooleano indicando se a execução foi bem-sucedida
errorMensagem de erro (quando success é false)

MCP vs. Nó Agent: qual usar? ​

SituaçãoUse
Quero executar uma ação específica com dados exatosFerramenta MCP (determinístico)
Quero que a IA decida qual ferramenta usar e como usá-laNó Agent (com MCP configurado no agent)
Preciso de múltiplas ferramentas encadeadas por lógica de IANó Agent
Preciso de previsibilidade total no que será executadoFerramenta MCP
Exemplo

Cenário: após fechar um acordo, o fluxo gera automaticamente um boleto e envia por e-mail.

Nó 1 — Ferramenta MCP (Asaas):

  • Servidor: Asaas
  • Ferramenta: create_invoice
  • Parâmetros:
    • customer: {{contact.asaas_id}}
    • value: {{negocio.valor}}
    • dueDate: {{data_vencimento}}

Nó 2 — Ferramenta MCP (Resend):

  • Servidor: Resend
  • Ferramenta: send_email
  • Parâmetros:
    • to: {{contact.email}}
    • subject: "Seu boleto está disponível"
    • html: "Olá, {{contact.name}}! Seu boleto: {{mcp.result.invoiceUrl}}"
CAPTURAR: sequência de dois nós mcp.call_tool no canvas: primeiro gerando boleto no Asaas, segundo enviando e-mail via Resend com o link do boleto

CAPTURAR: sequência de dois nós mcp.call_tool no canvas: primeiro gerando boleto no Asaas, segundo enviando e-mail via Resend com o link do boleto

Dica

Para usar uma ferramenta que não está no catálogo curado, cadastre um Servidor MCP Customizado. Veja o guia completo em Para Desenvolvedores.

Saiba mais ​