MCP 服务器

getcourse-mcp

Automates a GetCourse account from an AI agent — grant lesson/training access, manage users and groups — with no official API.

README

getcourse-mcp

Automate a GetCourse account from an AI agent — grant lesson/training access, manage users and groups — with no official API.

English · Русский

</div>

Why

GetCourse has no public API for the things admins do every day — opening a lesson for a student, adding someone to a training, moving users between groups. Those actions live only in the admin UI.

getcourse-mcp exposes them as MCP tools. It drives a browser you're already logged into over CDP, so it reuses your real session cookie and CSRF token — no scraping of passwords, no fragile API keys. An AI agent (Claude, etc.) can then find a user, inspect their groups and grant access in one turn.

🔑 Uses your live session — connects over CDP to a logged-in Chromium/Yandex browser
👥 Access by groups — the GetCourse model: training/lesson access = group membership
🧩 5 focused tools — status, find user, list groups, check membership, add to groups
🪶 TypeScript, ESM — thin, strict, MIT, no account secrets in the repo

How access works in GetCourse

Access to a training (and its lessons) is granted by group membership. "Full access" to a course often means membership in a Module 1 group plus a group that starts the drip schedule (module 1 now, the rest on a timer). To "give access like another student", read their groups and reproduce them:

gc_find_user            # student@example.com → id, name
gc_check_membership     # which of these groups is student X in?
gc_add_user_to_groups   # add student Y to the same groups

Requirements

A Chromium-based browser (Chrome / Yandex) launched with a debug port on a separate profile, logged into your account:
```
browser.exe --remote-debugging-port=9222 --user-data-dir=C:\gc-cdp-profile
```
Node ≥ 18.

Setup

npm install
cp .env.example .env      # set GETCOURSE_BASE_URL (and GETCOURSE_CDP_URL if not :9222)
npm run build

{
  "mcpServers": {
    "getcourse": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": { "GETCOURSE_BASE_URL": "https://your-account.getcourse.ru" }
    }
  }
}

Tools

Tool	Purpose
`gc_status`	Check that an admin is logged in in the CDP browser.
`gc_find_user`	Find a user by email → id, name, type, status.
`gc_list_training_groups`	Access groups of a training (id + name).
`gc_list_user_groups`	Groups a user belongs to (id + name).
`gc_check_membership`	Is a user in the given groups? (instant, via the user list)
`gc_add_to_groups`	Add an existing user to groups via the card (preserves other groups). `dryRun`.
`gc_remove_from_groups`	Remove a user from groups = revoke access. `dryRun`.
`gc_add_user_to_groups`	Add via the bulk import (creates the user if new) = grant access. `dryRun`.
`gc_copy_access`	Give a user the same groups as a reference student. `dryRun`.
`gc_update_user`	Edit card fields (first/last name, phone, city, comment). Email is out of scope. `dryRun`.
`gc_find_offers`	Search sales offers by name → id + price + actuality.
`gc_find_orders`	List a user's orders (dealId + status).
`gc_create_order`	Create an order = grant access via a purchase (the only way for "buyers-only" trainings, where groups don't grant access). ⚠️ single-step: `dryRun:false` creates the order immediately.
`gc_set_order_status`	Change a deal's status (e.g. cancel a duplicate: `cancelled` + `cancelReasonId`).
`gc_user_summary`	One call: profile + groups + orders for a user.
`gc_list_mailing_categories`	List mailing categories (tag-like segmentation) — id + name.
`gc_add_to_mailing_category`	Add a user to a mailing category.
`gc_remove_from_mailing_category`	Remove a user from a mailing category.

Usage

Run the MCP server over stdio, or call a tool directly for scripting:

node dist/index.js                                   # MCP (stdio)

npx tsx src/run.ts gc_find_user '{"email":"user@example.com"}'
# → Found: Jane Doe | user@example.com | student | active | id: 100200300

npx tsx src/run.ts gc_add_user_to_groups \
  '{"email":"user@example.com","groupIds":["100001","100002"]}'
# → OK [done] import submitted

npx tsx src/run.ts gc_check_membership \
  '{"email":"user@example.com","groups":[{"id":"100001","name":"Module 1"}]}'
# → ✅ Module 1 (100001)

Implementation notes

Granting access (gc_add_user_to_groups) uses the bulk Add users form (/pl/user/user/import?type=text): email + selected groups. For an existing user the "overwrite on match" flag is required (overwriteExisting, default true), otherwise the groups are not applied — the import carries only the email, so no profile data is touched.
A direct mass action exists (POST /pl/logic/operation/prepare?operationType=user_addtogroup), but in the current UI it is a selection-builder wizard — a candidate to wire up as an alternative path.
Membership is checked through the user list filtered by a user_ingrouprule rule (params.value.selected_id), which reflects membership immediately (the training student list mirrors access asynchronously and is not reliable for verification).