Quickstart

Before you start

Check Requirements: Moodle 4.2+, publicly reachable over HTTPS, web services enabled, and site administrator rights.

1. Create your organization

Sign up and create an organization. An organization maps to one Moodle install and is the unit that owns the connection, the keys and the billing. You get a 30-day trial with no card required.

2. Connect your Moodle site

In the panel, open Organization → Moodle and enter your Moodle URL. You'll get a license key and a panel secret, shown once — copy both before leaving the page. Details in Connect your site.

3. Install the plugin

Install local_mcpconnector in your Moodle from Site administration → Plugins → Install plugins, open MCP Connector → License, paste the panel URL, license key and secret, and click Validate license. See Moodle plugin.

4. Provision a user and get a key

In the plugin's Users section, assign a user to a role-scoped service. The plugin mints a Moodle token for them, the panel turns it into an MCP key (mcpk_…), and the user receives it by email. The value is shown once.

Owners and admins can also mint keys directly in Organization → Moodle → MCP keys.

5. Connect your assistant

Point your assistant at your organization's endpoint:

https://<your-org>.moodlemcp.com/mcp

• Claude Desktop or ChatGPT — add it as a remote connector and choose Sign in with your Moodle. No key to paste.
• Cursor, Claude Code, scripts — send the MCP key as a Bearer header.

Step-by-step per client in Client setup.

6. Ask something

Try one of these to confirm everything is wired up:

• "Which courses am I enrolled in?"
• "List the participants of the Introduction to Biology course."
• "Which assignments are due in the next two weeks?"

If you'd rather not configure a client at all, open the panel's AI chat — it uses the same tools with no setup.

If something doesn't work

Most first-time issues are the license validation or the site URL. See Troubleshooting.