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
ChatGPT
Using Cursor, Windsurf, or any other MCP-compatible tool? Generic MCP setup →
Claude
Recommended · one setup covers everythingWorks 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.
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.
- Add the connector.
Open Claude. Click your profile icon →Settings→Customize→Connectors→ click the + button →Add custom connector. Pastehttps://learningbrain.ai/mcpand clickAdd. - Download the skill file.
Download learningbrain-skill.md - Install the skill at your account level.
In Claude:Settings→Customize→Skills→ click the + button →Create skill→Upload a skill. Select the file you just downloaded. - 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 installFor 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.
- 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/. - Restart Claude Code, then run
/mcp. Select learning-brain, choose Authenticate, and a browser tab opens. Close it after success, then run/mcpagain — learning-brain should now show as Connected. - 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
- In Claude Code, run: /plugin marketplace add https://github.com/laurie-harrison/learning-brain-plugin.git
- Then install: /plugin install learning-brain@learning-brain
- 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.
- Authenticate the MCP server:
/mcp
Select learning-brain, choose Authenticate, and a browser tab opens. Close the tab when it says success, then run
/mcpagain — learning-brain should now show as Connected.
Codex
Recommended for ChatGPT usersOpenAI'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.
- Install and open the Codex app. Sign in with your ChatGPT account.
- Download the skill file.
Download learningbrain-skill.md - In Codex, open
Plugins→Create→Create Plugin. Attachlearningbrain-skill.mdin 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. - Quit and reopen Codex once the builder finishes.
- 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.
- 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.pyThen quit and reopen Codex. Open Plugins, find Learning Brain under Personal Plugins, and click Install. Authenticate when prompted.
ChatGPT (chat)
Requires Plus or aboveFor 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.
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.
- Enable Developer Mode.
Open ChatGPT → profile picture →Settings→Apps→Advanced 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. - Create a Project and upload the skill file.
In the ChatGPT sidebar, click+ New projectand name it Learning Brain (or whatever you like). Then download the skill file and upload it to the project'sSourcessection (older UI versions may label this Files or Project files):
Download learning-brain-skill.md - 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.
- Add the Learning Brain MCP app. This step opens an OAuth tab and may drop you into a new chat afterwards.
OpenSettings→Apps→Advanced settings, clickCreate app(this button only appears once Developer Mode is on). Fill in:
• Name: Learning Brain
• MCP Server URL:https://learningbrain.ai/mcp
• Authentication: OAuth
TickI trust this application, then clickCreate. Complete the OAuth sign-in in the browser tab. - 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.
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.
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.
Any other MCP-compatible tool
Generic setupFor 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.
- Add the MCP server.
Open your tool's settings and find MCP, MCP Servers, or Connectors. Add a remote server with URLhttps://learningbrain.ai/mcp.
In Cursor or Windsurf:Cmd+,(orCtrl+,on Windows) → search MCP orFeatures→MCP Servers→Add remote server. - 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 - 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.
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:
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
- Open Claude Desktop → menu (☰) →
Settings→Developer→Edit Config. - 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_KEYwith the key from Step 1 (or use Fetch my key above — the JSON updates automatically). - 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.
- Download the skill file.
Download learningbrain-skill.md - Install the skill at your account level.
In Claude:Settings→Customize→Skills→ click the + button →Create skill→Upload a skill. Select the file you just downloaded. - 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.