IWHWI
IWHWI: framework IA para gestionar sus contenidos Directus vía MCP.
Los CMS headless como Directus exponen colecciones y campos, mientras que Strapi o Contentful exponen content types y campos - pero cada uno con sus propias convenciones, su propio SDK y sus propias limitaciones. Resultado: su modelo de contenido queda prisionero de una herramienta, sus automatizaciones deben rehacerse con cada migración y la industrialización sigue siendo artesanal.
IWHWI (Interface Web Headless with Intelligence) es nuestro framework propietario en Clean Architecture que resuelve este problema. Introduce una capa de abstracción por encima del CMS: los Content Types - compuestos de Nodes (bloques estructurales) y Fields (campos de negocio) - se modelan en el dominio de negocio, independientemente del adaptador CMS utilizado. Directus, que no posee nativamente el concepto de Content Type (a diferencia de Strapi o Contentful), es el primer adaptador implementado - el caso más complejo. Los demás CMS, que ya disponen de este concepto, seguirán.
Gracias al protocolo MCP (Model Context Protocol), un asistente IA puede crear estructuras, sincronizar datos, traducir contenido y pilotar todo el ciclo de vida - todo desde una conversación. Descubra a continuación la arquitectura, los conceptos clave y las capacidades concretas de este framework.
Clean Architecture y abstracción CMS
IWHWI se basa en una Clean Architecture de cuatro capas: Domain (entidades, nodos, campos), Infrastructure (adaptadores CMS, fuentes de datos), Interface (servidor MCP, comandos IA) y Usecase (fachadas, servicios). El dominio de negocio está totalmente desacoplado del CMS: el adaptador Directus implementa una interfaz genérica (ICmsAdapter) que otros CMS podrán implementar.
Content Types: una abstracción por encima del CMS
Los CMS headless como Strapi o Contentful integran nativamente el concepto de Content Type. Directus, en cambio, solo maneja colecciones y campos individuales - sin capa de abstracción. Por eso IWHWI fue diseñado partiendo de Directus, el caso más bajo nivel, introduciendo los Content Types compuestos de Nodes (bloques estructurales) y Fields (campos de negocio). Por ejemplo, el Content Type « categories » se define en IWHWI con 4 Nodes (1 init, 2 lang, 1 supp) y campos adicionales. Bajo Directus, esta definición se traduce automáticamente en 3 colecciones (categories, categories_base, categories_seo) con todas las relaciones necesarias. El Supp Node no es una colección separada: añade un grupo de campos directamente en la colección principal. Esta abstracción, pensada para el caso más complejo, será aún más fácil de adaptar a los CMS que ya poseen este concepto.
Sistema de Nodes
- Init Node: colección principal (identificadores, estado, metadatos).
- Lang Node: colecciones vinculadas al Content Type languages (contenido traducido por idioma).
- Flag Node: colecciones vinculadas al Content Type countries (configuraciones por país).
- Supp Node: grupos de campos añadidos a la colección principal (imágenes, parámetros).
Migración desde CMS tradicionales
Gracias a esta capa de abstracción, IWHWI también puede servir como puente de migración entre los CMS tradicionales y los CMS headless modernos. El objetivo: recuperar el contenido estructurado de un sitio existente - WordPress, Joomla + Seblod, Joomla + K2, Joomla + FlexiContent o Drupal + CCK - mapearlo hacia los Content Types IWHWI y luego enviarlo al CMS headless destino (Directus, Strapi, Contentful...). Todos estos sistemas almacenan tipos de contenido con campos personalizados, accesibles mediante sus API REST o sus bases de datos. IWHWI será probado en estos escenarios de migración para validar este enfoque.
Campos en tres capas
Los campos se gestionan independientemente del CMS en tres niveles: Types (definiciones base de interfaces), Generics (campos de negocio reutilizables) y Specifics (campos específicos de un nodo). Cada campo es un archivo separado, importado y compuesto dentro de los nodos.
Arquitectura en capas y sistema de nodos
IWHWI sigue una arquitectura Domain-Driven Design en cuatro capas. La capa Domain define las entidades de negocio: campos tipados (genéricos y específicos), nodos (Init, Lang, Supp, Flag) y tipos de contenido (páginas, bloques, categorías, etc.). Cada tipo de contenido se declara de forma declarativa, con sus nodos y campos.
Este enfoque garantiza que el modelo de negocio permanezca independiente de la infraestructura técnica.
La capa Infrastructure gestiona el almacenamiento, la sincronización y los adaptadores externos. Los datos se organizan en carpetas versionadas (aXXXX), cada una con tres espacios: default (referencia fija), directus (estado actual del CMS) e ia (contenido generado por IA). Los registros (registry) mantienen la correspondencia entre identificadores locales y UUIDs de Directus.
Este sistema permite un seguimiento completo de versiones y trazabilidad de cada modificación.
Integración MCP y pilotaje por IA
El protocolo MCP (Model Context Protocol) permite a un asistente IA (Claude, GPT) ejecutar acciones en sistemas externos. IWHWI implementa un servidor MCP que expone todas sus órdenes como herramientas IA: creación de estructuras Directus, gestión de fuentes, sincronización, traducción, inspección de campos y relaciones.
La IA no se limita a sugerir: ejecuta directamente las operaciones en tu CMS.
Los comandos MCP cubren todo el ciclo de vida: structure (crear/eliminar colecciones y campos), source (crear, actualizar, eliminar ítems), sync (sincronizar Directus → local), translate (traducir automáticamente), local (gestionar archivos de traducción), util (inspeccionar campos, relaciones, ítems). Cada comando está documentado y tipado.
El asistente IA dispone de control completo y seguro sobre tu instancia Directus.
Al elegir IWHWI para la gestión de sus contenidos, se beneficia de:
- un framework concebido para industrializar la gestión de contenidos Directus,
- una integración nativa con la IA mediante el protocolo MCP,
- un flujo versionado y reproducible (source/sync) compatible con Git,
- traducción automática multilingüe y generación de tipos TypeScript,
- un puente de migración para recuperar contenido de CMS tradicionales (WordPress, Joomla + Seblod/K2/FlexiContent, Drupal + CCK) hacia un headless moderno.
IWHWI convierte la gestión de contenidos en un proceso automatizado, fiable y pilotado por la inteligencia artificial. Contáctenos para una demostración.