MCP: Automatizaciones
Crear, editar, versionar y seguir automatizaciones por el MCP. 11 herramientas.
Herramientas de esta área, generadas del código del servidor. Las descripciones vienen de ese código, en portugués. Para conectar, mira el MCP de 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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | 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 | Obligatorio | Descripción |
|---|---|---|
name | sí | — |
description | no | — |
definition | no | 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 | no | — |
variables | no | 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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | ID do workflow (veja list-workspace-workflows) |
name | no | 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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | 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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | 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 | Obligatorio | Descripción |
|---|---|---|
status | no | Filtra por status |
search | no | 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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | ID do workflow (veja list-workspace-workflows) |
status | sí | — |
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 | Obligatorio | Descripción |
|---|---|---|
workflowId | sí | ID do workflow (veja list-workspace-workflows) |
name | no | — |
description | no | — |
definition | no | 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 | no | 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 | Obligatorio | Descripción |
|---|---|---|
flowId | sí | UUID do Flow a executar (deve existir no banco de dados) |
input | no | 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 | no | 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 | Obligatorio | Descripción |
|---|---|---|
flowId | no | UUID do workflow para filtrar execuções (opcional) |
status | no | Status das execuções para filtrar (ex: COMPLETED, FAILED, RUNNING, CANCELLED, RETRYING, PENDING, ENQUEUED) |
limit | no | Número máximo de execuções a retornar (padrão: 20, máximo: 100) |
offset | no | Número de registros a pular para paginação (padrão: 0) |
sortBy | no | Campo para ordenar resultados (padrão: createdAt) - createdAt, startedAt, endedAt |
sortOrder | no | 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 | Obligatorio | Descripción |
|---|---|---|
name | no | Nome do workflow para filtrar (busca parcial - encontra "teste" em "workflow teste") |
status | no | Status do workflow para filtrar (ex: ACTIVE, INACTIVE, DRAFT) |
search | no | Termo de busca geral que procura simultaneamente em nome, slug e descrição |
limit | no | Número máximo de workflows a retornar (padrão: 50, máximo: 100) |
offset | no | Número de registros a pular para paginação (padrão: 0) |