MCP local · experimental
Alcance del conector MCP local de Fluyio, permisos y límites antes de usar datos reales.
El conector MCP de Fluyio es un proceso local por stdio que consume la API v1. Es experimental: no es una aplicación alojada ni una integración de producción verificada de extremo a extremo.
Qué incluye
| Herramienta | Permiso | Efecto |
|---|---|---|
list_subscribers | subscribers:read | Consulta perfiles con paginación. |
get_subscriber | subscribers:read | Consulta un perfil. |
create_subscriber | subscribers:write | Crea un perfil; no hace upsert. |
update_subscriber | subscribers:write | Cambia nombre, teléfono o propiedades. |
unsubscribe_subscriber | subscribers:write | Registra una baja de canal. |
No tiene herramientas para enviar campañas, borrar perfiles, gestionar listas, consultar métricas ni administrar tiendas. Las etiquetas no se aceptan en crear/editar.
Configuración y precauciones
El proceso requiere una instalación local del conector y una configuración privada del cliente MCP. No hay paquete público oficial ni instalador desde este portal.
FLUYIO_API_KEY: clave privada de la marca, guardada como secreto. Concede solo lectura si no necesitas modificaciones.FLUYIO_API_URL: base de la API. Su valor predeterminado apunta a producción (https://fluyio.com/api/v1).- El transporte usa la versión
2026-05-15y un timeout de 15 segundos. - Las claves
fly_test_están bloqueadas: no existe un sandbox aislado.
El cliente de IA puede pedir confirmación de las herramientas, pero el conector no incorpora su propio sistema de aprobación. Crear, editar y dar de baja son escrituras reales y requieren autorización sobre esa marca y esos perfiles.
Consentimiento y reintentos
Crear sin consentimiento email explícito deja el perfil pendiente. No uses subscribed por defecto. Una escritura acepta idempotency_key; consérvala para el mismo intento. Si no se aporta, se genera una, por lo que repetir la herramienta sin una clave estable no garantiza recuperar el resultado anterior.
El conector no reintenta automáticamente. Una espera agotada no demuestra que no se haya guardado el cambio: consulta el perfil y revisa idempotencia antes de repetir.
Qué se ha verificado
Se han probado el inicio y el listado de herramientas con credenciales ficticias, y el cliente HTTP con respuestas simuladas. La API tiene pruebas aisladas de permisos y persistencia. Queda pendiente conectar tools/call a ese entorno de pruebas para validar cada herramienta de extremo a extremo. No presentes estas comprobaciones como validación de producción.
Para una integración operativa hoy, utiliza HTTP y cURL con los endpoints documentados. Habla con Fluyio si necesitas evaluar el conector local.