Guía de Directus CMS: El CMS Headless con Enfoque en la Base de Datos

La mayoría de los CMS headless quieren que construyas tu modelo de datos dentro de su sistema. Directus hace lo contrario: envuelve tu base de datos SQL existente y te da APIs REST y GraphQL al instante sin tocar tu esquema. Con ~34.5k estrellas en GitHub y clientes como Tripadvisor, Adobe y Mercedes-Benz, es una de las opciones de código abierto más potentes entre las mejores opciones de CMS headless en 2026.

¿Qué es Directus CMS?

Directus es un CMS headless de código abierto que envuelve cualquier base de datos SQL existente con APIs REST y GraphQL al instante. A diferencia de Strapi o Payload, Directus no crea su propio esquema de base de datos: refleja el tuyo. Soporta 7 bases de datos, incluyendo PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB y MS-SQL, y es gratuito para organizaciones con ingresos inferiores a $5M según la documentación oficial de Directus.

Piénsalo como una capa inteligente que se sienta encima de tu base de datos. Traes una base de datos PostgreSQL existente con 50 tablas, apuntas Directus hacia ella, y en minutos tienes una interfaz de administración completa, control de acceso basado en roles, y endpoints tanto REST como GraphQL. Sin scripts de migración. Sin reestructurar datos.

Esto es lo que "database-first" significa en la práctica, y es fundamentalmente diferente del enfoque code-first que usa Strapi (donde defines tipos de contenido que generan tablas en la base de datos) o el enfoque integrado en el framework de Payload CMS (donde el CMS vive dentro de tu app Next.js).

La arquitectura database-first explicada

Cuando conectamos Directus a una base de datos PostgreSQL existente por primera vez en un proyecto de cliente, lo que nos sorprendió fue lo poco que había que configurar. Directus inspecciona el esquema de tu base de datos — las tablas se convierten en "colecciones", las columnas en "campos" — y construye su interfaz de administración a partir de lo que ya existe.

Esto significa que tus datos nunca quedan atrapados en un formato propietario. Si mañana decides dejar de usar Directus, tu base de datos sigue siendo una base de datos SQL estándar. Intenta hacer eso con Contentful o Sanity, donde tu contenido vive en sus servidores en su formato.

Directus tampoco es solo un CMS. El equipo lo posiciona como una plataforma de datos componible — la gente lo usa como BaaS (Backend as a Service), paneles de administración internos y dashboards personalizados. El caso de uso de CMS es el más popular, pero la arquitectura soporta mucho más.

Características principales de Directus

Directus ofrece APIs REST y GraphQL duales, permisos granulares basados en roles, automatización Flows integrada, un Data Studio con arrastrar y soltar, gestión de activos digitales y soporte nativo de i18n para más de 50 idiomas. Desde v11.15, incluye edición colaborativa y un Asistente de IA como funciones nativas, no como plugins de terceros.

Esto es lo más importante si estás evaluando Directus para un proyecto:

APIs REST y GraphQL duales

Ambas APIs están disponibles simultáneamente desde los mismos datos, sin ninguna configuración. No eliges una u otra — las obtienes ambas. Tu equipo mobile puede usar REST mientras tu frontend web usa GraphQL. La API REST sigue un patrón predecible (/items/{collection}) y el endpoint GraphQL está en /graphql.

Flows y automatización

Flows es el sistema de automatización basado en eventos de Directus, integrado directamente en la interfaz del Data Studio. Puedes activar flujos de trabajo en eventos CRUD (elemento creado, actualizado, eliminado), programaciones (estilo cron), o webhooks. Las operaciones incluyen envío de emails, solicitudes HTTP, ejecución de JavaScript personalizado y transformación de datos.

Para equipos que trabajan con IA, Directus tiene incluso un servidor nativo del Model Context Protocol (MCP), pero hablaremos de eso en la sección de v11.

Extensiones y personalización

El sistema de extensiones admite hooks (manejadores de eventos del lado del servidor), endpoints personalizados, paneles de UI, módulos completos y nodos de operaciones para Flows. Las extensiones se construyen con Vue.js para el frontend y Node.js estándar para el backend. La versión v11.0 reestructuró las extensiones de carpetas basadas en tipos a un formato empaquetado más limpio.

Así se compara Directus con la competencia en funcionalidades:

Novedades de Directus v11 (2025-2026)

