Cómo Mia funciona con Drupal — Guía de configuración (Servidor MCP)

Cómo Mia funciona con Drupal: Una guía práctica de configuración

Drupal es una de las plataformas CMS más flexibles de la web y, gracias al Model Context Protocol (MCP), ahora puede funcionar mano a mano con Mia, tu secretaria personal de IA. En esta guía, te llevaremos a través de la configuración completa: desde la instalación del módulo del servidor Drupal MCP hasta su conexión con tu chat de Mia.

Al final, Mia podrá leer, crear, actualizar y administrar contenido de Drupal directamente desde tu conversación de Telegram, sin paneles de control ni cambios de contexto.

¿Qué es MCP y por qué debería importarte?

El Model Context Protocol es un estándar abierto (introducido originalmente por Anthropic y ahora compatible con OpenAI y Google) que permite a los agentes de IA hablar con servicios externos a través de una interfaz estructurada y segura.

Un servidor MCP expone herramientas y datos de un sistema (Drupal, en nuestro caso). Un cliente MCP (Mia) se conecta a ese servidor y utiliza esas herramientas en tu nombre.

Para los propietarios de sitios de Drupal, esto significa que puedes hacer cosas como:

Pedirle a Mia que cree o actualice una publicación de blog
Buscar borradores de contenido sin publicar
Listar términos de taxonomía, usuarios o vistas
Iniciar flujos de trabajo (moderación, publicación, programación)
Obtener informes de estado y salud del sitio

Todo desde un solo chat de Telegram.

Prerrequisitos

Antes de comenzar, asegúrate de tener:

Un sitio Drupal 10.x o 11 (PHP 8.1+, configuración estándar de Composer)
Acceso de administrador para instalar módulos
Una cuenta de Mia Handles con al menos un plan Estándar (las conexiones MCP requieren acceso a la API)
El SDK oficial de PHP MCP instalado globalmente o disponible a través de Composer

Paso 1 — Instalar el módulo del servidor MCP de Drupal

El módulo recomendado es mcp_server de Drupal.org; está construido sobre el SDK oficial modelcontextprotocol/php-sdk (colaboración de PHP Foundation + Symfony).

Desde la raíz de tu sitio, ejecuta:

composer require drupal/mcp_server

Luego habilítalo a través de Drush o la UI:

drush en mcp_server -y
drush cr

Alternativamente, ve a Extend → Install new module, sube el archivo y habilítalo.

Después de habilitarlo, navega a Configuration → Web services → MCP Server (/admin/config/services/mcp_server). Allí encontrarás:

Endpoint URL — la URL pública para el punto de conexión MCP (normalmente https://yoursite.com/mcp)
Authentication — Basic auth, token u OAuth (recomendado: token)
Tools and resources — alterna qué capacidades de Drupal se exponen (nodos, usuarios, taxonomía, Vistas, etc.)

Genera un token de API seguro y guárdalo; lo necesitarás en Mia.

Paso 2 — Exponer el punto de conexión de forma segura

El punto de conexión MCP solo debe ser accesible para los servicios en los que confías. Opciones típicas:

Lista blanca de IP — restringe el acceso a la IP del backend de Mia
Autenticación basada en token — cada solicitud debe llevar el token en la cabecera
Red privada / VPC — para configuraciones empresariales

Si tu sitio de Drupal está detrás de Cloudflare o un WAF, asegúrate de que la ruta /mcp esté permitida con los métodos POST y GET, además de SSE si usas streaming.

Paso 3 — Conectar el servidor Drupal en Mia Handles

Ahora la parte divertida. En tu chat de Mia:

Abre la miniapp de Mia (toca tu foto de perfil o usa el menú)
Ve a Settings → Integrations → Add MCP server
Completa el formulario de conexión:

Server name:   Mi sitio de Drupal
Endpoint URL:  https://yoursite.com/mcp
Transport:     Streamable HTTP
Auth:          Bearer token
Token:         (pega tu token MCP de Drupal)

Toca Connect. Mia validará el punto de conexión, listará las herramientas disponibles y agregará el servidor a tu chat.

También puedes conectarte usando un transporte SSE o JSON POST; Mia soporta los tres.

Paso 4 — Probar la conexión

Una vez conectado, intenta un comando simple en tu chat de Mia:

"Lista los últimos 5 artículos sin publicar en mi sitio de Drupal"

Mia debería devolverte un resumen extraído directamente de tu sitio de Drupal. Si obtienes un error, verifica:

Validez del token en la configuración MCP de Drupal
Que la URL del punto de conexión sea accesible desde el backend de Mia (cortafuegos, certificado SSL)
Que las herramientas requeridas estén habilitadas en el lado de Drupal

Lo que puedes hacer después de la configuración

Aquí hay algunas cosas que Mia puede manejar por ti una vez conectada:

Operaciones de contenido — crear borradores, publicar/despublicar, editar campos en masa
Taxonomía y referencias — agregar términos, reorganizar vocabularios
Gestión de usuarios — crear cuentas, restablecer contraseñas, asignar roles
Consultas de Vistas — obtener informes estructurados como Markdown o JSON
Disparadores de flujo de trabajo — mover contenido a través de estados de moderación
Publicación programada — poner en cola artículos para fechas futuras a través de las tareas pendientes o el calendario de Mia

Y como Mia ya conoce tu calendario, tareas y archivos, puede orquestar el trabajo de Drupal junto con el resto de tu día; por ejemplo:

"Publica la entrevista que terminé de grabar esta mañana como un artículo en mi sitio de Drupal, y recuérdale al editor que la revise mañana a las 10:00."

Mia se encargará de ambas cosas a la vez.

Solución de problemas

Síntoma	Causa probable	Solución
"Connection failed"	Punto de conexión bloqueado o URL incorrecta	Verifica las reglas del cortafuegos y el certificado SSL
"No tools available"	Módulo MCP deshabilitado o sin herramientas seleccionadas	Vuelve a habilitar y selecciona al menos una herramienta
"Unauthorized"	Token inválido	Regenera el token en el administrador de Drupal y actualízalo en Mia
Respuestas lentas	Exportaciones de entidades grandes	Deshabilita herramientas no utilizadas, habilita la paginación

Lectura relacionada

El mismo patrón MCP funciona con otras plataformas CMS. Consulta nuestras guías complementarias:

Cómo Mia funciona con WordPress: Una guía práctica de configuración — cubre el plugin mcp-adapter, las Contraseñas de Aplicación y casos de uso específicos de WordPress (medios, comentarios, acciones de plugins, consultas API REST).
El mejor compañero de IA para Bitrix CMS: Conecta Mia a través de MCP — cubre el módulo hiweb.site_mcp, autenticación bearer token, transporte JSON POST y casos de uso específicos de Bitrix (iblocks, pedidos, CRM).

Puedes conectar las tres plataformas al mismo chat de Mia, y ella se dirigirá a cada una por su nombre.

En resumen

Conectar Drupal con Mia a través de MCP convierte tu CMS de un panel de control independiente a una extensión conversacional de tu flujo de trabajo diario. Una vez configurado, simplemente funciona, silenciosamente, en segundo plano, cada vez que lo necesites.

Si tienes preguntas o necesitas ayuda para configurarlo, simplemente pregúntale a Mia directamente en el chat. Ella ya conoce el protocolo.