Usar Tools MCP no Fluxo

O nó Ferramenta MCP (mcp.call_tool) é o ponto de entrada de qualquer tool MCP dentro de um fluxo. Ele invoca a ferramenta de forma determinística — sem LLM envolvido — e retorna o resultado diretamente para o próximo nó.

Referência do nó

Kind:mcp.call_toolCategoria:Ações

Para que serve

É como um botão de "chamar o serviço externo agora": você define qual servidor, qual ferramenta e quais dados enviar. O nó faz a chamada, aguarda a resposta e a coloca disponível como variável para os próximos nós do fluxo.

Quando usar

• Criar uma cobrança no Asaas assim que o contato confirmar um pedido.
• Gerar um áudio via ElevenLabs com o texto de uma resposta.
• Assinar um documento no ZapSign após o cliente aprovar um contrato.
• Qualquer integração com um servidor MCP previamente cadastrado.

Dica

Como o nó é determinístico (sem LLM), ele é previsível e rápido. Use-o quando a ação é direta — sem necessidade de raciocínio ou tomada de decisão baseada em linguagem natural.

Como o nó aparece no canvas

O nó mcp.call_tool aparece na categoria Ações do painel lateral do Flow Builder, com o ícone de plugue. Após arrastá-lo para o canvas, o painel de configuração exibe três seções:

1. Servidor MCP — dropdown com os servidores conectados no workspace.
2. Ferramenta — dropdown populado automaticamente com as tools do servidor selecionado.
3. Parâmetros — formulário gerado dinamicamente a partir dos descritores da tool.

CAPTURAR: Painel lateral do nó mcp.call_tool mostrando dropdown de servidor, dropdown de tool e campos de parâmetros preenchidos com expressões do fluxo

Campos

Campo	Tipo	Descrição
mcp_server_id	UUID	Qual servidor MCP executará a chamada. Deve estar com status connected.
tool_name	string	Nome da ferramenta a invocar (ex.: criar_cobranca).
parameters	objeto	Mapa de parâmetros exigidos pela tool. Cada valor pode ser um literal ou uma expressão do fluxo.

Mapeando parâmetros com expressões

Os parâmetros aceitam expressões do fluxo no formato {{variavel}}. Você pode referenciar qualquer variável disponível no contexto do fluxo naquele ponto:

# Dados do contato
{{contact.name}}
{{contact.phone}}
{{contact.email}}

# Variáveis definidas por outros nós
{{vars.valor_cobranca}}
{{vars.id_cliente_asaas}}

# Saída de nós anteriores
{{node_resultado_llm.output}}

# Informações da conversa
{{conversation.id}}
{{userinput.query}}

Exemplo prático — criar cobrança no Asaas:

{
  "mcp_server_id": "uuid-asaas-producao",
  "tool_name": "criar_cobranca",
  "parameters": {
    "customer_id": "{{vars.id_cliente_asaas}}",
    "value": "{{vars.valor_cobranca}}",
    "due_date": "{{vars.data_vencimento}}",
    "description": "Honorários — {{contact.name}}"
  }
}

Atenção

Se um parâmetro marcado como required na tool não for mapeado, o nó retornará erro em tempo de execução. O canvas exibe um indicador de campo obrigatório não preenchido antes de você publicar o fluxo.

Saída do nó

O resultado da chamada MCP fica disponível como variável para os nós seguintes:

{{node_{id_do_no}.output}}        # saída bruta da tool
{{node_{id_do_no}.output.status}} # campo específico da resposta

O schema da saída varia conforme a tool. Consulte a documentação da tool específica (acessível no painel de configuração do nó ao clicar em "Ver schema").

Tratando erros

Conecte a saída de erro do nó (on_error) a um nó de lógica (ex.: IF/ELSE ou Enviar Mensagem) para tratar falhas de forma elegante:

mcp.call_tool
  ├── (sucesso) → próximo nó do fluxo
  └── (erro)    → Enviar Mensagem: "Ops, algo deu errado. Tente novamente em instantes."

Diferença entre Ferramenta MCP e Nó Agent

	Ferramenta MCP (mcp.call_tool)	Nó Agent (agent)
LLM	Não	Sim
Raciocínio	Nenhum — execução direta	Decide quando e como usar tools
Uso ideal	Ação pontual e previsível	Tarefa aberta com múltiplas etapas
Latência	Baixa (só a chamada ao servidor)	Maior (inclui inferência do modelo)

Para fluxos em que um Agent precisa decidir qual tool usar, veja Ferramentas do Agent e Nó Agent.

Para mais detalhes sobre o nó no contexto das ações do Flow Builder, veja Ferramenta MCP (ações).