Resolución de problemas
Falla la validación de la licencia
«Credenciales no válidas»: la clave de licencia y el secreto del panel deben ser el par emitido conjuntamente. Si rotaste las credenciales, el plugin todavía tiene 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.
«La URL no coincide»: el sitio que llama no coincide con la URL registrada en el panel. Es habitual cuando Moodle está detrás de un proxy y $CFG-wwwroot difiere del nombre de host público, o tras un cambio de dominio. Actualiza la URL en Organización → Moodle y vuelve a validar.
El plugin no llega al panel: tu Moodle necesita salida HTTPS. Comprueba curl https://moodlemcp.com desde el servidor y los ajustes de proxy de Moodle.
No se puede conectar el sitio
«URL no permitida»: la URL debe ser pública, con HTTPS y certificado válido. localhost, los rangos privados y los hosts solo accesibles por VPN se rechazan por diseño. Un sitio de pruebas sirve si es accesible públicamente.
Errores de certificado: un certificado autofirmado o caducado no supera la validación. Arregla el certificado; no hay forma de saltárselo.
El asistente dice que no tiene herramientas
- El cliente no ha recargado su configuración MCP. Reinícialo.
- La URL es incorrecta: debe ser el subdominio de tu organización y terminar en /mcp.
- Con clave Bearer: comprueba que la cabecera sea 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 no ve nada en Moodle
La clave funciona, pero el usuario de Moodle asociado no tiene acceso a lo que preguntas. Los roles son el límite exterior: una clave de estudiante no puede listar los participantes de un curso. Comprueba 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.
Las llamadas fallan después de haber funcionado
- La clave se suspendió o revocó, desde el panel o desde el plugin.
- Se rotaron las credenciales 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, en Administración del sitio → Servidor → Servicios web → Gestionar tokens.
Organización → Moodle → Uso muestra los errores por clave y por herramienta, lo que normalmente lo localiza en segundos.
Un archivo no se sube
La URL debe devolver el archivo, 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 archivos. Si la herramienta no aparece, tu plugin es demasiado antiguo: actualízalo.
El chat no aparece o no responde
- No hay ninguna clave MCP seleccionada como identidad del chat en Organización → Moodle.
- 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
La prueba ha terminado o ha fallado un pago. Suscríbete o corrige el método de pago en Organización → Facturación. Mientras está bloqueada no se borra nada.
Si sigues atascado
Anota el error exacto, los 4 últimos caracteres de la clave (nunca la clave entera) y la hora a la que ocurrió, y abre una incidencia en github.com/studiolxd/moodle-local_mcpconnector/issues.