Configurer le client

Pour la plupart des gens, la meilleure façon d'utiliser LMS MCP est de le connecter à ChatGPT ou Claude : une configuration unique, de deux minutes, sans aucune clé. Les outils en ligne de commande et les éditeurs viennent ensuite, pour qui en a besoin.

La méthode d'authentification prise en charge par chaque client est expliquée dans connecter un assistant.

Avant de commencer : l'URL du connecteur

Chaque client se connecte à l'URL de connecteur d'une connexion Moodle :

https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion>

Inutile de la composer à la main : le panneau l'affiche avec un bouton de copie sur la page de la connexion, dans Organisation → Moodle, aussi bien juste après la création de la connexion qu'à tout moment ensuite. Si votre administrateur vous a provisionné depuis le plugin, l'URL arrive aussi par courriel avec votre clé.

Si votre organisation a plusieurs sites Moodle, configurez un client par connexion — c'est l'URL qui choisit le site.

ChatGPT

ChatGPT se connecte avec Se connecter avec votre Moodle : aucune clé à copier.

  1. Ouvrez les paramètres de ChatGPT et allez à la section connecteurs.
  2. Dans les paramètres avancés, activez le mode développeur s'il ne l'est pas déjà — c'est lui qui permet d'ajouter des connecteurs MCP personnalisés.
  3. Créez un nouveau connecteur et collez l'URL de connecteur de la connexion.
  4. Quand la fenêtre du navigateur s'ouvre, choisissez Se connecter avec votre Moodle, identifiez-vous avec votre propre compte Moodle et approuvez.
  5. Dans une conversation, activez le connecteur depuis le menu des outils et posez une question sur votre Moodle.

Les connecteurs personnalisés nécessitent une offre ChatGPT payante, et les noms exacts des menus peuvent varier légèrement d'une version à l'autre.

Claude (claude.ai et Claude Desktop)

Les mêmes étapes valent pour Claude dans le navigateur (claude.ai) et pour l'application de bureau, toutes deux avec Se connecter avec votre Moodle :

  1. Ouvrez les paramètres de Claude et allez dans Connecteurs.
  2. Choisissez Ajouter un connecteur personnalisé et collez l'URL de connecteur de la connexion.
  3. La connexion ouvre une fenêtre de navigateur : choisissez Se connecter avec votre Moodle, identifiez-vous sur votre Moodle et approuvez.
  4. Dans une conversation, vérifiez que le connecteur est activé dans le menu des outils et posez une question sur votre Moodle.

Les connecteurs personnalisés nécessitent une offre Claude payante. Le connecteur reste lié à votre identité Moodle : pour vous connecter en tant qu'une autre personne, supprimez le connecteur et réautorisez.

Claude Code

Avec une clé MCP dans un en-tête Bearer :

claude mcp add --transport http moodle \
  https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion> \
  --header "Authorization: Bearer mcpk_..."

Si vous préférez ne pas manipuler de clés, ajoutez le serveur sans l'en-tête et authentifiez-vous par OAuth quand Claude Code vous le demande — c'est le même flux navigateur Se connecter avec votre Moodle.

Cursor

Dans le fichier de configuration MCP de Cursor — .cursor/mcp.json dans le projet, ou celui, global, de votre utilisateur :

{
  "mcpServers": {
    "moodle": {
      "url": "https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code utilise son propre format, dans .vscode/mcp.json à la racine du projet :

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clients qui ne parlent que stdio

Faites le pont avec le paquet standard mcp-remote :

npx mcp-remote https://<votre-organisation>.slxd.app/mcp/lmsmcp/<connexion> \
  --header "Authorization: Bearer mcpk_..."

Scripts et intégration continue

N'importe quel client HTTP convient : envoyez la clé dans un en-tête Bearer sur le transport Streamable HTTP. Pour l'automatisation, émettez une clé dédiée : en lecture seule, limitée aux outils nécessaires et avec une date d'expiration. Voyez clés et permissions.

Gardez la clé dans votre gestionnaire de secrets, jamais dans le dépôt. Si une clé fuite, révoquez-la dans le panneau ; son appel suivant sera refusé.

Vérifier que ça marche

Demandez à l'assistant quelque chose qui nécessite votre Moodle, par exemple « à quels cours suis-je inscrit ? ». S'il répond qu'il n'a pas d'outils, c'est presque toujours qu'il n'a pas rechargé sa configuration MCP : redémarrez le client, ou désactivez puis réactivez le connecteur. Les autres symptômes sont traités dans le dépannage.

Configurer le client