---
title: Usar Tools MCP no Fluxo
---

# 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ó.

<NoCard kind="mcp.call_tool" categoria="Ações" />

<Secao icon="info">Para que serve</Secao>

É 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.

<Secao icon="clock">Quando usar</Secao>

- 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.

</Dica>

## 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.

<Secao icon="sliders-horizontal">Campos</Secao>

| 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 <code v-pre>{{variavel}}</code>. 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:**

```json
{
  "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}}"
  }
}
```

<Cuidado>

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.

</Cuidado>

## 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) |

## Saiba mais

- [Ferramentas do Agent](/guia/agents/ferramentas) — fluxos em que um Agent decide sozinho qual tool usar.
- [Nó Agent](/guia/flow-builder/ia/agent-no) — alternativa com LLM ao nó determinístico.
- [Ferramenta MCP (ações)](/guia/flow-builder/acoes/ferramenta-mcp) — o nó no contexto das ações do Flow Builder.
- [Cadastrar MCP Server](/dev/cadastrar-mcp-server) — como conectar o servidor usado pelo nó.