MCP: Automações
Criar, editar, versionar e acompanhar automações pelo MCP. 11 ferramentas.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.
clone-workflow
Duplica um workflow dentro do mesmo workspace (cópia com novos ids de nós). A cópia nasce em DRAFT.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
create-workflow
Cria um workflow no workspace. Sem definição, nasce vazio (para montar depois com update-workflow). Status padrão: DRAFT.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
name | sim | — |
description | não | — |
definition | não | Definição do workflow no formato React Flow: { nodes: [...], edges: [...], viewport?: { x, y, zoom } }. Substitui a definição inteira — leia com get-workflow, altere e envie de volta. Até 1 MB. |
status | não | — |
variables | não | Variáveis do workflow (nome → valor, texto). Substitui o conjunto inteiro. |
create-workflow-version
Salva uma versão (snapshot) da definição atual de um workflow do workspace, com um nome opcional. Use antes de mudanças grandes com update-workflow.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
name | não | Nome da versão (ex.: "antes do novo nó de e-mail") |
get-workflow
Detalhe de um workflow do workspace: nome, status, versão, nomes das variáveis e a definição completa (nós e arestas no formato React Flow).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
list-workflow-versions
Lista as versões salvas de um workflow do workspace (histórico de snapshots da definição).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
list-workspace-workflows
Lista os workflows (automações) do workspace: id, nome, status, quantidade de nós/arestas e última alteração, do mais recente ao mais antigo (até 100). Use o id em get-workflow e update-workflow.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
status | não | Filtra por status |
search | não | Trecho do nome (sem diferenciar maiúsculas) |
set-workflow-status
Muda o status de um workflow do workspace: ACTIVE (passa a rodar: agendamento/webhook ligados), INACTIVE (para de rodar), DRAFT ou PENDING.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
status | sim | — |
update-workflow
Edita um workflow do workspace: nome, descrição, definição (substitui nós e arestas inteiros) ou variáveis (substitui o conjunto). Só os campos enviados mudam. Para ativar/desativar use set-workflow-status. Dica: crie uma versão (create-workflow-version) antes de mudanças grandes.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workflowId | sim | ID do workflow (veja list-workspace-workflows) |
name | não | — |
description | não | — |
definition | não | Definição do workflow no formato React Flow: { nodes: [...], edges: [...], viewport?: { x, y, zoom } }. Substitui a definição inteira — leia com get-workflow, altere e envie de volta. Até 1 MB. |
variables | não | Variáveis do workflow (nome → valor, texto). Substitui o conjunto inteiro. |
execute-workflow-tool
Dispara um Flow (workflow) do workflow engine pelo flowId. Passa input arbitrário e variáveis opcionais. Ideal para orquestrar múltiplas operações em um único workflow — ex: buscar dados, atualizar estado, enviar notificações.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
flowId | sim | UUID do Flow a executar (deve existir no banco de dados) |
input | não | Payload de entrada para o start-node do Flow. Exemplos: { awb, threadId, paymentMethod, paymentDate } para fluxo de pagamento UPS; { awb, threadId, customerName, refusalReason, conversation } para fluxo de recusa |
variables | não | Variáveis de ambiente a mesclar (ou sobrescrever) com as variáveis padrão do Flow em tempo de execução. Útil para parametrizar sem alterar a definição do Flow |
list-workflow-executions
Lista execuções de workflows. Use flowId para filtrar por workflow específico, status para filtrar por estado (ex: COMPLETED, FAILED, RUNNING), e sorte por data de criação ou execução. Ideal para monitorar o histórico de execuções.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
flowId | não | UUID do workflow para filtrar execuções (opcional) |
status | não | Status das execuções para filtrar (ex: COMPLETED, FAILED, RUNNING, CANCELLED, RETRYING, PENDING, ENQUEUED) |
limit | não | Número máximo de execuções a retornar (padrão: 20, máximo: 100) |
offset | não | Número de registros a pular para paginação (padrão: 0) |
sortBy | não | Campo para ordenar resultados (padrão: createdAt) - createdAt, startedAt, endedAt |
sortOrder | não | Ordem de classificação (padrão: desc - mais recentes primeiro) |
list-workflows
Lista todos os workflows disponíveis. Retorna ID, nome, slug, status e datas. Use para explorar workflows existentes ou buscar por nome/status específico. (Diferente de executions, que são instâncias de execução)
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
name | não | Nome do workflow para filtrar (busca parcial - encontra "teste" em "workflow teste") |
status | não | Status do workflow para filtrar (ex: ACTIVE, INACTIVE, DRAFT) |
search | não | Termo de busca geral que procura simultaneamente em nome, slug e descrição |
limit | não | Número máximo de workflows a retornar (padrão: 50, máximo: 100) |
offset | não | Número de registros a pular para paginação (padrão: 0) |