Imagine typing "Enroll these five people in Onboarding 101" into your AI assistant and watching it happen in your academy. That's what the Thought Industries MCP makes possible. Getting there takes a few minutes, needs no technical background, and only has to be done once for each AI assistant you use.
Feature flag: Open Beta
The Thought Industries MCP is in Open Beta. To turn it on, navigate to Apps > Labs. On the MCP Connector (Beta Access) tile, select Show Flags and turn on the MCP Connector (BETA) toggle. To learn more, see Thought Industries Labs.
Use Case Information
Once your AI assistant is connected, you can ask it to look things up or make changes in your academy by typing a request in everyday language.
When connected, you can control the following:
- Which AI assistants have access to your academy
- Whether an assistant can make changes or only read information
- Which parts of your academy the assistant can work in, such as users, courses, or events. You choose these when you sign in.
- When to remove an assistant's access, whether you connected it or another admin did
Before You Begin
✅ Requirements
- The Thought Industries MCP is turned on in Apps > Labs
- The MCP respects your user permissions, so the assistant can only do what your account is allowed to do.
- An AI assistant that supports MCP connections, such as Claude, Claude Code, Cursor, or VS Code
Step 1: Copy your connector URL
A connector URL is the web address your AI assistant uses to find your academy.
- Navigate to Settings > Connections > MCP Connector.
- Under Connector URLs, select Copy next to the URL you want to use.
There are two URLs to choose from:
| Access | URL | What it allows |
|---|---|---|
| Full access | https://your-academy/v3/mcp |
Reads and changes what your role allows |
| Read-only | https://your-academy/v3/mcp/readonly |
Reads what your role allows and never changes anything |
Tip
New to AI assistants? Start with the read-only URL. You can explore your academy without any risk of changing data, then add the full-access URL later when you're ready to make changes.
Step 2: Add the connector to your AI assistant
Next, add the URL you copied to your AI assistant. Select the tab for the assistant you use and follow the steps. The Set up an assistant section of the MCP Connector page shows the same steps for each assistant, so you can follow along there if you prefer.
These steps work in Claude on the web and in the Claude Desktop app.
- Navigate to Customize > Connectors.
- Select + Add, then Add custom connector.
- Name the connector
Thought Industriesand paste your connector URL. - Leave the OAuth client ID and secret empty.
- Select Add, then Connect.
Note
On Claude Team and Enterprise plans, only an organization Owner can add a custom connector. The Owner navigates to Organization settings > Connectors to add it. Each member then navigates to Customize > Connectors and selects Connect.
Claude Code runs in your computer's terminal, the text window where you type commands.
- Navigate to your terminal.
- Run this command, replacing
your-academywith your academy's domain:claude mcp add --transport http thought-industries https://your-academy/v3/mcp - In Claude Code, run
/mcp, select thought-industries, and choose Authenticate.
Tip
By default, the connector only works in the project you're in. Add --scope user to the end of the command to use it in every project.
Cursor uses a short piece of setup text, called a snippet, that's ready to copy from your admin.
- Navigate to Settings > Connections > MCP Connector.
- Under Set up an assistant, select the Cursor tab and select Copy.
- In Cursor, navigate to Cursor Settings, open the MCP section, and add a new MCP server. This opens Cursor's
mcp.jsonfile. - Paste the snippet into
mcpServers, keeping any servers already there, and save. - Select Connect next to thought-industries.
VS Code uses a short piece of setup text, called a snippet, that's ready to copy from your admin.
- Navigate to Settings > Connections > MCP Connector.
- Under Set up an assistant, select the VS Code tab and select Copy.
- In VS Code, open the Command Palette and run MCP: Open User Configuration.
- Paste the snippet into
servers, keeping any servers already there, and save. - Select Start above the entry, and allow VS Code to sign in when it asks.
- Use the connector from GitHub Copilot Chat in Agent mode.
Tip
To use the connector in one workspace only, paste the snippet into .vscode/mcp.json in that workspace instead.
Most AI assistants that support MCP connections work with the Thought Industries MCP.
- In your AI assistant, navigate to the setting for adding a connector. It's often called "custom connector," "MCP server," or something similar.
- Paste your connector URL.
- Follow your assistant's prompts to sign in.
Note
Some assistants only support connections that run on your own computer. For those, navigate to Settings > Connections > MCP Connector, select the Other clients tab under Set up an assistant, and follow the steps there.
Step 3: Sign in and approve access
Your assistant opens a browser window so you can sign in to your academy. This is the same login you use every day, and it tells the connector who you are and what you're allowed to do.
- Sign in to your academy the way you usually do (password, SSO, or two-factor).
- Choose the access to grant. The list shows what the assistant can do, grouped by area, such as users, courses, and enrollments. Clear any areas you don't want the assistant to use.
- Select Allow.
Note
There are no API keys to copy and no separate account to create. Everything your role allows is selected by default.
Step 4: Test the connection
In a new chat in your assistant, type:
"Use the Thought Industries connector to tell me who I'm connected as."
The assistant replies with the account, role, and portals it's connected as, and whether it can change data. Check that these match what you expect.
Note
The first time the assistant uses a Thought Industries tool, your assistant asks for permission. In Claude, choose Allow once to approve this one action, Always allow to skip the question next time, or Deny to block it.
Manage connected assistants
The Connected assistants section of the MCP Connector page lists the assistants connected to your academy. Use the My connections and All admins toggle to switch between your own assistants and everyone's.
- Navigate to Settings > Connections > MCP Connector.
- Under Connected assistants, select an assistant to see its access level, when it connected, and when it was last used.
- To remove its access, select Disconnect. This works for your own assistants and for other admins' assistants in the All admins view.
Note
Each admin can have up to 20 connected assistants per academy. If an admin is deactivated or loses admin access, their connections stop working right away.
Review assistant activity
The Assistant activity section of the MCP Connector page shows what AI assistants did on admins' behalf, newest first. Activity is kept for 180 days.
- Use the My activity and All admins toggle to see your own activity or everyone's.
- Turn on Show reads to include lookups as well as changes.
Tip
After a bulk change, check Assistant activity to confirm the assistant did exactly what you asked.
If it doesn't connect
The MCP Connector page is only available to admins, so check that you're signed in with an admin account. If you still don't see it, check that the MCP is turned on in Apps > Labs. If it's on and the page is still missing, reach out to your Account Manager or Support.
Check that you're using the URL from your academy's MCP Connector page, that your account is active with admin access, and that your assistant supports MCP connections. If all three look right, disconnect and reconnect to sign in again.
Only an organization Owner can add a custom connector on these plans. Ask your Owner to add it, then navigate to Customize > Connectors and select Connect.
Remove the local connector from your assistant and add the connector URL from your admin instead. You no longer need Node.js or an API key.
When the test prompt returns your name, academy, and role, your assistant is connected and ready. Head to MCP Prompts to Try for ideas on what to ask first.