Blackboard MCP · Cursor

Blackboard UPC en Cursor.

Esta guía conecta tu Aula Virtual UPC con Cursor, el editor con IA mediante Model Context Protocol. Al terminar podrás preguntarle por tus cursos, tareas, notas y materiales sin abrir Blackboard.

¿Usas ChatGPT o Claude en el navegador, o en el móvil? Esta guía es para el cliente de escritorio, que ejecuta Campus en tu computadora. Los chats del navegador y del móvil no pueden hacer eso, así que necesitan la versión que no instalas nada.

Antes de empezar

Necesitas tres cosas: Node.js 22 o superior instalado, una cuenta activa de UPC con acceso a Aula Virtual y Cursor ya funcionando en tu equipo. El proceso completo toma unos cinco minutos y se hace una sola vez.

1. Inicia sesión en tu campus

En una terminal, ejecuta:

npx campus-cli@2.0.0 account login

Se abre el navegador y encadena el login de Microsoft de UPC, con MFA si tu cuenta lo pide. Si Microsoft muestra «Stay signed in?», marca la casilla y acepta: así la sesión se mantiene y no tienes que repetir el login cada día. Todo el flujo corre en tu máquina, no pasa por ningún servidor de Campus.

2. Registra el servidor en Cursor

Ve a Settings → MCP → Add new MCP server, o edita directamente ~/.cursor/mcp.json.

{
  "mcpServers": {
    "campus": {
      "command": "npx",
      "args": ["campus-cli@2.0.0", "mcp"]
    }
  }
}

3. Verifica la conexión

En Settings → MCP, la entrada campus debe aparecer con un indicador verde y la lista de herramientas blackboard_*.

Luego prueba con una pregunta real:

«¿Qué tareas tengo pendientes esta semana?»
«¿Cuál es mi nota actual en cada curso?»
«Descarga los PDFs de la última semana de clase y resúmelos.»

Si algo no funciona

El fallo más común es un JSON inválido: una coma de más o unas comillas sin cerrar hacen que el cliente ignore el archivo entero sin avisar. Comprueba también que npx campus-cli@2.0.0 mcp arranque sin error directamente en la terminal — si ahí falla, el problema no está en Cursor.

Si el servidor conecta pero las respuestas dicen que no estás autenticado, tu sesión expiró: vuelve a correr npx campus-cli@2.0.0 account login. Y recuerda cerrar el cliente por completo antes de reabrirlo; recargar la ventana no siempre relee la configuración.

Qué puedes hacer después

Las herramientas disponibles, el detalle de seguridad y las limitaciones actuales están en la página principal de Blackboard MCP. Si prefieres consultar tu campus por comandos en vez de por chat, existe Blackboard CLI. Y para saber qué revisar cada semana antes de automatizarlo, lee la guía para organizar tu semana en Blackboard sin perder fechas.

Preguntas frecuentes

¿Dónde va el archivo de configuración MCP de Cursor?

En ~/.cursor/mcp.json.

¿Necesito instalar algo además de Cursor?

Solo Node.js 22 o superior. El comando npx descarga campus-cli la primera vez que se ejecuta.

¿Qué hago si las herramientas no aparecen?

Cierra el cliente por completo y vuelve a abrirlo, verifica que el JSON no tenga comas de más y confirma que npx campus-cli@2.0.0 mcp arranca sin error en la terminal.