Conecta-seEntrar na plataforma

Ferramenta de uma conexão MCP

Executar ferramentas oferecidas por servidores compatíveis com o Model Context Protocol.

Lógica e processamentoAPIs e operações técnicasConexão: Servidor MCP conectado

O que faz

Liste ou execute operações dos servidores MCP configurados e das conexões gerenciadas. Use o ID de um servidor ou de uma conexão gerenciada e o nome exato da operação, inclusive referências a blocos anteriores.

Quando usar: Use quando o seu fluxo precisar executar ferramentas oferecidas por servidores compatíveis com o Model Context Protocol.

Exemplo de situação: Automatizar uma operação técnica sem executar o trabalho manualmente.

Antes de começar

Conexão necessária: Servidor MCP conectado.

Conecte e teste o servidor MCP em Configurações e escolha só a ferramenta de que este fluxo precisa.

Passo a passo

  1. Adicione Ferramenta de uma conexão MCP ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte e teste o servidor MCP em Configurações e escolha só a ferramenta de que este fluxo precisa.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Operação

    Escolhe qual ação este bloco executará.

    Padrão:
    run

  • Servidor MCP

    Obrigatório

    Escolha entre os servidores MCP configurados no workspace.

    Exemplo:
    (escolha na lista do campo)

  • Servidor MCP

    ObrigatórioEm campos adicionais

    Informe o ID do servidor ou da conexão, ou uma referência.

  • Argumentos

    Valores de entrada da ferramenta escolhida na conexão MCP; os campos aparecem conforme o que a ferramenta pede e podem usar dados de blocos anteriores.

    Quando aparece:
    Quando o campo “tool” for diferente de “” e o campo “Operação” for diferente de “list”

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <ferramentadeumaconexaomcp.serverId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<ferramentadeumaconexaomcp.serverId>stringID do servidor MCP ou da conexão informado.
<ferramentadeumaconexaomcp.operations>jsonOperações autorizadas (name, description, inputSchema).
<ferramentadeumaconexaomcp.nextCursor>stringCursor de paginação da próxima página, ou null.
<ferramentadeumaconexaomcp.hasMore>booleanIndica se há mais operações autorizadas disponíveis.
<ferramentadeumaconexaomcp.content>arrayLista de conteúdo da resposta da ferramenta MCP — o formato padrão de todas as ferramentas MCP.

Exemplo de uso

Objetivo: Automatizar uma operação técnica sem executar o trabalho manualmente.

InícioFerramenta de uma conexão MCPpróxima etapa
Operação
run
Servidor MCP
(escolha na lista do campo)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <ferramentadeumaconexaomcp.serverId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.

Blocos relacionados