ComandeskHelp Inicio

MCP Site Connectors And Flowtitude Draft Generation

Estado: fase 2 propuesta

Fecha: 2026-05-09

Objetivo

OPS debe poder conectarse a servidores MCP de distintos sitios web para orquestar trabajo real sin acoplarse a la implementacion interna de cada sitio. En el caso de WordPress, Flowtitude Builder Bridge puede actuar como ejecutor nativo: expone capacidades MCP, OPS decide el flujo, el agente razona y el sitio aplica cambios controlados.

La primera aplicacion practica sera crear tareas de diseno que generen paginas como borrador en un sitio concreto. No se contempla publicacion automatica en la fase inicial.

Principios

  • OPS orquesta; el sitio ejecuta mediante MCP.
  • Cada sitio se configura como conector independiente por workspace o proyecto.
  • Toda generacion de paginas empieza como borrador.
  • Las operaciones sensibles se dividen en descubrimiento, propuesta, dry-run, aprobacion y ejecucion.
  • Las credenciales viven en OPS como credenciales de workspace, nunca en documentos ni prompts.
  • Las abilities se descubren y clasifican antes de usarse.
  • Si no se puede verificar el estado final, la tarea pasa a review o waiting, no a done.

Modelo Conceptual

Site Connector

Representa un servidor MCP externo asociado a un sitio.

Campos propuestos:

  • workspace_id
  • project_id
  • name
  • kind: flowtitude_mcp, generic_mcp
  • base_url
  • mcp_endpoint
  • auth_credential_id
  • environment: local, staging, production
  • default_builder: bricks, elementor, unknown
  • status: draft, active, paused, error
  • last_capability_sync_at
  • metadata

Capability Inventory

OPS no debe asumir que un sitio tiene todas las abilities. Debe sincronizarlas con tools/list y guardarlas con clasificacion operativa.

Campos propuestos:

  • site_connector_id
  • tool_name
  • ability_name
  • title
  • description
  • risk_level: read_only, dry_run_write, managed_write, destructive, elevated
  • builder: bricks, elementor, wordpress, design, unknown
  • supports_dry_run
  • requires_confirmation
  • enabled
  • last_seen_at

Flujo De Conexion

  1. El usuario crea un conector de sitio en OPS.
  2. OPS guarda endpoint MCP y credencial en el workspace.
  3. OPS ejecuta una prueba read-only.
  4. OPS llama a tools/list.
  5. OPS clasifica abilities por riesgo.
  6. OPS muestra un resumen claro: sitio, entorno, builder detectado, abilities disponibles y bloqueos.
  7. El conector queda activo solo si supera el smoke test.

Smoke Test Minimo

Para Flowtitude Builder Bridge, el smoke test inicial debe ser solo de lectura:

  • inicializar conexion MCP;
  • listar herramientas;
  • leer resumen del sitio si existe ability disponible;
  • listar plugins o tema activo si existe ability disponible;
  • leer sistema de diseno o memoria si existe ability disponible;
  • ejecutar health check de pagina solo sobre una URL segura si se proporciona.

Si falla cualquier paso critico, el conector queda en error con mensaje accionable.

Tareas De Diseno En Borrador

Una tarea de diseno vinculada a un sitio debe tener estos campos operativos:

  • sitio destino;
  • builder preferido;
  • objetivo de la pagina;
  • audiencia;
  • idioma;
  • restricciones visuales;
  • pagina de referencia opcional;
  • modo de salida: siempre draft;
  • nivel de autonomia permitido.

Flujo recomendado

  1. OPS crea o recibe la tarea.
  2. El agente lee contexto del proyecto y del sitio.
  3. El agente descubre abilities disponibles.
  4. El agente genera una propuesta: estructura, secciones, copy, componentes y riesgos.
  5. Si la tarea pide aprobacion previa, queda en waiting.
  6. El agente ejecuta dry-run cuando la ability lo permita.
  7. OPS registra evidencia del dry-run.
  8. Con aprobacion o politica permitida, el agente crea la pagina como borrador.
  9. El agente ejecuta validaciones: pagina recuperable, builder tree valido, editor abre si existe check, health check si procede.
  10. OPS pasa la tarea a review con URL del borrador, resumen y evidencia.

Politica De Seguridad Inicial

Para la fase 2, estas reglas deben ser obligatorias:

  • No publicar paginas automaticamente.
  • No modificar paginas publicadas sin crear copia o borrador.
  • No ejecutar destructive/elevated abilities desde tareas de diseno.
  • No usar credenciales globales si existe credencial de workspace.
  • No pasar secretos al prompt del agente.
  • No marcar done si no hay evidencia de verificacion.
  • En produccion, exigir aprobacion humana para cualquier write real.

Estados OPS Recomendados

  • next: tarea preparada, sin ejecucion.
  • doing: agente trabajando o usuario editando.
  • waiting: falta respuesta humana o decision de propuesta.
  • review: borrador creado o propuesta lista para revisar.
  • done: trabajo validado y aceptado.

Cuando una tarea necesita una decision humana, debe bloquearse en waiting con una pregunta concreta. El usuario no deberia buscar en comentarios dispersos para saber como continuar.

Simplificacion Del Sistema

La experiencia debe sentirse como un flujo natural:

  1. Elegir sitio.
  2. Describir lo que se quiere.
  3. Revisar propuesta.
  4. Crear borrador.
  5. Revisar resultado.

La UI no debe exponer primero la complejidad de MCP, abilities o builders. Esa informacion debe estar disponible en detalle tecnico, pero el camino principal debe hablar en terminos de trabajo: sitio, pagina, propuesta, borrador, revision.

Integracion Con Flowtitude Builder Bridge

Flowtitude ya ofrece una base compatible:

  • endpoint MCP por sitio WordPress;
  • discovery de herramientas;
  • abilities de diagnostico, diseno, Bricks, Elementor y administracion;
  • control de abilities desde admin;
  • dry-run, confirmaciones y changelog para operaciones sensibles.

OPS debe tratar Flowtitude como un ejecutor externo versionable, no como una dependencia interna. El contrato entre ambos debe ser MCP + abilities + evidencia.

Entregables De La Fase 2

  1. Modelo de conector MCP por sitio.
  2. Pantalla simple para alta y prueba de conector.
  3. Sincronizacion de capabilities.
  4. Plantilla de tarea "crear pagina como borrador".
  5. Flujo de propuesta y bloqueo waiting.
  6. Ejecucion dry-run cuando exista.
  7. Creacion de borrador controlada.
  8. Evidencia y pase a review.
  9. Documentacion how-to y runbook de seguridad.
  10. Verificacion de docs online: enlaces internos, CSS y paginas HTML publicadas.

Fuera De Alcance Inicial

  • Publicacion automatica.
  • Cambios destructivos.
  • Migraciones masivas de paginas.
  • Edicion directa de paginas publicadas sin copia.
  • Conectores genericos MCP sin clasificacion de riesgo.
  • Automatismos multi-sitio sin aprobacion humana.

Criterio De Aceptacion

La fase se considera lista cuando un usuario puede:

  1. registrar un sitio Flowtitude MCP;
  2. comprobar que OPS detecta abilities reales;
  3. crear una tarea de diseno para ese sitio;
  4. recibir una propuesta clara;
  5. aprobar la creacion;
  6. obtener una pagina WordPress en borrador;
  7. revisar evidencia y URL desde OPS;
  8. repetir el flujo sin conocer detalles tecnicos de MCP.