Construir flows con MCP

Pasos

1. 1Crea el flow: create_flow({name: 'Mi flow'}).
2. 2Agrega el trigger: add_node({flow_id, tool_id: ID_DEL_TRIGGER, ...}).
3. 3Agrega nodos de acción: add_node(...) por cada paso del flow.
4. 4Conecta los nodos: connect_nodes({flow_id, source_node_id, target_node_id}).
5. 5Configura cada nodo: configure_node({node_id, config: {...}}).
6. 6Valida el flow: validate_flow({flow_id}) — detecta errores antes de activar.
7. 7Activa en producción: set_production_mode({flow_id, enabled: true}).
8. 8Ejecuta para probar: execute_flow({flow_id, payload: {...}}) con un payload de muestra.

Referencia

IDs cambian por write

Los IDs de nodos se reasignan en cada operación de escritura. Usa get_flow para obtener los IDs actuales antes de una operación.

Layout automático

Llama a layout_flow({flow_id}) después de agregar todos los nodos para organizar el canvas.

execute_flow

Requiere un payload real o de muestra que coincida con lo que el trigger esperaría. Usa get_node_sample para obtener un payload de ejemplo.

Validación

validate_flow detecta nodos huérfanos, configuraciones faltantes y errores de conexión.

Errores comunes

Nodo no encontrado después de add_node

Los IDs se reasignan. Llama get_flow para obtener el ID actual del nodo recién creado.

execute_flow queda en «Waiting»

Casi siempre significa que el número está cableado al webhook de la app del otro entorno (dev vs prod). Verifica que el canal apunta al entorno correcto.

Siguiente paso

Aprende a usar el KV Store desde el MCP.