Client instellen

Voor de meeste mensen is de beste manier om MoodleMCP te gebruiken de verbinding met ChatGPT of Claude: je stelt het één keer in, in een paar minuten, zonder ook maar één sleutel te beheren. De opdrachtregeltools en editors komen daarna, voor wie ze nodig heeft.

Welke authenticatiemethode elke client ondersteunt, staat in een assistent verbinden.

Voordat je begint: je eindpunt

Elke client verbindt met het MCP-eindpunt van je organisatie:

https://<jouw-organisatie>.moodlemcp.com/mcp

Je hoeft hem niet met de hand op te bouwen: het paneel toont hem met een kopieerknop in Organisatie → Moodle, zowel bij het aanmaken van de verbinding als op elk later moment. Heeft je beheerder je vanuit de plug-in toegang gegeven, dan komt de URL ook mee in de e-mail bij je sleutel.

ChatGPT

ChatGPT verbindt met Aanmelden met je Moodle: er is geen sleutel om te kopiëren.

Open de instellingen van ChatGPT en ga naar het onderdeel connectors.
Zet in de geavanceerde instellingen de ontwikkelaarsmodus aan als die nog niet aanstaat — daarmee kun je aangepaste MCP-connectors toevoegen.
Maak een nieuwe connector aan en plak de URL van je eindpunt.
Kies in het browservenster dat opent Aanmelden met je Moodle, meld je aan met je eigen Moodle-account en geef akkoord.
Zet in een gesprek de connector aan via het toolsmenu en stel een vraag over je Moodle.

Aangepaste connectors vereisen een betaald ChatGPT-abonnement, en de exacte naam van de menu's kan licht verschillen tussen versies.

Claude (claude.ai en Claude Desktop)

Geldt zowel voor Claude in de browser (claude.ai) als voor de desktopapplicatie, met dezelfde stappen en eveneens met Aanmelden met je Moodle:

Open de instellingen van Claude en ga naar Connectors.
Kies Aangepaste connector toevoegen en plak de URL van je eindpunt.
Bij het verbinden opent een browservenster: kies Aanmelden met je Moodle, meld je aan op je Moodle en geef akkoord.
Controleer in een gesprek dat de connector aanstaat in het toolsmenu en stel een vraag over je Moodle.

Aangepaste connectors vereisen een betaald Claude-abonnement. De connector blijft gekoppeld aan je Moodle-identiteit: wil je als iemand anders verbinden, verwijder dan de connector en autoriseer opnieuw.

Claude Code

Met een MCP-sleutel in een Bearer-header:

claude mcp add --transport http moodle https://<jouw-organisatie>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Wil je liever geen sleutels beheren, voeg de server dan toe zonder de header en authenticeer via OAuth wanneer Claude Code erom vraagt — dat is dezelfde Aanmelden met je Moodle-stroom uit de browser.

Cursor

In het MCP-configuratiebestand van Cursor — .cursor/mcp.json in het project, of het algemene bestand van je gebruiker:

{
  "mcpServers": {
    "moodle": {
      "url": "https://<jouw-organisatie>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code gebruikt zijn eigen formaat, in .vscode/mcp.json in het project:

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<jouw-organisatie>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clients die alleen stdio spreken

Overbrug met het standaardpakket mcp-remote:

npx mcp-remote https://<jouw-organisatie>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Scripts en continue integratie

Elke HTTP-client volstaat: stuur de sleutel mee als Bearer-header over het Streamable HTTP-transport. Geef voor automatisering een eigen sleutel uit: alleen-lezen, beperkt tot de nodige tools en met een vervaldatum. Zie sleutels en rechten.

Bewaar de sleutel in je secret store, nooit in de repository. Lekt een sleutel, trek hem dan in het paneel in: de eerstvolgende aanroep wordt geweigerd.

Controleren of het werkt

Vraag de assistent iets waarvoor je Moodle nodig is, bijvoorbeeld "voor welke cursussen ben ik ingeschreven?". Zegt hij geen tools te hebben, dan heeft hij bijna altijd zijn MCP-configuratie niet herladen: herstart de client of zet de connector uit en weer aan. Andere symptomen staan bij problemen oplossen.