Configurer le client

Pour la plupart des gens, la meilleure façon d'utiliser MoodleMCP est de le connecter à ChatGPT ou à Claude : ça se configure une fois, en quelques minutes, et sans manipuler 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 : votre point de terminaison

Tous les clients se connectent au point de terminaison MCP de votre organisation :

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

Inutile de le construire à la main : le panneau l'affiche avec un bouton de copie dans Organisation → Moodle, aussi bien à 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é.

ChatGPT

ChatGPT se connecte avec Se connecter avec votre Moodle : il n'y a donc aucune clé à copier.

Ouvrez les réglages de ChatGPT et entrez dans la section des connecteurs.
Dans les réglages avancés, activez le mode développeur s'il ne l'est pas déjà — c'est ce qui permet d'ajouter des connecteurs MCP personnalisés.
Créez un nouveau connecteur et collez l'URL de votre point de terminaison.
Quand la fenêtre du navigateur s'ouvre, choisissez Se connecter avec votre Moodle, identifiez-vous avec votre propre compte Moodle et approuvez.
Dans une conversation, activez le connecteur depuis le menu des outils et posez une question sur votre Moodle.

Les connecteurs personnalisés nécessitent un abonnement payant de ChatGPT, et le nom exact des menus peut varier légèrement selon les versions.

Claude (claude.ai et Claude Desktop)

Ça vaut aussi bien pour Claude dans le navigateur (claude.ai) que pour l'application de bureau, avec les mêmes étapes et également avec Se connecter avec votre Moodle :

Ouvrez les réglages de Claude et entrez dans Connecteurs.
Choisissez Ajouter un connecteur personnalisé et collez l'URL de votre point de terminaison.
À la connexion, une fenêtre du navigateur s'ouvre : choisissez Se connecter avec votre Moodle, identifiez-vous sur votre Moodle et approuvez.
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 un abonnement payant de Claude. 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>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

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

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>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code utilise son propre format, dans .vscode/mcp.json dans le projet :

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<votre-organisation>.moodlemcp.com/mcp",
      "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>.moodlemcp.com/mcp \
  --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 expiration. Voir 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 affirme n'avoir aucun outil, c'est presque toujours qu'il n'a pas rechargé sa configuration MCP : redémarrez le client ou désactivez et réactivez le connecteur. D'autres symptômes sont traités dans le dépannage.