Errores comunes del MCP

Lista de problemas frecuentes al construir flows con el MCP y cómo resolverlos.

Referencia

IDs se reasignan en cada write: Después de cualquier add_node o configure_node, los IDs de nodos cambian. Siempre llama get_flow para obtener el estado actual antes de la siguiente operación.
WAF bloquea User-Agent default: Cloudflare puede bloquear requests con User-Agent de librerías HTTP genéricas. Configura un User-Agent personalizado (ej: 'MiApp/1.0').
execute_flow espera payload real: execute_flow no simula el trigger. Necesitas pasar un payload que coincida con lo que el canal enviaría. Usa get_node_sample para obtener un ejemplo.
Sim se queda en «Waiting» eterno: El número está cableado al webhook de la app del entorno equivocado (dev vs prod). Verifica en Meta Developer Console qué app tiene el webhook.
Nodo huérfano bloquea el flow: validate_flow detecta huérfanos. Un flow con huérfanos no puede ejecutarse. Conecta o elimina todos los nodos sueltos.
No hay Redis sync cross-worker: Pulbot no usa Redis gestionado para estado cross-instancia. Estado persistente va a MongoDB, no a Redis.
Flows activos = pausar antes de editar: Nunca edites nodos o conexiones de un flow en producción sin pausarlo primero. Excepción: definiciones de tools globales.
list_tools sin category no muestra KV: Para ver tools globales como KV Guardar/Obtener/Borrar, usa list_tools(category='global/all').

Mira ejemplos de código para empezar rápido.