Démarrage rapide

Avant de commencer

Vérifiez les prérequis : Moodle 4.2 ou supérieur, joignable publiquement en HTTPS, services web activés et droits d'administrateur du site.

1. Créez votre organisation

Inscrivez-vous et créez une organisation. Une organisation correspond à une installation Moodle et c'est elle qui possède la connexion, les clés et la facturation. Vous disposez de 30 jours d'essai sans carte bancaire.

2. Connectez votre site Moodle

Dans le panneau, ouvrez Organisation → Moodle et saisissez l'URL de votre Moodle. Vous obtenez une clé de licence et un secret du panneau — affichés une seule fois : copiez-les avant de quitter la page — ainsi que l'URL de votre point de terminaison MCP. Les détails sont dans connecter votre site.

3. Installez le plugin

Installez local_mcpconnector dans votre Moodle depuis Administration du site → Plugins → Installer des plugins, ouvrez MCP Connector → Licence et collez les quatre valeurs affichées par le panneau : l'URL du panneau, la clé de licence, le secret et l'URL du point de terminaison MCP. Cliquez sur Valider la licence. Voir le plugin Moodle.

4. Provisionnez un utilisateur et obtenez une clé

Dans la section Utilisateurs du plugin, affectez un utilisateur à un service correspondant à son rôle. Le plugin génère un jeton Moodle, le panneau le transforme en clé MCP (mcpk_…) et l'utilisateur la reçoit par courriel. La valeur n'est affichée qu'une fois.

Les propriétaires et administrateurs peuvent aussi émettre des clés directement dans Organisation → Moodle → Clés MCP.

5. Connectez votre assistant

Pointez votre assistant vers le point de terminaison de votre organisation :

https://<votre-organisation>.moodlemcp.com/mcp

• ChatGPT ou Claude (claude.ai ou Claude Desktop) : ajoutez-le comme connecteur distant et choisissez Se connecter avec votre Moodle. Aucune clé à coller.
• Cursor, VS Code, Claude Code, scripts : envoyez la clé MCP dans un en-tête Bearer.

Les étapes par client sont dans configurer le client.

6. Posez une question

Essayez l'une de ces demandes pour confirmer que tout est branché :

• « À quels cours suis-je inscrit ? »
• « Liste les participants du cours Introduction à la biologie. »
• « Quels devoirs sont à rendre dans les deux prochaines semaines ? »

Si vous préférez ne configurer aucun client, ouvrez le chat IA du panneau : il utilise les mêmes outils sans aucune configuration.

Si quelque chose ne fonctionne pas

La plupart des problèmes initiaux viennent de la validation de la licence ou de l'URL du site. Voir le dépannage.