Set-up

Connect Learning Brain to your AI tool.

Two things install together: the MCP connector (the 32 tools) and the Skill (how your AI uses them). Without the Skill, the tools still work but your AI freestyles the workflow — skipping the elicit-first, audit-every-output discipline that makes Learning Brain consistently effective.

Pick your tool below. Most people are done in two minutes — when you're prompted to sign in during setup, use the email you signed up with.

Claude

Recommended · one setup covers everything

Works on Claude.ai (web) and the Claude Desktop app. Installing the connector and the skill at your account level gives you the full Learning Brain workflow — elicit-first, audit-always, evidence-cited design — in Claude Chat, Claude Cowork, and Claude Code's Desktop tab. One setup, three surfaces.

Prefer to have Claude guide you? Paste this prompt into Claude after signing up, and it'll walk you through both steps interactively, one at a time:
Install Learning Brain for me on Claude Desktop. Read https://learningbrain.ai/install and walk me through both the MCP connector and the workflow Skill, one step at a time, waiting for me to confirm before moving on.
Or follow the manual steps below.
  1. Add the connector.
    Open Claude. Click your profile icon → SettingsCustomizeConnectors → click the + button → Add custom connector. Paste https://learningbrain.ai/mcp and click Add.
  2. Download the skill file.
    Download learningbrain-skill.md
  3. Install the skill at your account level.
    In Claude: SettingsCustomizeSkills → click the + button → Create skillUpload a skill. Select the file you just downloaded.
  4. Start a conversation. Try: "Use learning-brain to find evidence on retrieval practice" or "Design a 30-minute module on [your topic] for [your audience]." Claude will call the tools, chain audits, and push back on bad briefs without being asked — in Chat, Cowork, and Code alike.

Claude Code (terminal CLI)

One-paste install

For users running Claude Code from the terminal without the Desktop app. If you use Claude Desktop at all, the Claude setup above already covers you — no install needed.

  1. Paste this into Claude Code. It'll register the MCP connector and download the workflow skill in one go. Install Learning Brain for me. Please run these two commands: claude mcp add --transport http learning-brain https://learningbrain.ai/mcp mkdir -p ~/.claude/skills/learning-brain && curl -fsSL https://learningbrain.ai/learningbrain-skill.md -o ~/.claude/skills/learning-brain/SKILL.md Then tell me to restart Claude Code and run /mcp to authenticate. Claude Code will ask permission before running each command — grant both. The first registers the MCP server; the second downloads the skill to ~/.claude/skills/learning-brain/.
  2. Restart Claude Code, then run /mcp. Select learning-brain, choose Authenticate, and a browser tab opens. Close it after success, then run /mcp again — learning-brain should now show as Connected.
  3. Try: "Use learning-brain to find evidence on retrieval practice" or "Design a 30-minute module on [your topic] for [your audience]." Claude chains the tools and runs silent audits behind the scenes — same as Chat.
Prefer the plugin marketplace? — original install path
  1. In Claude Code, run: /plugin marketplace add https://github.com/laurie-harrison/learning-brain-plugin.git
  2. Then install: /plugin install learning-brain@learning-brain
  3. Activate the tools by reloading plugins: /reload-plugins Without this step the skill is visible but the 32 MCP tools aren't yet loaded into the session.
  4. Authenticate the MCP server: /mcp Select learning-brain, choose Authenticate, and a browser tab opens. Close the tab when it says success, then run /mcp again — learning-brain should now show as Connected.

Codex

Recommended for ChatGPT users

OpenAI's coding agent app, included with any paid ChatGPT plan. Codex's built-in plugin builder turns the Learning Brain MCP server and skill file into a personal plugin in a couple of clicks — no terminal required. Closest thing to the Claude experience for ChatGPT-account users.

  1. Install and open the Codex app. Sign in with your ChatGPT account.
  2. Download the skill file.
    Download learningbrain-skill.md
  3. In Codex, open PluginsCreateCreate Plugin. Attach learningbrain-skill.md in the file field, and paste this prompt: Use the attached skill file and the MCP server https://learningbrain.ai/mcp to create a Learning Brain plugin. Codex's plugin builder reads the skill to understand what the tools do and wires up the MCP connection. Takes a minute or two.
  4. Quit and reopen Codex once the builder finishes.
  5. Open a new Codex session. The first time the plugin invokes a tool, Codex will open a browser tab asking you to authenticate. If you've previously authenticated the Learning Brain MCP in Codex, this step is skipped — the token is cached.
  6. Try: "Use learning-brain to find evidence on retrieval practice" or "Design a 30-minute module on [your topic] for [your audience]." Codex picks the right tools and chains them automatically.
