Blackboard MCP · Codex CLI

Blackboard UPC en Codex CLI.

Esta guía conecta tu Aula Virtual UPC con el CLI de Codex de OpenAI 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 OpenAI Codex CLI 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 OpenAI Codex CLI

Agrega la sección al final de ~/.codex/config.toml. Aquí la configuración es TOML, no JSON.

[mcp_servers.campus]
command = "npx"
args = ["campus-cli@2.0.0", "mcp"]

3. Verifica la conexión

Inicia codex y pide la lista de herramientas disponibles: deben figurar las 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 OpenAI Codex CLI.

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 OpenAI Codex CLI?

En ~/.codex/config.toml.

¿Necesito instalar algo además de OpenAI Codex CLI?

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.