Requisitos e instalación de evoMCP
Requisitos
| Requisito | Valor |
|---|---|
| Joomla | 5.0 o superior [PENDIENTE: el instalador del componente solo comprueba 5.0.0, pero el README del producto dice 5.3 o superior; confirmar cuál es el mínimo probado] |
| PHP | 8.1 o superior |
| YOOtheme Pro | Solo para las herramientas del constructor. Sin la plantilla YOOtheme instalada, el plugin de YOOtheme no registra sus herramientas. [PENDIENTE: versión mínima de YOOtheme Pro] |
| Base de datos | La que use Joomla. La instalación crea diez tablas con tu prefijo, cuyo nombre empieza por evomcp_ |
| Dirección del sitio | HTTPS y pública si vas a conectar asistentes en la nube (Claude, ChatGPT). Un sitio local o de pruebas solo sirve para clientes que se conectan desde tu propio equipo |
El instalador del componente comprueba la versión de PHP y la de Joomla y cancela la instalación con un mensaje si no se cumplen.
La ruta /mcp y las de OAuth (/oauth/... y /.well-known/...) no pasan por el enrutador de Joomla. Las atiende el plugin de sistema, pero la petición tiene que llegar hasta index.php. Con las reglas de reescritura habituales de Joomla (.htaccess en Apache) funciona. [PENDIENTE: regla equivalente para nginx, no está documentada en el repositorio]
Qué incluye el paquete
pkg_evomcp instala diez extensiones:
| Extensión | Para qué sirve |
|---|---|
com_evomcp |
Panel de administración: conexiones, aprobaciones, uso, auditoría y guía de conexión |
plg_system_evomcp |
Atiende el endpoint /mcp y las rutas de OAuth |
plg_evomcp_content |
Herramientas de artículos y categorías |
plg_evomcp_joomla |
Menús, módulos, medios, usuarios, extensiones, plantillas, configuración y tareas programadas |
plg_evomcp_yootheme |
Herramientas del constructor y del tema de YOOtheme Pro |
plg_evomcp_entities |
Entidades genéricas, opciones de componentes y copias previas |
plg_evomcp_system |
Operaciones del sistema: actualizaciones, instalación, configuración, caché, registros |
plg_evomcp_advanced |
Capa avanzada de SQL y ficheros |
plg_privacy_evomcp |
Exportación y borrado de datos de un usuario para las herramientas de privacidad de Joomla |
plg_task_evomcp |
Tarea diaria de mantenimiento |
Los plugins de otras extensiones evo (evoLeadGate, evoOrigin, evoYTAccess) registran sus propias herramientas cuando están instaladas. Se instalan con esas extensiones, no con este paquete.
Instalar
- Descarga
pkg_evomcp-<versión>.zipdesde tu cuenta. Los detalles de la clave de descarga están en Licencias y actualizaciones. - En Joomla, abre Sistema → Instalar → Extensiones y sube el ZIP.
- Cuando termine, abre Componentes → evoMCP. Ya puedes seguir con los primeros pasos.
Qué queda activado
En una instalación nueva, el instalador habilita:
- el plugin de sistema,
- todos los plugins del grupo
evomcpsalvo la capa avanzada, - el plugin de privacidad y el de tareas.
La capa avanzada se instala deshabilitada y no se habilita nunca sola, ni al instalar ni al actualizar. Para usarla hay que seguir los tres cerrojos que se describen en la referencia.
El instalador también crea, una sola vez, la tarea programada «evomcp: mantenimiento», que se ejecuta cada 24 horas. Puedes cambiarla o desactivarla en Sistema → Tareas programadas.
Al actualizar, los plugins del grupo evomcp que la nueva versión trae y que no existían antes se habilitan, salvo la capa avanzada.
Si recibes un 401 con un token válido
Apache sin el .htaccess de Joomla no pasa la cabecera Authorization a PHP. Activa las reglas de reescritura de Joomla o añade esta línea a la configuración de Apache:
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
El endpoint también lee la variante REDIRECT_HTTP_AUTHORIZATION, que Apache rellena en algunas configuraciones.
Actualizar
El paquete trae su sitio de actualización de Joomla. Al actualizar desde el propio Joomla, las migraciones de tablas se aplican con el sistema de esquemas de Joomla. Antes de actualizar en producción, haz una copia del sitio.