Dépannage

La validation de la licence échoue

« Identifiants invalides » : la clé de licence et le secret du panneau doivent former la paire émise ensemble. Si vous avez renouvelé les identifiants, le plugin a encore l'ancienne paire : collez la nouvelle. Si vous n'avez copié qu'une seule valeur avant de quitter la page, renouvelez pour obtenir une paire fraîche.

« L'URL ne correspond pas » : le site qui appelle ne correspond pas à l'URL enregistrée dans le panneau. Fréquent lorsque Moodle est derrière un proxy et que $CFG-wwwroot diffère du nom d'hôte public, ou après un changement de domaine. Mettez l'URL à jour dans Organisation → Moodle et revalidez.

Le plugin n'atteint pas du tout le panneau : votre Moodle a besoin d'un accès HTTPS sortant. Vérifiez curl https://moodlemcp.com depuis le serveur ainsi que les réglages de proxy de Moodle.

Le site ne peut pas être connecté

« URL non autorisée » : l'URL doit être publique, en HTTPS et avec un certificat valide. localhost, les plages privées et les hôtes accessibles uniquement par VPN sont refusés par conception. Un site de préproduction convient s'il est joignable publiquement.

Erreurs de certificat : un certificat auto-signé ou expiré échoue à la validation. Corrigez le certificat ; il n'y a pas de contournement.

L'assistant dit qu'il n'a aucun outil

• Le client n'a pas rechargé sa configuration MCP. Redémarrez-le.
• L'URL est erronée : elle doit être le sous-domaine de votre organisation et se terminer par /mcp.
• Avec une clé Bearer : vérifiez que l'en-tête est exactement Authorization: Bearer mcpk_… et que la clé n'est ni suspendue, ni révoquée, ni expirée.
• Avec OAuth : supprimez le connecteur et réautorisez.

L'assistant ne voit rien dans Moodle

La clé fonctionne, mais l'utilisateur Moodle sous-jacent n'a pas accès à ce que vous demandez. Les rôles sont la limite extérieure : une clé d'étudiant ne peut pas lister les participants d'un cours. Vérifiez pour quel utilisateur la clé a été émise, et si elle est limitée à la lecture seule, à certains outils ou à certains cours. Voir clés et permissions.

Les appels échouent après avoir fonctionné

• La clé a été suspendue ou révoquée, depuis le panneau ou depuis le plugin.
• Les identifiants ont été renouvelés et le plugin n'a pas été mis à jour.
• L'utilisateur Moodle a perdu le rôle dont dépend la clé, ou a été supprimé.
• Le jeton a été supprimé dans Moodle, dans Administration du site → Serveur → Services web → Gérer les jetons.

Organisation → Moodle → Utilisation montre les erreurs par clé et par outil, ce qui permet en général de localiser le problème en quelques secondes.

Un fichier ne s'envoie pas

L'URL doit renvoyer le fichier, pas une page qui l'enveloppe. Testez avec curl -IL url depuis l'extérieur de votre réseau. Google Drive, Dropbox et GitHub demandent chacun une forme d'URL précise : voir envoyer des fichiers. Si l'outil est absent, votre plugin est trop ancien : mettez-le à jour.

Le chat est absent ou refuse de répondre

• Aucune clé MCP n'est sélectionnée comme identité du chat dans Organisation → Moodle.
• Le solde de crédits ne couvre pas le message : rechargez dans Organisation → Crédits.
• Vous avez atteint la limite de 10 messages par minute. Patientez un instant.

L'organisation est verrouillée

L'essai est terminé ou un paiement a échoué. Souscrivez ou corrigez le moyen de paiement dans Organisation → Facturation. Rien n'est supprimé pendant le verrouillage.

Toujours bloqué

Notez l'erreur exacte, les 4 derniers caractères de la clé (jamais la clé elle-même) et l'heure, puis ouvrez un ticket sur github.com/studiolxd/moodle-local_mcpconnector/issues.