Directus v11 introdujo soporte nativo para servidor MCP (v11.13), un Asistente de IA compatible con OpenAI, Anthropic y Gemini (v11.14), edición colaborativa con indicadores de presencia en tiempo real (v11.15) y versiones globales de borrador con permisos de publicación basados en roles (v11.16). Todas son funciones integradas, no extensiones de la comunidad.

Es el área donde Directus ha avanzado más rápido, y la sección que casi todos los competidores ignoran por completo. Solo una de las seis guías mejor posicionadas cubre algo de esto.

Servidor MCP y Asistente de IA

El lanzamiento de v11.13 convirtió a Directus en uno de los primeros CMS con un servidor MCP nativo. Si usas Claude, ChatGPT o cualquier herramienta de IA compatible con MCP, puede gestionar tu contenido de Directus directamente — leyendo colecciones, creando elementos, actualizando campos — todo respetando tus permisos RBAC. Si no conoces MCP, nuestra guía del Model Context Protocol (MCP) explica el protocolo en detalle.

El Asistente de IA (v11.14) es independiente del MCP: es una interfaz de chat integrada dentro del Data Studio que admite OpenAI, Anthropic, Gemini e incluso modelos locales a través de Ollama. En v11.16 se volvió multimodal: puedes subir imágenes y PDFs directamente al chat de IA para procesarlos.

Edición colaborativa y versiones de borrador

La edición colaborativa llegó en v11.15 con indicadores de presencia en tiempo real (puedes ver quién más está editando el mismo elemento) y bloqueo a nivel de campo para evitar conflictos. La misma versión añadió un módulo de despliegue para Vercel con permisos de publicación basados en roles.

La v11.16 llevó más lejos el staging de contenido con versiones globales de borrador. Cada elemento con versiones obtiene automáticamente una copia borrador. Los editores pueden previsualizar los cambios frente a la versión en producción y promover los borradores cuando estén listos. Los permisos de publicación basados en roles permiten que tu equipo de contenido prepare cambios sin publicarlos accidentalmente en producción.

Primeros pasos con Directus (configuración con Docker)

Puedes ejecutar Directus localmente con Docker en menos de 2 minutos. Crea un archivo docker-compose.yml con la imagen directus/directus, establece la conexión a la base de datos y las credenciales de administrador como variables de entorno, y ejecuta docker compose up. Directus arranca en localhost:8055.

La configuración con Docker nos llevó menos de 2 minutos desde cero. Aquí tienes un docker-compose.yml completo con PostgreSQL incluido — no solo el contenedor de Directus, sino toda la pila:

# docker-compose.yml
version: "3"
services:
  database:
    image: postgis/postgis:16-3.4-alpine
    environment:
      POSTGRES_USER: directus
      POSTGRES_PASSWORD: directus
      POSTGRES_DB: directus
    volumes:
      - directus_data:/var/lib/postgresql/data

  directus:
    image: directus/directus:11.16
    ports:
      - "8055:8055"
    depends_on:
      - database
    environment:
      KEY: "your-random-key-here"
      SECRET: "your-random-secret-here"
      ADMIN_EMAIL: "[email protected]"
      ADMIN_PASSWORD: "change-me-please"
      DB_CLIENT: "pg"
      DB_HOST: "database"
      DB_PORT: "5432"
      DB_DATABASE: "directus"
      DB_USER: "directus"
      DB_PASSWORD: "directus"
    volumes:
      - directus_uploads:/directus/uploads

volumes:
  directus_data:
  directus_uploads:

Ejecútalo:

docker compose up -d

Abre http://localhost:8055, inicia sesión con las credenciales de administrador que configuraste, y ya estás dentro del Data Studio. Desde aquí puedes crear colecciones (tablas), definir campos (columnas) y empezar a gestionar contenido de inmediato. Las variables de entorno KEY y SECRET se usan para la generación de tokens JWT — usa cadenas aleatorias en producción, no los valores de ejemplo de arriba.

Consultar datos con el SDK de Directus

El SDK de JavaScript de Directus proporciona acceso con tipos seguros a tus datos tanto a través de REST como de GraphQL. Instala @directus/sdk, crea un cliente con createDirectus(), y usa readItems() para obtener colecciones con filtrado, ordenación y selección de campos integrados.

El patrón componible del SDK se sintió intuitivo después de trabajar con librerías como el cliente de Supabase. Partes de un cliente base y añades capacidades componiendo funciones:

