Skip to main content
Documentation

Quickstart

Before you start

Check the requirements: Moodle 4.2 or later, 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 — along with the URL of your MCP endpoint. Details are in Connect your site.

3. Install the plugin

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

4. Provision a user and get a key

In the plugin's Users section, assign a user to a service based on their role. The plugin mints a Moodle token, 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
  • ChatGPT or Claude (claude.ai or Claude Desktop): add it as a remote connector and choose Sign in with your Moodle. No key to paste.
  • Cursor, VS Code, Claude Code, scripts: send the MCP key as a Bearer header.

Step-by-step instructions per client are 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.