Power-user alternative — terminal install script

If you'd rather skip the UI builder and install the plugin directly from the GitHub repo, open Terminal and run:

git clone https://github.com/laurie-harrison/learning-brain-plugin.git cd learning-brain-plugin python3 scripts/install_codex_plugin.py

Then quit and reopen Codex. Open Plugins, find Learning Brain under Personal Plugins, and click Install. Authenticate when prompted.

ChatGPT (chat)

Requires Plus or above

For ChatGPT users who don't want to use Codex. Requires a paid ChatGPT plan (Plus, Pro, Business, Enterprise, or Edu) with Developer Mode enabled. The workflow skill is loaded per-project rather than account-wide.

Prefer to have ChatGPT guide you? Paste this prompt into ChatGPT after signing up, and it'll walk you through the three steps in the right order.
I want to install Learning Brain on ChatGPT. Walk me through these 3 steps in this exact order, waiting for my confirmation between each. Order is critical — installing the connector before the Skill triggers OAuth, which kicks me to a new chat and the install fails.

STEP 1 — Enable Developer Mode
Tell me: Open ChatGPT → profile picture → Settings → Apps → Advanced settings → toggle Developer Mode ON. Acknowledge the warning dialog.

STEP 2 — Create a Project and upload the Skill file
Tell me to:
- Create a new ChatGPT Project called "Learning Brain" (left sidebar → + New project)
- Download the skill file from https://learningbrain.ai/learning-brain-skill.md
- Open the project's Sources section (older UI: "Files" or "Project files") and upload the downloaded file
- Pin the project so it's easy to find later

STEP 3 — Install the MCP connector (last step — triggers OAuth and may bounce me to a new chat)
Give me the install steps followed by what to expect after OAuth — both in one message, in this temporal order:

First, the install (do this now):
- Open Settings → Apps → Advanced settings → click Create app
- Fill in: Name "Learning Brain", MCP Server URL "https://learningbrain.ai/mcp", Authentication OAuth
- Tick "I trust this application" → Create
- Complete OAuth in the browser tab

Then, what to expect after OAuth completes:
- I may land in a fresh chat — that's normal, the install is done
- I'll open the Learning Brain project from the sidebar (pinned from Step 2)
- Start a new conversation INSIDE the project — the Skill only works inside it
- Try one of these starter prompts: "Use learning-brain to find evidence on retrieval practice" / "Design a 30-minute module on [topic] for [audience]" / "Audit this learning objective: [paste objective]"

Important — the Skill is per-Project:
- Unlike the connector (account-wide), the Skill file lives inside one Project. To use Learning Brain in another Project, upload the same skill file to that Project's Sources too.
- This works in either direction: I can add the skill to existing Projects I already use for learning-design work, instead of forcing all that work into the dedicated "Learning Brain" Project.

Once OAuth completes, the install is finished. No need to come back to this chat.

For more detail, you may also fetch https://learningbrain.ai/install — but these 3 steps are authoritative.
Or follow the manual steps below.
  1. Enable Developer Mode.
    Open ChatGPT → profile picture → SettingsAppsAdvanced settings → toggle Developer Mode ON. OpenAI shows a blunt warning dialog about the risks of custom apps — that's expected. Read it, then confirm to proceed.
  2. Create a Project and upload the skill file.
    In the ChatGPT sidebar, click + New project and name it Learning Brain (or whatever you like). Then download the skill file and upload it to the project's Sources section (older UI versions may label this Files or Project files):
    Download learning-brain-skill.md
  3. Note where you'll come back to. The next step triggers OAuth in a browser tab, and ChatGPT often drops you into a fresh chat when you return. To use Learning Brain after OAuth, you'll open the Learning Brain project from the sidebar and start a new conversation inside it. The skill is only active inside the project — a chat outside it has the tools but not the workflow Skill. Pin the project (right-click in the sidebar) so it's easy to find.
  4. Add the Learning Brain MCP app. This step opens an OAuth tab and may drop you into a new chat afterwards.
    Open SettingsAppsAdvanced settings, click Create app (this button only appears once Developer Mode is on). Fill in:
    Name: Learning Brain
    MCP Server URL: https://learningbrain.ai/mcp
    Authentication: OAuth
    Tick I trust this application, then click Create. Complete the OAuth sign-in in the browser tab.
  5. Open your Learning Brain project from the sidebar and start a new conversation. Try: "Use learning-brain to find evidence on retrieval practice" or "Design a 30-minute module on [your topic] for [your audience]." ChatGPT will call the tools and follow the workflow discipline from the skill file.