// lib/directus.ts
import { createDirectus, rest, readItems, createItem } from '@directus/sdk';

const client = createDirectus('http://localhost:8055').with(rest());

// Obtener artículos publicados con campos específicos
const articles = await client.request(
  readItems('articles', {
    fields: ['id', 'title', 'slug', 'content', 'author.name'],
    filter: {
      status: { _eq: 'published' }
    },
    sort: ['-date_published'],
    limit: 10
  })
);

Crear elementos sigue el mismo patrón:

// Crear un nuevo artículo
const newArticle = await client.request(
  createItem('articles', {
    title: 'My New Post',
    slug: 'my-new-post',
    content: '<p>Hello from Directus.</p>',
    status: 'draft'
  })
);

Para la autenticación, eliges entre staticToken() (para comunicación servidor a servidor) y authentication() (para aplicaciones con flujos de inicio de sesión de usuario):

import { createDirectus, rest, staticToken } from '@directus/sdk';

// Lado del servidor con token estático
const client = createDirectus('http://localhost:8055')
  .with(staticToken('your-api-token'))
  .with(rest());

Ejemplos con la API REST

Cada método del SDK tiene un endpoint REST equivalente. Si prefieres trabajar directamente con curl o fetch:

# Obtener artículos publicados
curl "http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug"

# Crear un nuevo elemento
curl -X POST "http://localhost:8055/items/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Post", "status": "draft"}'

Consultas con GraphQL

Los mismos datos están disponibles a través de GraphQL en /graphql:

query {
  articles(
    filter: { status: { _eq: "published" } }
    sort: ["-date_published"]
    limit: 10
  ) {
    id
    title
    slug
    content
    author {
      name
    }
  }
}

No necesitas configurar ni activar GraphQL por separado — siempre está disponible junto con REST.

Directus con Next.js (integración con frameworks)

Conectar Directus a Next.js requiere tres pasos: instalar @directus/sdk, crear un cliente lib/directus.ts, y obtener datos en tus Server Components usando readItems(). Directus devuelve JSON puro, así que tienes control total sobre el renderizado sin componentes específicos del proveedor.

Esta es la parte más limpia de trabajar con Directus. No hay ningún adaptador especial para el framework, no hay componentes React específicos de Directus, no hay plugin de build. Solo es obtención de datos. Si has trabajado con cualquier API REST en Next.js, ya sabes cómo funciona esto. Para más contexto sobre la elección de framework, consulta nuestra comparativa de Next.js vs Remix.

Primero, crea el cliente compartido (es el mismo archivo de la sección del SDK, pero configurado para tu instancia desplegada):

// lib/directus.ts
import { createDirectus, rest, staticToken, readItems } from '@directus/sdk';

const directus = createDirectus(process.env.DIRECTUS_URL!)
  .with(staticToken(process.env.DIRECTUS_TOKEN!))
  .with(rest());

export default directus;
export { readItems };

Luego úsalo en un Server Component — sin useEffect, sin estados de carga, solo async/await:

// app/blog/page.tsx
import directus, { readItems } from '@/lib/directus';

export default async function BlogPage() {
  const posts = await directus.request(
    readItems('posts', {
      fields: ['id', 'title', 'slug', 'excerpt', 'date_published'],
      filter: { status: { _eq: 'published' } },
      sort: ['-date_published'],
    })
  );

  return (
    <main>
      <h1>Blog</h1>
      {posts.map((post) => (
        <article key={post.id}>
          <h2><a href={`/blog/${post.slug}`}>{post.title}</a></h2>
          <p>{post.excerpt}</p>
          <time>{post.date_published}</time>
        </article>
      ))}
    </main>
  );
}

Eso es todo. Sin ataduras al proveedor. El mismo enfoque funciona con Astro, Nuxt, SvelteKit o cualquier framework que pueda hacer solicitudes HTTP. La documentación oficial de Directus incluye guías específicas para Astro y Nuxt si las necesitas, pero el patrón es idéntico: crear cliente, llamar a readItems(), renderizar.

Precios y licencias de Directus CMS (2026)

Directus es gratuito para auto-alojarlo bajo licencia MIT para organizaciones con menos de $5M en ingresos anuales o financiación. Por encima de los $5M, se requiere una licencia comercial para uso en producción. Directus Cloud empieza desde $25/mes (Starter), con planes Professional de $49 a $499/mes, según la página de precios oficial.

