Falla la validación de la licencia
«Credenciales inválidas» — la clave de licencia y el secreto del panel tienen que ser el par emitido junto para esa conexión. Si rotaste las credenciales, el plugin sigue con el par antiguo: pega el nuevo. Si solo copiaste uno de los valores antes de salir de la página, rota para obtener un par nuevo. Si tienes varios Moodle, comprueba que no has pegado el par de otra conexión.
«La URL no coincide» — el sitio que llama no coincide con la URL registrada para la conexión. Es habitual cuando Moodle está detrás de un proxy y $CFG-wwwroot difiere del nombre público, o después de un cambio de dominio. Actualiza la URL desde la fila de la conexión en Organización → Moodle y vuelve a validar.
El plugin no llega al panel — tu Moodle necesita salida HTTPS. Prueba curl https://lmsmcp.slxd.app desde el servidor y revisa los ajustes de proxy de Moodle.
No se puede conectar el sitio
«URL no permitida» — la URL tiene que ser HTTPS pública con certificado válido. localhost, los rangos privados y los hosts accesibles solo por VPN se rechazan por diseño. Un sitio de preproducción vale si es accesible públicamente.
Errores de certificado — un certificado autofirmado o caducado no pasa la validación. Arregla el certificado; no hay forma de saltárselo.
No quedan plazas de conexión — tu plan limita cuántos sitios Moodle puede conectar una organización; la página de conexiones dice cuántas quedan. Elimina una conexión que ya no uses o sube de plan en Organización → Facturación.
El asistente dice que no tiene herramientas
- El cliente no ha recargado su configuración MCP. Reinícialo.
- La URL es incorrecta: tiene que ser la URL de conector de esa conexión — el subdominio de tu organización, después /mcp/lmsmcp/ y el slug de la conexión. Cópiala de la página de la conexión en vez de escribirla.
- Con clave Bearer: comprueba que la cabecera es exactamente Authorization: Bearer mcpk_… y que la clave no está suspendida, revocada ni caducada.
- Con OAuth: elimina el conector y vuelve a autorizar.
El asistente responde sobre el Moodle equivocado, o le rechazan
Cada clave pertenece a una conexión y solo funciona contra la URL de conector de esa conexión. Usar la clave de un Moodle contra la URL de otro se rechaza. Comprueba, en la página de la conexión, que la clave que presentas está listada ahí.
La conexión aparece como «Sin plugin» o «Sin respuesta»
Comprobar ahora, en la página de la conexión, pregunta en vivo a tu Moodle:
- Sin plugin — Moodle responde, pero el plugin del conector no está instalado ahí. Descárgalo con Descargar el plugin (.zip) e instálalo.
- Sin respuesta — Moodle no respondió: el sitio está caído, la URL cambió o el token de la clave usada para la comprobación ya no vale en Moodle.
- Sin clave activa — la comprobación necesita un token, así que crea antes una clave para esa conexión.
El asistente no ve nada en Moodle
La clave funciona, pero el usuario de Moodle subyacente no tiene acceso a lo que preguntas. Los roles son el límite exterior: la clave de un estudiante no puede listar los participantes de un curso. Revisa para qué usuario se emitió la clave y si está restringida a solo lectura, a herramientas concretas o a cursos concretos. Consulta claves y permisos.
«Access control exception» al crear o editar
El rol de una clave se comprueba una vez, a nivel de sitio; Moodle comprueba los permisos por curso. Una clave de profesor con permiso de edición tiene permitida la herramienta, pero Moodle la rechaza en un curso donde ese usuario no es profesor con permiso de edición. Comprueba que el usuario para el que se emitió la clave:
- está matriculado en ese curso con un rol que conceda la capacidad moodle/course:manageactivities (crear y editar actividades);
- puede ver el curso, si está oculto.
Matricularlo en el curso, o darle un rol con esa capacidad, resuelve el error. Consulta claves y permisos.
Las llamadas empezaron a fallar después de funcionar
- La clave se suspendió o revocó, en el panel o desde el plugin.
- Se rotaron las credenciales de la conexión y el plugin no se ha actualizado.
- El usuario de Moodle perdió el rol del que depende la clave, o se eliminó.
- El token se borró en Moodle desde Administración del sitio → Servidor → Servicios web → Gestionar tokens.
La página de la conexión muestra su uso y sus errores por clave y por herramienta, y Organización → Moodle → Uso muestra el de toda la organización; entre las dos se suele localizar en segundos.
Un fichero no se sube
La URL tiene que devolver el fichero, no una página que lo envuelve. Pruébala con curl -IL url desde fuera de tu red. Google Drive, Dropbox y GitHub necesitan cada uno una forma concreta de URL — consulta subir ficheros. Si la herramienta no aparece siquiera, tu plugin es demasiado antiguo; actualízalo.
El chat no aparece o se niega a responder
- No hay ninguna clave MCP seleccionada como identidad del chat con IA en Organización → Moodle. El chat responde sobre la conexión de la clave que elijas.
- El saldo de créditos no cubre el mensaje — recarga en Organización → Créditos.
- Has alcanzado el límite de 10 mensajes por minuto. Espera un momento.
La organización está bloqueada
Terminó la prueba o falló un pago. Suscríbete o corrige el método de pago en Organización → Facturación. Nada se borra mientras está bloqueada.
Sigues atascado
Anota el error exacto, los 4 últimos caracteres de la clave (nunca la clave entera) y la hora en que ocurrió, y abre una incidencia en github.com/studiolxd/moodle-local_mcpconnector/issues.