Solución de problemas

Qué hacer cuando la sesión vence, el cliente no encuentra el servidor o no se abre el navegador.

La sesión venció

Qué ves: el agente te dice que se abrió una ventana para entrar al aula.

Entra con Google en esa ventana (suele bastar un clic) y pídele al agente que lo intente de nuevo. Si la ventana no aparece, puede haber quedado detrás de otras. Si aun así no la ves, ejecuta:

npx -y unsada-mcp login

Si el aula rechaza una sesión recién creada, bórrala y entra de nuevo:

npx -y unsada-mcp logout
npx -y unsada-mcp login

Qué ves: “A classroom sign-in window is already open.”

Termina de entrar en la ventana que ya está abierta, o ciérrala, y vuelve a intentarlo. Solo puede haber una a la vez porque comparten el perfil del navegador.

Pasaron cinco minutos sin entrar

Qué ves: “Five minutes passed without the user finishing the sign-in.”

La ventana espera cinco minutos. Ejecuta npx -y unsada-mcp login otra vez cuando puedas completar el login.

No se abre Edge ni Chrome

Qué ves: “Could not open Edge or Chrome to sign in.”

Instala Microsoft Edge o Google Chrome. En Windows, Edge ya viene instalado.
Si tienes los dos y quieres elegir, usa UNSADA_BROWSER=msedge o UNSADA_BROWSER=chrome.
En Linux, instala el paquete oficial de Chrome o Edge.

Versión de Node vieja

Qué ves: un aviso EBADENGINE de npm, o errores apenas arranca el servidor.

Necesitas Node 22 o más nuevo. Compruébalo con node -v y, si es más viejo, instala la versión LTS de nodejs.org. Después cierra y abre de nuevo la terminal y el cliente.

El cliente no encuentra npx (Windows)

Qué ves: el servidor no arranca, con errores como spawn npx ENOENT, Connection closed o -32000.

Algunos clientes no pueden lanzar npx directamente en Windows. Usa cmd /c delante:

claude mcp add unsada -s user -- cmd /c npx -y unsada-mcp

En la configuración JSON:

{
  "mcpServers": {
    "unsada": { "command": "cmd", "args": ["/c", "npx", "-y", "unsada-mcp"] }
  }
}

El agente no ve las herramientas

Reinicia el cliente después de cambiar la configuración. En Claude Desktop, ciérralo también desde la bandeja del sistema.
En Claude Code, claude mcp list muestra si el servidor está conectado.
Revisa que el JSON sea válido: una coma de más basta para que el cliente ignore el archivo.

No encuentro los archivos descargados

Se guardan dentro de la carpeta desde donde el cliente lanzó el servidor; la respuesta de unsada_download trae la ruta completa en directory. Con Claude Desktop esa carpeta puede no ser la que esperas: configura UNSADA_DOWNLOAD_ROOTS como dice Descargas.

No puede leer un archivo

Los .doc y .ppt viejos, .zip, .rar y videos no se pueden leer. El agente te pasa el enlace, o se lo puedes pedir con unsada_download.

Una herramienta devuelve datos raros o vacíos

El servidor lee las mismas páginas que ves en el navegador. Si la UNSAdA actualizó Moodle o cambió el diseño, alguna página puede haber dejado de entenderse. Abre un issue en GitHub con lo que pediste y lo que devolvió, sin pegar datos personales.