El umbral de los $5M de ingresos

Este es el dato de negocio más importante sobre Directus, y la mayoría de las guías lo entierran u omiten por completo. Así es como funciona:

• Por debajo de $5M de ingresos anuales o financiación total: Gratuito para siempre. Licencia MIT. Auto-alojar donde quieras. Sin restricciones de funciones.
• Por encima de $5M en producción: Necesitas una licencia comercial. Contacta con el equipo de ventas de Directus para obtener precios.
• Desarrollo y pruebas: Siempre gratuito, independientemente del tamaño de la empresa. El umbral solo aplica a los despliegues en producción.

El número de $5M incluye la financiación de capital riesgo, no solo los ingresos. Una startup en fase seed con $6M de financiación técnicamente supera el umbral. En la práctica, Directus no ha sido agresivo en la aplicación para empresas en etapas tempranas, pero deberías tenerlo en cuenta en tu planificación.

Planes Cloud

Si no quieres gestionar infraestructura, Directus Cloud se encarga del alojamiento, las copias de seguridad y las actualizaciones:

• Starter: $25/mes — ideal para proyectos pequeños y sitios personales
• Professional: $49-$499/mes — escala con almacenamiento, ancho de banda y transformaciones de activos
• Enterprise: Precios personalizados — SLA, infraestructura dedicada, soporte prioritario

Sin licencias por puesto. Todo tu equipo usa el mismo plan. Compáralo con Contentful, que cobra por usuario (consulta nuestro análisis completo de Contentful), o Sanity, que cobra según el uso de la API y el ancho de banda del dataset.

Directus vs Strapi vs Payload: cómo se comparan

Directus envuelve bases de datos existentes sin migración, Strapi genera su propio esquema a partir de tipos de contenido, y Payload se incrusta directamente en tu app Next.js. Directus soporta 7 bases de datos, Strapi 2 y Payload 2. Los tres son de código abierto, pero sus filosofías son bastante diferentes.

Habiendo construido proyectos tanto con Strapi como con Directus, la mayor diferencia es cómo piensan sobre tu base de datos. Con Strapi, defines tipos de contenido en la interfaz de administración o en el código, y Strapi crea y gestiona las tablas de la base de datos por ti. Con Directus, la base de datos es la fuente de verdad — Directus la lee y se adapta.

Cuándo elegir Directus: tienes una base de datos existente, quieres REST+GraphQL dual sin configuración, o necesitas soportar bases de datos menos comunes como OracleDB o CockroachDB.

Cuándo elegir Strapi: quieres el ecosistema y la comunidad más grandes, prefieres definir tipos de contenido a través de una interfaz, o empiezas desde cero sin una base de datos existente. Lee nuestra guía completa de Strapi para más detalles.

Cuándo elegir Payload: quieres el CMS integrado directamente en tu aplicación Next.js, prefieres la configuración TypeScript-first, o necesitas una Local API que omita HTTP completamente. Consulta nuestro análisis profundo de Payload CMS para el panorama completo.

Cuándo NO usar Directus

Directus no es la elección correcta si necesitas un constructor visual de páginas, un framework Next.js estrechamente integrado o un backend NoSQL. También añade complejidad innecesaria para proyectos sencillos donde un CMS de archivos planos o WordPress serían suficientes.

Hemos visto equipos elegir Directus cuando no deberían, y el patrón suele ser uno de estos:

• Necesitas un constructor visual de páginas. El Data Studio de Directus es excelente para la gestión de datos estructurados, pero no es un constructor de sitios con arrastrar y soltar. Si la edición visual es tu prioridad, mira Storyblok — consulta nuestra guía de Storyblok para ver cómo se compara.
• Estás comprometido con NoSQL. Directus es solo SQL por diseño. Si tus datos viven en MongoDB, Payload CMS es la opción natural.
• Tu proyecto es un blog sencillo. Montar Docker, PostgreSQL y Directus para un blog personal es un exceso serio. WordPress, Astro con archivos markdown, o incluso Ghost te pondrán a publicar en una fracción del tiempo.
• Quieres el CMS dentro del framework. Si quieres que tu CMS viva dentro de tu base de código Next.js como un ciudadano de primera clase, Payload hace esto de forma nativa. Directus siempre es un servicio independiente.
• Eres una organización grande. Si tu empresa supera el umbral de $5M de ingresos, necesitarás una licencia comercial para producción. Ten en cuenta ese costo frente a alternativas totalmente open-source como Strapi o Payload, donde el auto-alojamiento es gratuito independientemente de los ingresos.

