ManageBac MCP Server

Ein lokaler MCP-Server, der es KI-Agenten (Claude Code, Claude Desktop, OpenCode, ChatGPT usw.) ermöglicht, dein ManageBac-Konto zu lesen und damit zu interagieren: Abgabefristen, Noten, Ankündigungen, Ressourcen und das Einreichen von Aufgaben.

Er meldet sich über ein echtes Browserfenster an (du meldest dich einmal an), speichert die Sitzung lokal und verwendet sie erneut — dein Passwort wird niemals gespeichert oder irgendwohin gesendet.

Tools

• managebac_get_classes — listet deine Klassen auf

• managebac_get_all_deadlines / managebac_get_class_deadlines — anstehende, vergangene und überfällige Aufgaben

• managebac_get_grades / managebac_get_class_grades / managebac_get_recent_class_grades — Noteneinträge

• managebac_get_gpa / managebac_get_class_gpa — GPA, wie auf der Seite angezeigt (niemals geschätzt)

• managebac_get_class_grade_weights — Kategoriegewichtung für eine Klasse

• managebac_get_announcements — Ankündigungen/Hinweise von der Schul- und Klassenseite

• managebac_get_class_resources — herunterladbare Dateien/Ressourcen (Kursarbeiten, Materialien) für eine Klasse

• managebac_download_file — lädt eine Datei (einen Anhang oder Ressourcen-Href) als base64 herunter

• managebac_get_assignment_details — Bewertungsraster, Anweisungen und Anhänge für eine Aufgabe

• managebac_submit_assignment — hängt eine Datei (von der Festplatte oder als base64 für Clients wie ChatGPT ohne lokalen Dateizugriff) oder Text an eine Aufgabe an; führt immer zuerst einen Dry Run aus

• managebac_get_cas_info / managebac_get_ee_info — CAS/Extended Essay Reflexionen, sobald freigeschaltet

• managebac_check_session / managebac_runtime_info — Sitzungsstatus und Prozessdiagnose

• managebac_list_links / managebac_debug_snapshot — Debugging-Hilfen zum Auffinden von Seitenpfaden

Ankündigungen und Ressourcen werden nach bestem Bemühen bereitgestellt: Die Seitenstruktur von ManageBac variiert je nach Schule. Wenn die Ergebnisse also dürftig aussehen, bitte den Agenten, mithilfe von managebac_list_links oder managebac_debug_snapshot die richtige Seite zu finden, und übergib sie als path.

Related MCP server: Chrome MCP Server

Installation

Erfordert 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

Kopiere die Env-Datei und setze die ManageBac-URL deiner Schule:

cp .env.example .env

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

Melde dich einmal an (öffnet ein echtes Browserfenster, speichert die Sitzung und schließt dann):

npm run login

Mit deinem KI-Agenten verbinden

Die meisten MCP-Clients (Claude Code, Claude Desktop, OpenCode, Cursor) führen MCP-Server als lokalen Prozess aus. Füge etwa Folgendes zu ihrer MCP-Konfiguration hinzu:

{
  "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"
      }
    }
  }
}

Speziell für Claude Code: Füge dies in .mcp.json im Repository-Stammverzeichnis ein, führe dann /mcp aus und genehmige den Server.

Mit ChatGPT verbinden

ChatGPT verbindet sich nur über eine URL mit MCP-Servern (nicht über einen lokalen Prozess). Dein lokaler Server benötigt daher eine temporäre öffentliche URL und ein geheimes Token, um ihn zu schützen. Dein ManageBac-Login verlässt deinen Rechner weiterhin nie — nur die Tool-Antworten überqueren den Tunnel, und das auch nur, solange du ihn nutzt.

Schnellster Weg — ein Befehl:

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

Das baut den Server, startet ihn im HTTP-Modus, öffnet einen Cloudflare-Quick-Tunnel und gibt einen Block wie diesen aus:

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

In ChatGPT: Einstellungen → Connectors → Erweiterter Modus/Entwicklermodus → Connector hinzufügen, füge dann die URL ein und stelle die Authentifizierung auf Bearer-Token mit dem angezeigten Token.

Lass das Terminal geöffnet, solange ChatGPT Zugriff haben soll — das Schließen (oder Ctrl+C) beendet sowohl den Tunnel als auch den Server. URL und Token sind bei jedem Ausführen des Befehls neu. Daher füge sie nach einem Neustart erneut in ChatGPT ein.

Manueller Weg (falls du das Paket cloudflared nicht hinzufügen möchtest): Setze MCP_TRANSPORT=http, MCP_HTTP_PORT=3939 und MCP_HTTP_TOKEN=<a long random value> in .env, führe npm start aus, richte dann ein beliebiges HTTPS-Tunnelwerkzeug (z. B. cloudflared tunnel --url http://localhost:3939, falls du cloudflared bereits separat installiert hast) auf Port 3939 aus und verwende <tunnel-url>/mcp + dein Token in ChatGPT auf dieselbe Weise.

Hinweise

• .env und .managebac/ (deine gespeicherte Sitzung) sind git-ignoriert — committe sie niemals.

• Wenn du den Code änderst oder dich neu anmeldest, starte deinen MCP-Client neu, damit er den neuen Prozess übernimmt.

• Wenn ManageBac dein Konto sperrt, versuche nicht weiterhin, dich automatisch anzumelden, sondern verwende stattdessen npm run login (manuell).

Fehlerbehebung

Wenn Abgabefristen oder GPA nicht stimmen, verwende die Debug-Tools, um zu sehen, was der Scraper findet:

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

Optional: automatische Passwort-Anmeldung

Standardmäßig deaktiviert (manuelle Anmeldung ist sicherer). Zum Aktivieren setze in .env:

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