Heads up — the Skill is per-Project. Unlike the connector (account-wide, works everywhere), the Skill file lives inside one Project. To use Learning Brain in another Project, upload the same skill file to that Project's Sources section too. You can add it to existing Projects you already use for learning-design work — you don't have to do everything inside the dedicated Learning Brain Project.
UI path note: OpenAI moved MCP setup from Settings → Connectors to Settings → Apps. If you see a different label (e.g. Plugins, Custom Apps, or under Workspace settings on Business/Enterprise plans), it's the same flow — find the equivalent and continue.
Which project? The skill only applies to conversations inside the project it's uploaded to. If you already have a project you use for learning-design work, you can upload the skill file there instead — no need to create a new one.

Any other MCP-compatible tool

Generic setup

For Cursor, Windsurf, or any other AI tool that supports Model Context Protocol. Most tools give you the 32 MCP tools through a simple URL-and-auth step. If the tool also supports custom skills or system-prompt files, upload the Learning Brain skill so the AI follows the elicit-first, audit-always workflow.

  1. Add the MCP server.
    Open your tool's settings and find MCP, MCP Servers, or Connectors. Add a remote server with URL https://learningbrain.ai/mcp.
    In Cursor or Windsurf: Cmd+, (or Ctrl+, on Windows) → search MCP or FeaturesMCP ServersAdd remote server.
  2. Add the skill, if your tool supports it.
    If your tool has a custom-skills, system-prompt, or knowledge-file feature, download the universal skill file and attach it there. Without the skill, the tools still work but the AI freestyles the workflow.
    Download learningbrain-skill.md
  3. Try: "Use Learning Brain to find evidence that spaced practice improves retention" or "Design a 30-minute module on [your topic] for [your audience]." If the tool calls `lb_elicit_*` first and chains `doctor_*` audits after design tools, you're getting the full workflow.
Tool didn't find the skill field? Some MCP-capable tools don't yet support custom skills. You'll get the 32 tools and their evidence-backed outputs, but the orchestration discipline (elicit before design, audit every output) depends on the AI's own tool-use instincts rather than a loaded skill. Still useful for ad-hoc evidence lookups and single-artifact generation.
Your company blocks custom connectors? Read this.

Some enterprise orgs disable custom MCP connectors in Claude and ChatGPT settings. If you hit a wall, try this path instead. It connects Claude Desktop via a local config file, bypassing the setting your IT disabled.

Prerequisites

You'll need Node.js installed. To check, open Terminal (Cmd+Space, type Terminal) and run:

node --version

If you see a version number, you're set. If not, install from nodejs.org (LTS version).

Step 1 — Regenerate your API key

This path uses an API key instead of browser sign-in. Enter the email you signed up with below to issue a fresh key. Any previously-issued key for this email stops working immediately — we don't store the original, so we can only mint a new one.

Step 2 — Add Learning Brain to your Claude Desktop config

  1. Open Claude Desktop → menu (☰) → SettingsDeveloperEdit Config.
  2. Replace the contents with (or merge into existing mcpServers): { "mcpServers": { "learning-brain": { "command": "npx", "args": [ "-y", "mcp-remote", "https://learningbrain.ai/mcp", "--header", "Authorization: Bearer YOUR_API_KEY" ] } } }

    Replace YOUR_API_KEY with the key from Step 1 (or use Fetch my key above — the JSON updates automatically).

  3. Save the file, fully quit Claude Desktop, and reopen.

Step 3 — Install the Skill

Same install path as the main Claude setup above — repeated here so you don't have to scroll.

  1. Download the skill file.
    Download learningbrain-skill.md
  2. Install the skill at your account level.
    In Claude: SettingsCustomizeSkills → click the + button → Create skillUpload a skill. Select the file you just downloaded.
  3. Try: "Use learning-brain to find evidence on retrieval practice" or "Design a 30-minute module on [your topic] for [your audience]." No browser pop-ups, no OAuth loops. Claude chains the tools, audits its own output, and cites evidence.

Troubleshooting

Upgrading from an old OAuth-based config? Quit Claude Desktop, then run rm -rf ~/.mcp-auth in Terminal. Then update your config to the API-key version above and reopen.

npm permissions error? In Terminal, run sudo chown -R $(whoami) ~/.npm (you'll need your Mac password). Then restart Claude Desktop.

401 Unauthorized? Your API key is wrong or was revoked. Use Fetch my key above for a fresh one.

Still stuck, or your org blocks every path above? Email info@learningbrain.ai — I'd like to hear about it, and can probably help you find another way in.