# Requisitos e instalación de evoMCP

> Requisitos de Joomla y PHP, qué incluye el paquete pkg_evomcp, cómo instalarlo y qué queda activado y qué no tras la instalación.

# 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

1. Descarga `pkg_evomcp-<versión>.zip` desde tu cuenta. Los detalles de la clave de descarga están en [Licencias y actualizaciones](https://evoaddons.com/es/documentacion/licencias-y-actualizaciones).
2. En Joomla, abre Sistema → Instalar → Extensiones y sube el ZIP.
3. Cuando termine, abre Componentes → evoMCP. Ya puedes seguir con los [primeros pasos](https://evoaddons.com/es/documentacion/evomcp-primeros-pasos).

## Qué queda activado

En una instalación nueva, el instalador habilita:

- el plugin de sistema,
- todos los plugins del grupo `evomcp` salvo 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](https://evoaddons.com/es/documentacion/evomcp-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.

---

https://evoaddons.com/es/documentacion/evomcp-instalacion