# Preguntas frecuentes y problemas de evoMCP

> Respuestas sobre qué puede hacer evoMCP y soluciones a los problemas habituales: 401, 404, 429, herramientas que no aparecen y aprobaciones pendientes.

# Preguntas frecuentes y problemas de evoMCP

## Preguntas generales

### ¿Incluye evoMCP un modelo de IA?

No. evoMCP es el servidor al que se conecta el asistente que elijas. Ejecuta las llamadas autorizadas y devuelve el resultado. El proveedor del asistente recibe los datos que las herramientas devuelven; en la pantalla de consentimiento de OAuth se avisa de ello.

### ¿Qué clientes se pueden conectar?

Cualquier cliente MCP con transporte HTTP. La pestaña Conectar del panel explica Claude (web y escritorio), ChatGPT, Claude Code y los clientes con token, como Cursor. Las instrucciones paso a paso están en [Primeros pasos](https://evoaddons.com/es/documentacion/evomcp-primeros-pasos).

### ¿Puede el asistente hacer más que mi usuario?

No. Cada conexión se ejecuta con la identidad y la ACL de un usuario de Joomla, y el permiso efectivo es el mínimo entre la matriz de la conexión y lo que ese usuario puede hacer en el panel.

### ¿Qué ve un asistente por defecto?

Una conexión nueva empieza con lectura de contenido. Usuarios, pedidos y leads quedan desactivados hasta que los concedas. Además, `evomcp_capabilities` le dice qué puede hacer y qué componentes existen sin estar concedidos.

### ¿Todo queda pendiente de aprobación?

Con el modo recomendado, sí: toda herramienta de escritura. Hay otros dos modos y algunas acciones piden aprobación siempre. La tabla está en [Configuración](https://evoaddons.com/es/documentacion/evomcp-configuracion), y la lista por herramienta, en la [referencia](https://evoaddons.com/es/documentacion/evomcp-referencia).

### ¿Puedo ver lo que ha hecho un asistente?

Sí. La auditoría registra cada llamada con la conexión, el usuario, la herramienta, el resultado y la latencia. Guarda los nombres y tamaños de los argumentos, no su texto. El panel avisa si la cadena de hashes deja de verificarse.

### ¿Qué pasa con el contenido que crea un asistente?

Queda como borrador, con su procedencia registrada: conexión, fecha y quién lo revisó. Cuando una persona guarda en el panel un artículo creado por un agente, se registra como revisado.

### ¿Qué pasa si caduca la licencia?

La extensión sigue funcionando. Solo dejan de llegar las actualizaciones. Los precios, los niveles y la clave de descarga están en [Licencias y actualizaciones](https://evoaddons.com/es/documentacion/licencias-y-actualizaciones) y en la página de precios.

### ¿Es compatible con Joomla 6?

\[PENDIENTE: el instalador exige Joomla 5.0 o superior y no hay en el repositorio una prueba contra Joomla 6\]

## Problemas

### Recibo un 401 aunque el token es correcto

Apache sin el `.htaccess` de Joomla no pasa la cabecera `Authorization` a PHP. Activa las reglas de reescritura de Joomla o añade `SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1`. Comprueba también que la conexión no esté revocada ni caducada y que la petición venga de una de las IP permitidas, si has definido alguna. Si has regenerado el token, el anterior ha dejado de valer.

### `/mcp` responde 404

Hay dos causas. La primera: el endpoint está desactivado en las opciones («Endpoint activo»). La segunda: la petición no llega a `index.php` de Joomla porque faltan las reglas de reescritura del servidor web.

### Responde 403 «Origen no permitido»

La petición lleva una cabecera `Origin` que no es la del propio sitio ni está en «Orígenes permitidos (opcional)». Añade el origen del cliente, por ejemplo `https://claude.ai`, uno por línea. Las peticiones de servidores, sin cabecera `Origin`, no se ven afectadas.

### Recibo un 429

Hay tres límites: 600 peticiones por minuto por IP (fijo), el «Límite de peticiones por minuto y conexión» y la «Cuota mensual de llamadas» de la conexión. Con los dos primeros, espera un minuto. La cuota se renueva el mes siguiente o la puedes subir en la conexión.

### Claude o ChatGPT no consiguen conectar

Mira el bloque «Antes de conectar» de la pestaña Conectar: el sitio debe usar HTTPS y una dirección pública. Un `localhost`, una red interna o un dominio de pruebas no es alcanzable desde un asistente en la nube. Si tu hosting tiene un cortafuegos de aplicaciones web, puede bloquear las peticiones, sobre todo si llegan muchas seguidas.

### La pantalla de acceso dice que no tengo ninguna conexión disponible

OAuth no crea conexiones. Un administrador tiene que crear antes una conexión asignada a tu usuario; entonces la verás en la pantalla de consentimiento. Mira [Primeros pasos](https://evoaddons.com/es/documentacion/evomcp-primeros-pasos).

### El asistente no ve una herramienta que debería tener

- Una herramienta que la conexión no puede usar no se lista. Pídele que ejecute `evomcp_capabilities`.
- Si has concedido el permiso hace poco y la conexión entra por OAuth, reconecta el conector para que el cliente refresque la lista.
- Las herramientas de YOOtheme solo existen si la plantilla YOOtheme está instalada.
- Las de la capa avanzada necesitan sus tres cerrojos: plugin habilitado, interruptor encendido y permiso `full`.
- Las áreas de administración (usuarios, extensiones, configuración, sistema, capa avanzada y entidades genéricas) solo las concede un Super User al crear la conexión. Las de sistema las usa, además, un usuario con permiso de administración en Joomla.

### Una escritura devuelve `pending_approval`

Es lo esperado. La acción espera en Componentes → evoMCP → Aprobaciones. El asistente puede consultar el resultado con `evomcp_approval_status`. Si nadie la decide en 24 horas, pasa a «Caducadas» y hay que pedirla de nuevo.

### Dice que hay demasiadas acciones pendientes

Cada conexión admite hasta 50 aprobaciones pendientes. Resuelve algunas en Aprobaciones o espera a que caduquen.

### Aprobé la acción, pero falló

La acción se ejecuta con la identidad del usuario de la conexión, no con la de quien aprueba. Si ese usuario no tiene permiso en Joomla, o los datos ya no son válidos, falla y el panel muestra el motivo («La acción se aprobó pero no pudo ejecutarse»).

### Una herramienta de YOOtheme rechaza el cambio

Las herramientas que cambian una página del constructor exigen que el grupo del usuario de la conexión tenga el filtro de texto de Joomla en «Sin filtro» (Contenido → Opciones → Filtros de texto). Sin él, la herramienta se niega para no romper el JSON del constructor.

### La respuesta es demasiado grande

El límite es 1 MB por respuesta. Usa paginación o filtros más estrictos.

### La cadena de auditoría no se verifica

El panel muestra «ATENCIÓN: la cadena de auditoría no se verifica; alguien ha modificado o borrado entradas». Es la señal de que se han tocado filas de la tabla de auditoría fuera de evoMCP. Las solicitudes de privacidad que seudonimizan a un usuario recalculan la cadena y no la rompen.

### La tarea de mantenimiento no se ejecuta

Es una tarea del programador de Joomla: Sistema → Tareas programadas, «evomcp: mantenimiento». Comprueba que está habilitada y que el programador de Joomla se dispara, por visita o por cron.

---

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