ManageBac MCP Server

Локальный MCP-сервер, который позволяет ИИ-агентам (Claude Code, Claude Desktop, OpenCode, ChatGPT и др.) читать ваш аккаунт ManageBac и взаимодействовать с ним: дедлайны, оценки, объявления, ресурсы и сдача заданий.

Он входит через настоящее окно браузера (вы входите один раз), сохраняет сессию локально и использует её повторно — ваш пароль нигде не хранится и не передаётся.

Инструменты

• managebac_get_classes — список ваших классов

• managebac_get_all_deadlines / managebac_get_class_deadlines — предстоящие, прошедшие и просроченные задачи

• managebac_get_grades / managebac_get_class_grades / managebac_get_recent_class_grades — записи оценок

• managebac_get_gpa / managebac_get_class_gpa — GPA, как показано на странице (никогда не вычисляется)

• managebac_get_class_grade_weights — весовые коэффициенты категорий для класса

• managebac_get_announcements — объявления/уведомления со страниц школы и классов

• managebac_get_class_resources — загружаемые файлы/ресурсы (классные работы, материалы) для класса

• managebac_download_file — скачать файл (вложение или href ресурса) в формате base64

• managebac_get_assignment_details — рубрика, инструкции и вложения для одного задания

• managebac_submit_assignment — прикрепить файл (с диска или в base64 для клиентов вроде ChatGPT без доступа к локальным файлам) или текст к заданию; сначала всегда выполняется пробный запуск (dry-run)

• managebac_get_cas_info / managebac_get_ee_info — рефлексии CAS/Extended Essay после разблокировки

• managebac_check_session / managebac_runtime_info — состояние сессии и диагностика процесса

• managebac_list_links / managebac_debug_snapshot — вспомогательные инструменты отладки для поиска путей на страницах

Объявления и ресурсы обрабатываются по мере возможности: структура страниц ManageBac различается в зависимости от школы, поэтому если результаты выглядят неполными, попросите агента использовать managebac_list_links или managebac_debug_snapshot, чтобы найти нужную страницу и передать её как path.

Related MCP server: agentify-desktop

Установка

Требуется 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

Скопируйте env-файл и укажите URL ManageBac вашей школы:

cp .env.example .env

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

Войдите один раз (откроется настоящее окно браузера, сессия будет сохранена, затем окно закроется):

npm run login

Подключение к вашему ИИ-агенту

Большинство MCP-клиентов (Claude Code, Claude Desktop, OpenCode, Cursor) запускают MCP-серверы как локальный процесс. Добавьте нечто вроде этого в их 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"
      }
    }
  }
}

Для Claude Code конкретно поместите это в .mcp.json в корне репозитория, затем выполните /mcp и подтвердите сервер.

Подключение к ChatGPT

ChatGPT подключается к MCP-серверам только по URL (а не через локальный процесс), поэтому вашему локальному серверу нужен временный публичный URL и секретный токен для защиты. Ваш логин ManageBac по-прежнему никогда не покидает вашу машину — через туннель передаются только ответы инструментов, и только пока вы им пользуетесь.

Самый быстрый способ — одна команда:

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

Это собирает сервер, запускает его в HTTP-режиме, открывает быстрый туннель Cloudflare и выводит блок вида:

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

В ChatGPT: Settings → Connectors → Advanced/Developer mode → Add connector, затем вставьте URL и установите Authentication в Bearer token с выведенным токеном.

Держите терминал открытым, пока вы хотите, чтобы у ChatGPT был доступ — закрытие (или Ctrl+C) останавливает и туннель, и сервер. URL и токен каждый раз новые при запуске команды, поэтому после перезапуска вставьте их в ChatGPT заново.

Ручной способ (если вы не хотите добавлять пакет cloudflared): задайте MCP_TRANSPORT=http, MCP_HTTP_PORT=3939 и MCP_HTTP_TOKEN=<a long random value> в .env, выполните npm start, затем направьте любой HTTPS-туннель (например, cloudflared tunnel --url http://localhost:3939, если у вас уже отдельно установлен cloudflared) на порт 3939 и используйте <tunnel-url>/mcp + ваш токен в ChatGPT так же, как описано выше.

Примечания

• .env и .managebac/ (ваша сохранённая сессия) игнорируются git — никогда не коммитьте их.

• Если вы изменяете код или входите заново, перезапустите ваш MCP-клиент, чтобы он подхватил новый процесс.

• Если ManageBac блокирует вашу учётную запись, прекратите повторять автоматический вход и вместо этого используйте npm run login (ручной).

Устранение неполадок

Если дедлайны или GPA выглядят неправильно, используйте инструменты отладки, чтобы посмотреть, что находит парсер:

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

Дополнительно: автоматический вход по паролю

По умолчанию выключено (ручной вход безопаснее). Чтобы включить, укажите в .env:

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