Connect your assistant

Studium runs as an MCP server that your AI assistant starts on your computer. Once it is connected, you can say "I want to learn X with Studium" and the assistant builds, plays and schedules your lessons through Studium's tools. This page helps you pick the page for your client, then shows how to check the connection.

Before you start

The assistant's client is called a harness (see the glossary). The server talks over stdio: it opens no port and shows no web page. A configuration starts it in one of two ways:

Way Command When
From npm npx -y studium-mcp the usual way; needs only Node 20 or later (see Installation)
From a file node /path/to/studium/apps/studium-vscode/dist/lesson-mcp.cjs from a checkout after pnpm --filter studium-vscode build, or with a lesson-mcp.cjs downloaded from a release (use its own path)

Each client page gives the npx form first and the checkout form second. Replace /path/to/studium with the absolute path of your checkout. If npx cannot reach npm, see Where the packages are.

You meet two environment variables first:

Setting Effect
BUNDLES_ROOT Leave it unset (recommended): lessons live in ~/.studium/library, progress in ~/.studium/data. Set BUNDLES_ROOT=/path/to/studium/fixtures to play the demo lessons shipped with the repository; lessons your assistant builds still go to ~/.studium/library.
LITELLM_BASE_URL="" No judge model, even if your shell defines one (see Judge model).

STUDIUM_EPHEMERAL=1 keeps progress in memory only, for a demo or a test. All variables are listed in Configuration.

The files in docs/examples are complete examples, in the checkout form, that add BUNDLES_ROOT for the demo lessons: codex.toml, mcp.claude.json, mcp.vscode.json and opencode-v2.json. Merge them into your client's file; never overwrite other servers already configured there.

Choose your client

Client Where its configuration lives Page
Codex ~/.codex/config.toml, or codex mcp add Connect Codex
Claude Code the studium plugin, claude mcp add, or .mcp.json at the project root Connect Claude Code
Copilot in VS Code .vscode/mcp.json Connect Copilot in VS Code
OpenCode opencode.jsonc at the project root Connect OpenCode
Cursor .cursor/mcp.json or ~/.cursor/mcp.json Connect Cursor
Claude Desktop claude_desktop_config.json below
A script or a custom client no MCP configuration HTTP API and file channel

Claude Desktop

Claude Desktop reads claude_desktop_config.json, in ~/Library/Application Support/Claude/ on macOS and in %APPDATA%\Claude\ on Windows. Merge this into it, then restart the app:

{
  "mcpServers": {
    "studium": {
      "command": "npx",
      "args": ["-y", "studium-mcp"],
      "env": { "LITELLM_BASE_URL": "" }
    }
  }
}

From a checkout, use "command": "node" and "args": ["/path/to/studium/apps/studium-vscode/dist/lesson-mcp.cjs"].

Check the connection

A configuration entry, or a skill the client discovered, does not prove the server is connected. Ask:

Call the Studium tool get_server_info and tell me the version, the build date, the number of tools and
whether my progress is durable. Then call get_study_plan.

The answer should list 40 tools (25 lesson, 5 study, 3 authoring, 2 teacher tools, 1 form tool, 3 panel tools and 1 companion tool; see MCP tools) and persistence.durable: true. If durable is false, progress is lost when the server stops. When the server connects, the assistant also receives Studium's instructions (relay each display_markdown as it is, wait for your own answer, never answer or rate for you) and two prompts, learn and review, in clients that support MCP prompts.

Where to go next

View the source of this page on GitHub