SA MCP Server para Joomla: controlá tu sitio con inteligencia artificial

Desarrollé SA MCP Server, un componente open source para Joomla 3 y 4 que implementa el protocolo MCP (Model Context Protocol) y permite que asistentes de inteligencia artificial como Claude gestionen el contenido de tu sitio directamente desde una conversación de chat.

¿Qué es el protocolo MCP?

El Model Context Protocol (MCP) es un estándar abierto creado por Anthropic que permite a los asistentes de inteligencia artificial conectarse con herramientas y servicios externos de forma estructurada. En lugar de copiar y pegar contenido entre ventanas, la IA puede consultar y modificar datos directamente, con tu autorización.

Si ya usás Claude Desktop o Claude.ai, probablemente hayas visto los conectores de Google Drive, Gmail o Google Calendar. SA MCP Server hace exactamente lo mismo, pero para tu sitio Joomla.

SA MCP Server: el componente

Se instala como cualquier extensión de Joomla desde el administrador. No requiere configuración de servidor externa, no depende de servicios de terceros y funciona en Joomla 3 y Joomla 4/5 con el mismo paquete.

El componente expone un endpoint HTTP que implementa el protocolo JSON-RPC de MCP. Cada usuario del sitio puede tener su propia URL única con un token de autenticación de 64 caracteres generado automáticamente. Esa URL es la que se configura en el cliente de IA.

¿Cómo funciona la autenticación?

No hay OAuth complicado ni registro de aplicaciones externas. El flujo es simple:

1. Instalás el componente en tu Joomla
2. Desde el panel de administración creás un acceso y asociás un usuario Joomla
3. El sistema genera una URL única con token, lista para copiar
4. Pegás esa URL en la configuración de Claude Desktop (o cualquier cliente MCP compatible)

Si el token se ve comprometido, un clic en "Regenerar Token" lo invalida y genera uno nuevo. La URL anterior deja de funcionar de inmediato.

Gestión de artículos desde la IA

La primera versión del componente incluye un set completo de herramientas para trabajar con artículos de Joomla. Desde una conversación con Claude podés:

• Listar artículos con filtros por categoría, estado, búsqueda de texto y paginación
• Consultar el detalle completo de cualquier artículo por ID, incluyendo metadata, categoría y autor
• Crear artículos nuevos con título, contenido HTML, alias SEF (generado automáticamente si se omite, con verificación de unicidad), categoría, idioma y meta descripción
• Actualizar artículos existentes de forma parcial, modificando solo los campos que se especifiquen
• Enviar artículos a la papelera o eliminarlos definitivamente según se requiera

Todo esto usando el lenguaje natural. Por ejemplo: "Creá un artículo en la categoría Blog sobre los cambios en el servidor, en estado borrador" y Claude lo hace directamente, sin que tengas que abrir el administrador de Joomla.

Panel de administración nativo

El componente aprovecha el sistema de administración de Joomla al 100%. El ABM de usuarios MCP usa JModelList y JModelAdmin nativos, con:

• Listado con buscador, filtro por estado y paginador estándar de Joomla
• Columnas ordenables (usuario, último uso, fecha de creación)
• Toolbar estándar: nuevo, editar, habilitar/deshabilitar, eliminar
• Formulario de edición con selector de usuario Joomla nativo
• URL del MCP visible en el formulario con botón de copiar y snippet de configuración para Claude Desktop

Compatibilidad Joomla 3 y 4

Uno de los requisitos de diseño fue que el mismo paquete funcionara en ambas versiones. Joomla 4 deprecó o eliminó varios helpers de Joomla 3, como JHtml::_('behavior.formvalidation'), el sistema de grillas Bootstrap 2 y el componente Chosen para selects.

La solución fue detectar la versión en runtime con version_compare(JVERSION, '4.0.0', '>=') y renderizar el layout correspondiente en cada template. En Joomla 4 se usa el Web Asset Manager con form.validate y Bootstrap 5, mientras que en Joomla 3 se mantienen los helpers y el grid de Bootstrap 2 originales.

La versión actual incorpora las correcciones necesarias para que el componente funcione correctamente en Joomla 4, resolviendo los errores reportados durante las pruebas iniciales.

Instalación

El repositorio está en GitHub:

https://github.com/alejoasotelo/com_samcpserver

Podés descargar el ZIP desde la sección Releases e instalarlo directamente desde el administrador de Joomla en Extensiones → Instalar. Una vez instalado aparece en el menú de componentes como SA MCP Server.

La configuración en Claude Desktop se reduce a agregar estas líneas en claude_desktop_config.json:

{
  "mcpServers": {
    "joomla": {
      "url": "https://tudominio.com/index.php?option=com_samcpserver&task=mcp&token=TU_TOKEN"
    }
  }
}

Próximas herramientas

El componente está en desarrollo activo. Las próximas versiones van a incluir herramientas para gestión de menú, limpieza de cache, etc. Si querés seguir el desarrollo o contribuir, el repositorio está abierto en GitHub.

¿Querés integrar IA en tu sitio Joomla?

Si gestionás sitios en Joomla y querés explorar cómo la inteligencia artificial puede automatizar la gestión de contenido, o necesitás una extensión a medida, puedo ayudarte. También desarrollo módulos, componentes y plugins de Joomla para cualquier necesidad.

Contactame