Ninguno de estos son defectos: son decisiones de diseño. Directus es una plataforma de datos, no un constructor de sitios web. Conocer la diferencia te ahorra meses de frustración.

FAQ

¿Qué es Directus CMS?

Directus es un CMS headless de código abierto que envuelve cualquier base de datos SQL existente con APIs REST y GraphQL al instante. Soporta PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB y MS-SQL. A diferencia de los CMS tradicionales, Directus no crea su propio esquema: lee y refleja la estructura de tu base de datos existente automáticamente.

¿Es Directus realmente gratuito?

Directus es gratuito para auto-alojar bajo licencia MIT para organizaciones con menos de $5M en ingresos anuales o financiación total. Por encima de ese umbral, necesitas una licencia comercial para uso en producción. Los entornos de desarrollo y pruebas son siempre gratuitos. Directus Cloud, su alojamiento gestionado, empieza desde $25 al mes.

¿En qué se diferencia Directus de Strapi?

Directus es database-first: envuelve tu base de datos SQL existente sin modificar el esquema. Strapi es code-first: defines tipos de contenido y Strapi genera las tablas de la base de datos. Directus soporta 7 bases de datos mientras Strapi soporta 2. Ambos ofrecen APIs REST, pero Directus incluye GraphQL nativo mientras Strapi requiere un plugin.

¿Qué bases de datos admite Directus?

Directus soporta siete bases de datos SQL: PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB y MS-SQL. Se conecta a tu base de datos existente e inspecciona el esquema automáticamente. Este soporte multi-base de datos es único entre los CMS headless: la mayoría de los competidores soportan solo uno o dos motores de base de datos.

¿Puede Directus reemplazar WordPress?

Directus puede reemplazar WordPress para la gestión de contenido, especialmente en proyectos headless o basados en API. Sin embargo, Directus no tiene frontend integrado, temas ni constructor de páginas. Tendrás que construir tu propio frontend con un framework como Next.js o Astro. Para blogs sencillos o sitios que necesiten edición visual, WordPress sigue siendo más práctico.

¿Tiene Directus un editor visual?

Directus incluye un Data Studio: una potente interfaz de administración para gestionar datos estructurados, construir dashboards y configurar permisos. Sin embargo, no tiene un constructor visual de páginas ni un editor WYSIWYG de sitios como Storyblok o WordPress. Directus está diseñado para la gestión de datos, no para la composición de páginas con arrastrar y soltar.

¿Es bueno Directus para el comercio electrónico?

Directus funciona bien como sistema de gestión de información de productos: puedes modelar catálogos de productos, gestionar atributos y servir datos vía APIs. Sin embargo, no es una plataforma de comercio electrónico. No tendrás carrito de compras, flujo de pago ni procesamiento de pagos. Combínalo con Shopify, Saleor o Medusa para la capa transaccional.

¿Puedo usar Directus con Next.js?

Sí. Instala el paquete @directus/sdk, crea un cliente que apunte a tu instancia de Directus, y obtén datos en Server Components usando readItems(). Directus devuelve JSON puro, así que no se requieren componentes React específicos del proveedor. El mismo enfoque funciona con cualquier framework JavaScript, incluyendo Astro, Nuxt y SvelteKit.

¿Admite Directus la edición colaborativa?

Sí, desde la versión 11.15 (febrero 2026). Directus tiene edición colaborativa nativa con indicadores de presencia en tiempo real que muestran quién está editando qué, y bloqueo a nivel de campo para prevenir conflictos. Es una función integrada, no un plugin. Combinado con las versiones globales de borrador en v11.16, los equipos pueden preparar y previsualizar cambios antes de publicar.

¿Qué es el servidor MCP de Directus?

Directus introdujo un servidor nativo del Model Context Protocol en v11.13 (noviembre 2025). MCP permite que herramientas de IA como Claude y ChatGPT interactúen directamente con tu contenido de Directus — leyendo, creando y actualizando elementos a través del lenguaje natural. El servidor MCP respeta tus permisos RBAC existentes, de modo que el acceso de la IA sigue las mismas reglas que los usuarios humanos.