ManageBac MCP Server

Un servidor MCP local que permite a los agentes de IA (Claude Code, Claude Desktop, OpenCode, ChatGPT, etc.) leer e interactuar con tu cuenta de ManageBac: plazos, calificaciones, anuncios, recursos y entrega de tareas.

Inicia sesión a través de una ventana de navegador real (tú inicias sesión una vez), guarda la sesión localmente y la reutiliza — tu contraseña nunca se almacena ni se envía a ningún sitio.

Herramientas

• managebac_get_classes — lista tus clases

• managebac_get_all_deadlines / managebac_get_class_deadlines — tareas próximas, pasadas y vencidas

• managebac_get_grades / managebac_get_class_grades / managebac_get_recent_class_grades — registros de calificaciones

• managebac_get_gpa / managebac_get_class_gpa — GPA tal como se muestra en la página (nunca estimado)

• managebac_get_class_grade_weights — ponderación de categorías de una clase

• managebac_get_announcements — anuncios/avisos de las páginas de la escuela y de la clase

• managebac_get_class_resources — archivos/recursos descargables (trabajo de clase, materiales) de una clase

• managebac_download_file — descarga un archivo (un adjunto o un href de recurso) como base64

• managebac_get_assignment_details — rúbrica, instrucciones y adjuntos de una tarea

• managebac_submit_assignment — adjunta un archivo (desde el disco, o base64 para clientes como ChatGPT sin acceso a archivos locales) o texto a una tarea; siempre ejecuta primero una simulación (dry-run)

• managebac_get_cas_info / managebac_get_ee_info — reflexiones de CAS/Extended Essay, una vez desbloqueadas

• managebac_check_session / managebac_runtime_info — estado de la sesión y diagnósticos del proceso

• managebac_list_links / managebac_debug_snapshot — utilidades de depuración para localizar rutas de página

Los anuncios y los recursos se obtienen con el mejor esfuerzo posible: la estructura de las páginas de ManageBac varía según la escuela, así que si los resultados parecen escasos, pídele al agente que use managebac_list_links o managebac_debug_snapshot para encontrar la página correcta y pasarla como path.

Related MCP server: Chrome MCP Server

Instalación

Requiere Node.js 20+.

git clone https://github.com/DH4410/managebac-mcp-server.git
cd managebac-mcp-server
npm install
npm run build
npm run install-browser   # first time only, installs Chromium for Playwright

Copia el archivo env y configura la URL de ManageBac de tu escuela:

cp .env.example .env

MANAGEBAC_BASE_URL=https://your-school.managebac.com

Inicia sesión una vez (abre una ventana de navegador real, guarda la sesión y luego se cierra):

npm run login

Conéctalo a tu agente de IA

La mayoría de los clientes MCP (Claude Code, Claude Desktop, OpenCode, Cursor) ejecutan los servidores MCP como un proceso local. Añade algo como esto a su configuración MCP:

{
  "mcpServers": {
    "managebac": {
      "command": "node",
      "args": ["/absolute/path/to/managebac-mcp-server/dist/index.js"],
      "env": {
        "MANAGEBAC_BASE_URL": "https://your-school.managebac.com",
        "MANAGEBAC_STORAGE_STATE": "/absolute/path/to/managebac-mcp-server/.managebac/storage-state.json"
      }
    }
  }
}

Para Claude Code específicamente, coloca esto en .mcp.json en la raíz del repositorio y luego ejecuta /mcp y aprueba el servidor.

Conéctalo a ChatGPT

ChatGPT solo se conecta a servidores MCP a través de una URL (no a un proceso local), por lo que tu servidor local necesita una URL pública temporal y un token secreto para protegerlo. Tu inicio de sesión en ManageBac sigue sin salir nunca de tu máquina — solo las respuestas de las herramientas cruzan el túnel, y solo mientras lo estés usando.

La vía más rápida — un solo comando:

npm install cloudflared   # one-time; downloads the cloudflared binary (~40MB)
npm run chatgpt

Esto compila el servidor, lo inicia en modo HTTP, abre un túnel rápido de Cloudflare y muestra un bloque como este:

=================================================
 ChatGPT connector settings
=================================================
 URL:   https://random-words.trycloudflare.com/mcp
 Auth:  Bearer token
 Token: 9f2a1c...
=================================================

En ChatGPT: Configuración → Conectores → Modo avanzado/desarrollador → Añadir conector, luego pega la URL y establece Autenticación como Bearer token con el token mostrado.

Mantén la terminal abierta mientras quieras que ChatGPT tenga acceso — cerrarla (o Ctrl+C) detiene tanto el túnel como el servidor. La URL y el token son nuevos cada vez que ejecutas el comando, así que vuelve a pegarlos en ChatGPT tras un reinicio.

Vía manual (si prefieres no añadir el paquete cloudflared): establece MCP_TRANSPORT=http, MCP_HTTP_PORT=3939 y MCP_HTTP_TOKEN=<a long random value> en .env, ejecuta npm start y luego apunta cualquier herramienta de túnel HTTPS (por ejemplo, cloudflared tunnel --url http://localhost:3939 si ya tienes cloudflared instalado por separado) al puerto 3939 y usa <tunnel-url>/mcp + tu token en ChatGPT de la misma manera.

Notas

• .env y .managebac/ (tu sesión guardada) están ignorados por git — nunca los hagas commit.

• Si editas el código o vuelves a iniciar sesión, reinicia tu cliente MCP para que detecte el nuevo proceso.

• Si ManageBac bloquea tu cuenta, deja de reintentar el inicio de sesión automático y usa npm run login (manual) en su lugar.

Solución de problemas

Si los plazos o el GPA parecen incorrectos, usa las herramientas de depuración para ver qué está encontrando el scraper:

managebac_list_links({ "match": "task" })
managebac_debug_snapshot({ "path": "/student/tasks_and_deadlines?view=upcoming" })

Opcional: inicio de sesión automático con contraseña

Desactivado por defecto (el inicio de sesión manual es más seguro). Para activarlo, establece en .env:

MANAGEBAC_LOGIN_MODE=password
MANAGEBAC_EMAIL=your.email@example.com
MANAGEBAC_PASSWORD=your-password