Une URL de connecteur par connexion
Votre organisation peut contenir plusieurs connexions Moodle, et chacune a sa propre URL de connecteur : le sous-domaine de l'organisation, plus l'identifiant de la connexion dans le chemin.
https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion>
Si vous travaillez dans un espace personnel et non dans une organisation partagée, l'URL ne porte pas de sous-domaine :
https://lmsmcp.slxd.app/mcp/lmsmcp/<connexion>
Inutile de composer l'URL à la main : le panneau l'affiche avec un bouton de copie sur la page de la connexion, sous URL du connecteur, et dans la liste des connexions de Organisation → Moodle. Si vous avez été provisionné depuis le plugin, elle arrive aussi par courriel avec votre clé.
L'URL vers laquelle vous pointez l'assistant décide avec quel Moodle il dialogue. Une clé appartient à une connexion : la présenter à l'URL d'une autre connexion est refusé.
Le serveur parle le transport MCP standard Streamable HTTP : tout client conforme peut s'y connecter. Les instructions par client sont dans configurer le client.
Deux façons de s'authentifier
Choisissez celle qui convient à votre client. Si vous utilisez ChatGPT ou Claude — le cas le plus courant — la première voie est la vôtre.
Se connecter avec votre Moodle (OAuth) — recommandé
C'est la voie pour ChatGPT et Claude (claude.ai dans le navigateur comme Claude Desktop), et celle qu'on recommande dès que votre client la prend en charge. Ajoutez l'URL du connecteur comme connecteur MCP distant ; à la première connexion, une fenêtre de navigateur s'ouvre — choisissez Se connecter avec votre Moodle, identifiez-vous sur votre propre Moodle et approuvez.
À partir de là, l'assistant est lié à votre identité et à vos rôles dans Moodle. Aucune clé à copier, à stocker ou à envoyer par courriel, donc rien qui puisse fuiter. Réautoriser, ou révoquer la clé sous-jacente, coupe la connexion.
Une clé MCP
Pour les clients qui acceptent un jeton (Cursor, Claude Code, scripts, CI) : envoyez la clé dans un en-tête Bearer. Les propriétaires et administrateurs émettent les clés dans Organisation → Moodle → Clés MCP, en choisissant la connexion concernée, et le plugin peut en envoyer une par courriel à chaque utilisateur provisionné. La valeur n'est affichée qu'une fois.
Ce qui se passe à chaque appel
Quelle que soit la voie choisie, le serveur MCP résout la connexion à partir de l'URL et exécute des fonctions de service web Moodle sur ce site, avec votre jeton et vos rôles enregistrés. L'authentification est vérifiée à chaque requête : une identification révoquée, suspendue ou expirée est coupée dès l'appel suivant — il n'y a pas de session à expirer.
Chaque appel, direct ou passant par les outils de passerelle, traverse le même client Moodle durci (connexions épinglées contre le SSRF, délai maximal de requête et plafond de taille de réponse en flux) et la même barrière de rôles. Ce qu'une clé a le droit de faire est traité dans clés et permissions.
Pas de client ? Utilisez le panneau
Le chat IA du panneau utilise le même catalogue d'outils sans aucune configuration cliente, ce qui est pratique pour confirmer qu'une connexion fonctionne avant de configurer quoi que ce soit. Le chat dialogue avec Moodle sous l'identité de la clé MCP que vous sélectionnez : il répond donc à propos de la connexion de cette clé.