Aller au contenu
Studeia Docs
AI-assisted translation — last updated 2026-10-04. For original (pt-BR or en-US), use the language switcher.

Connecter ChatGPT, Claude ou Claude Code à Studeia (serveur MCP)

Guide complet du connecteur MCP de Studeia : activez-le dans votre établissement, connectez ChatGPT, Claude ou Claude Code via OAuth 2.1 et utilisez 139 outils avec les permissions réelles de chaque utilisateur, avec audit.

Par Équipe Studeia 2026-10-04 12 min
Resposta curta

Studeia expose un serveur MCP par établissement à l'adresse https://<slug>.studeia.com/api/mcp. L'administrateur active le connecteur dans Paramètres → Connecteurs IA ; chaque admin, coordinateur, responsable pédagogique ou enseignant ajoute l'URL dans ChatGPT (Plugins, en Mode développeur), dans Claude (+ → Connecteurs) ou dans Claude Code, se connecte et autorise. L'assistant agit avec les permissions réelles de cette personne sur 139 outils (69 en lecture, 70 en écriture) : rapports, cours, leçons, notes et paramètres, le tout audité.

Fonctionnement

Studeia implémente le Model Context Protocol (MCP) avec le transport Streamable HTTP et OAuth 2.1 (enregistrement dynamique de client, PKCE S256, refresh token rotatif). L'assistant IA se connecte avec votre compte, et non avec une clé de l'établissement : tout ce qu'il fait passe par les mêmes règles de permission que l'interface web et est enregistré dans l'audit.

Administrateur de l'établissementCoordinateur / responsable pédagogiqueEnseignant
Qui active le connecteurOuiNonNon
LectureTout le tenant : cours, leçons, élèves, groupes-classes, notes, rapports, paramètresTout le tenant, sauf les paramètres IA et du tenantCours qu'il crée, sur lesquels il collabore ou qu'il enseigne ; élèves de ses classes
ÉcritureCours, modules, leçons, guides de l'enseignant, personnes, groupes-classes, inscriptions, notes, gamification, automatisations, paramètresIdem, sauf 14 outils de configurationCours, leçons, notes et sessions en direct de ses cours
Outils visibles13912576
Hors de portéeFacturation, SSO/SCIM, clés de fournisseurs, uploads, le toggle du connecteur lui-mêmeidemidem

Les captures d'écran de ce guide montrent Studeia en portugais et ChatGPT/Claude dans la langue et le thème du compte utilisé (portugais, thème sombre) ; les noms des menus peuvent varier selon la version et la langue de votre assistant.

1. Activer dans l'établissement (admin)

  1. Accédez à Paramètres → Connecteurs IA (ChatGPT / Claude).
  2. Activez Autoriser les connexions via MCP. Désactivez éventuellement Les enseignants peuvent également se connecter (les enseignants sont alors limités aux cours et groupes-classes qu'ils enseignent).
  3. Copiez l'URL du serveur MCP — généralement https://<slug>.studeia.com/api/mcp. Si l'établissement dispose d'un domaine personnalisé vérifié, il apparaît comme première option ; l'adresse principale https://studeia.com/api/mcp fonctionne également.
Section Connecteurs IA avec les deux interrupteurs activés, les URL du serveur MCP et le bouton Copier
Paramètres → Connecteurs IA : toggles, URL du serveur et avis de confidentialité

Désactiver le connecteur révoque immédiatement toutes les connexions actives. Désactiver uniquement l'option enseignants révoque uniquement les connexions des enseignants.

La liste Connexions actives affiche chaque connexion avec l'utilisateur, le rôle, l'assistant (ChatGPT ou Claude), les permissions, la date d'autorisation et la dernière utilisation — avec le bouton Révoquer sur chaque ligne.

Tableau Connexions actives avec une connexion Claude et une connexion ChatGPT
Connexions actives : qui s'est connecté, quel assistant, permissions et dernière utilisation

2. Se connecter dans Claude (web, Desktop et mobile)

  1. Dans le chat, cliquez sur + → Connecteurs → Ajouter un connecteur (ou Paramètres → Connecteurs).
  2. Dans Ajouter un connecteur personnalisé, donnez un nom (ex. : « MCP Studeia ») et collez l'URL du serveur MCP. Il n'y a pas de Client ID/Secret à renseigner — l'enregistrement est automatique ; si des champs avancés apparaissent, laissez-les vides.
  3. Cliquez sur Continuer : vous serez redirigé vers la connexion Studeia (si vous n'êtes pas encore connecté) et vers l'écran de consentement.
  4. Examinez les permissions (lecture, écriture, 30 jours) et l'avis de confidentialité → Autoriser. Le connecteur apparaît dans + → Connecteurs avec un interrupteur ; dans Gérer les connecteurs, vous pouvez voir et activer/désactiver chaque outil.
Boîte de dialogue Ajouter un connecteur personnalisé de Claude avec le nom MCP Studeia et l'URL du serveur MCP renseignés
Claude : Ajouter un connecteur personnalisé — seulement le nom et l'URL
Écran de consentement Studeia montrant Claude demandant l'accès à l'établissement au nom d'un administrateur
Consentement : permissions demandées, rôle de l'utilisateur et avis de confidentialité

Tutoriel complet avec captures : Connecter Claude à votre LMS.

Claude Code (terminal)

claude mcp add --transport http studeia https://<slug>.studeia.com/api/mcp

Ouvrez /mcp dans la session et choisissez Authenticate : Claude Code ouvre le navigateur pour le consentement et reçoit le retour sur http://localhost:<port>/callback. L'écran de consentement avertit que le retour va vers une adresse locale — ne continuez que si c'est vous qui avez initié la connexion sur votre ordinateur.

Terminal avec la commande claude mcp add et la confirmation que le serveur a été ajouté
Claude Code : claude mcp add --transport http

Tutoriel complet : Claude Code + LMS.

3. Se connecter dans ChatGPT

  1. Paramètres → Plugins → Mode développeur → activez Mode développeur (ChatGPT le signale comme Risque élevé car il accepte des serveurs non vérifiés par OpenAI — c'est attendu).
  2. Dans Plugins, cliquez sur + (Nouveau plugin) : nom (ex. : « MCP Studeia ») → Connexion URL du serveur → collez l'URL → Authentification OAuth → cochez Je comprends et je souhaite continuer → Créer.
  3. Finalisez la connexion et le consentement Studeia. La page du plugin affiche désormais votre compte dans Comptes connectés, le bloc Permissions et la liste Actions (chaque outil, avec le badge Écriture pour ceux qui modifient des données).
  4. Dans le chat, cliquez sur + et choisissez MCP Studeia. Avec la permission par défaut (Autoriser les actions à faible risque), ChatGPT demande une confirmation avant chaque action d'écriture ; Autoriser toutes les actions supprime cette pause.
Formulaire Nouveau plugin de ChatGPT rempli avec le nom MCP Studeia, l'URL du serveur MCP et l'authentification OAuth
ChatGPT (Mode développeur) : Nouveau plugin avec URL du serveur et OAuth
Page du plugin dans ChatGPT avec Comptes connectés, Permissions et la liste des Actions
Plugin autorisé : comptes connectés, permissions et actions disponibles

Les outils search et fetch suivent le contrat ChatGPT, donc le connecteur fonctionne également en recherche approfondie (deep research).

Tutoriel complet : Connecter ChatGPT à votre LMS.

4. Ce que vous pouvez demander à l'assistant

Exemples concrets, par domaine :

  • Rapports : « Faites un rapport de la classe 3e A avec les élèves en difficulté et les compétences les moins maîtrisées. »
  • Leçons : « Listez les leçons du cours Compétences numériques sans guide de l'enseignant et créez un guide pour la leçon 4. »
  • Contenu : « Réécrivez les diapositives de la leçon Coffre numérique dans un langage plus simple et publiez. »
  • Personnes : « Quels utilisateurs n'ont jamais accédé à la plateforme ? Exportez sous forme de tableau. »
  • Notes : « Attribuez 8,0 à l'élève X pour l'évaluation Y et montrez-moi la moyenne de la classe. »
  • Évaluation : « Créez une banque de questions sur les fractions avec 10 questions à choix multiples et une rubrique à 3 critères. »
  • Sessions en direct : « Planifiez une session en direct pour la classe B vendredi à 10h et dites-moi qui était absent lors de la dernière. »
  • Gamification : « Créez un badge "Grand lecteur" pour ceux qui terminent le module 2 et récompensez les 3 premiers. »
  • Automatisations : « Créez une automatisation qui envoie une notification à l'élève lorsqu'il n'a pas accédé à la plateforme depuis 7 jours. »
  • Configuration (admin) : « Ajustez le prompt du tuteur IA pour répondre en français et montrez le coût IA de ce mois. »

5. Catalogue des outils (139)

DomaineExemplesOutilsQui voit
Établissementget_tenant_overview, update_tenant_settings, list_audit_events, outils intégrés, modèle de rapport9admin (paramètres : institution_admin uniquement)
Cours et moduleslist_courses, get_course, create_course, publish_course, reorder_modules, clone_course, export_course_cartridge (IMS CC), révision par IA, RAG du cours, collaborateurs19enseignant (créer/cloner : admin)
Leçonsget_lesson, create_lesson, update_lesson_content (validé par type), update_lesson_teacher_guide, bulk_update_lessons, populate_lesson_with_ai, configuration du quiz11enseignant
Personnes, groupes-classes et inscriptionslist_users, create_user, invitations, tags, create_class_group, enroll_student, update_enrollment18groupes-classes/inscriptions : enseignant en lecture ; gestion des personnes : admin
Évaluationget_gradebook, record_grades, export_gradebook_csv, compétences et référentiels, banques de questions, rubriques, get_quiz_analytics19enseignant (référentiels : admin)
Rapportsget_student_report, get_course_report, get_tutor_efficacy_report3enseignant (efficacité du tuteur : admin)
Réponses des élèveslist_student_quiz_attempts, get_quiz_attempt (question par question), get_activity_attempt, list_student_tutor_quizzes, get_assignment_submission, grade_assignment_submission, release_quiz_results9enseignant (élèves de ses classes)
Médias et communicationsearch_media, get_media_transcription, list_announcements, sessions en direct (planifier, démarrer, terminer, présence)11enseignant
Gamificationconfiguration globale et par cours, badges, award_badge, concours, récompenses, échanges, analytics18enseignant (badges par cours) ; admin (global)
Automatisationslist_automations, create_automation, toggle_automation, test_automation, historique d'exécutions8admin
Configuration IAprompts du tuteur, limites IA, routage des modèles, configuration pédagogique, analytics IA, lacunes du RAG10institution_admin (analytics : admin)
Recherchesearch, fetch (contrat ChatGPT)2tous
Génériquelist_api_endpoints, call_institution_api — accède à l'API institutionnelle documentée2tous (avec les permissions du rôle)

Totaux : 139 outils — 69 en lecture et 70 en écriture. Les outils d'écriture n'apparaissent que lorsque la connexion dispose de la portée écriture. Ressources MCP disponibles pour l'assistant : studeia://docs/lesson-content-schemas (schémas de tous les types de leçons), studeia://docs/api-endpoints (endpoints accessibles) et studeia://tenant/summary (qui est connecté, rôle et portées).

Non disponible via MCP : upload de fichiers, facturation, SSO/SCIM, clés de fournisseurs IA et vidéo, création d'annonces et la configuration du connecteur lui-même.

6. Comment limiter la portée

La portée de la connexion est demandée par l'assistant (lecture, écriture, 30 jours), elle n'est pas choisie dans Studeia. Pour travailler avec moins de pouvoir :

  • Dans Claude : dans Gérer les connecteurs → MCP Studeia, désactivez les outils d'écriture que vous ne souhaitez pas exposer ; Claude demande également une permission pour chaque outil (« Autoriser une fois » / « Toujours autoriser »).
  • Dans ChatGPT : maintenez la permission du plugin sur Autoriser les actions à faible risque (par défaut) — chaque outil marqué comme Écriture demande une confirmation avant de s'exécuter ; Autoriser toutes les actions supprime cette pause.
  • Dans Claude Code : refusez la permission lorsque l'assistant demande à utiliser un outil d'écriture, ou n'approuvez que ceux en lecture.
  • En tant qu'admin : désactivez Les enseignants peuvent également se connecter pour limiter le connecteur aux administrateurs, coordinateurs et responsables pédagogiques.
  • Toujours : révoquez la connexion lorsque vous avez terminé — elle expire automatiquement au bout de 30 jours.

7. Sécurité et cycle de vie du token

  • OAuth 2.1 avec PKCE S256 obligatoire ; l'enregistrement dynamique n'accepte que les callbacks de Claude, de ChatGPT et en loopback (http://localhost:<port>/callback).
  • Tokens opaques : la base de données ne stocke que le hash. Le token d'accès dure 1 heure ; le refresh token est rotatif (la réutilisation d'un ancien refresh token révoque toute la connexion) et la connexion expire au maximum 30 jours après le consentement.
  • Lié à l'adresse : un token émis sur ecole.studeia.com n'est pas valable sur studeia.com — reconnectez-vous via la même adresse si vous changez de domaine.
  • Rôle et établissement relus à chaque appel : si l'utilisateur change de rôle ou quitte l'établissement, la connexion est automatiquement révoquée.
  • Limite d'appels par connexion : 1 000/heure sur la démo et 5 000/heure sur les plans payants ; limites par IP sur les endpoints OAuth.
  • Les administrateurs globaux de la plateforme et les sessions d'impersonation ne peuvent pas autoriser de connexions.

8. Audit

Toute la vie de la connexion génère des événements mcp.* dans les journaux de l'établissement : enregistrement du client, consentement accordé/refusé, token émis/renouvelé, réutilisation de refresh détectée, révocation, modification de configuration et chaque appel d'outil (mcp.tool_call), avec le nom de l'outil, les identifiants concernés, le succès et la durée — jamais le contenu envoyé ou reçu. Dans Journaux, filtrez l'action par mcp..

Page des journaux de l'établissement filtrée par actions mcp affichant le consentement, le token et les appels d'outils
Audit : chaque appel d'outil enregistré, sans le contenu

9. Conformité et données des élèves

  • Les données que l'assistant consulte (y compris les données de mineurs) sont traitées par le fournisseur du compte de l'utilisateur — OpenAI ou Anthropic — en dehors de Studeia. L'écran de consentement le précise explicitement.
  • L'établissement est le responsable du traitement et répond de l'usage légitime : utilisez le connecteur à des fins pédagogiques, ne demandez que le nécessaire (minimisation), révoquez les connexions inactives et vérifiez le contrat de traitement des données (DPA) du fournisseur IA.
  • Ce qui reste dans Studeia : la connexion (client, portées, dates) et les événements d'audit — jamais le contenu des conversations. Les connexions de l'utilisateur sont incluses dans l'exportation des données personnelles et peuvent être révoquées à tout moment.

Problèmes courants

SymptômeCause probableQue faire
« Couldn't reach the MCP server » dans ClaudeURL incorrecte ou connecteur désactivéUtilisez exactement https://<slug>.studeia.com/api/mcp et vérifiez le toggle dans Paramètres
Erreur de redirect_uri lors de l'enregistrementClient non supportéSeuls Claude, ChatGPT et les clients avec callback local (Claude Code) sont acceptés
« L'établissement n'a pas encore activé les connecteurs IA »Toggle désactivéDemandez à l'administrateur d'activer dans Paramètres → Connecteurs IA
« L'établissement ne permet pas aux enseignants de se connecter »Option enseignants désactivéeDemandez à l'administrateur d'activer Les enseignants peuvent également se connecter
Demande d'autorisation expirée ou invalideLe consentement a pris plus de 10 min ou a été rouvertRecommencez la connexion depuis l'assistant
401 après changement de domaineToken lié à l'adresse d'origineReconnectez-vous en utilisant la même URL
L'outil répond forbiddenEnseignant hors du cours/groupe ou action réservée à l'adminVérifiez le rôle et si le cours fait partie de ceux que vous enseignez
429Limite d'appels par heure atteinteAttendez ou réduisez les requêtes par lot
Demande de connexion à nouveau après des semainesLa connexion a atteint 30 joursAutorisez à nouveau — c'est le comportement attendu
Impossible d'autoriser pendant le supportSession d'impersonationL'impersonation n'autorise jamais les connexions IA
Écran de consentement avec l'erreur indiquant que l'établissement ne permet pas aux enseignants de connecter des assistants IA
Erreur de permission : l'administrateur a désactivé l'option permettant aux enseignants de se connecter

Pour les développeurs

  • Découverte : /.well-known/oauth-protected-resource/api/mcp et /.well-known/oauth-authorization-server (relatifs au host).
  • POST /api/mcp sans token répond 401 avec WWW-Authenticate: Bearer resource_metadata=….
  • Portées : read, write, offline_access. Préfixes de token : mcp_at_ (accès) et mcp_rt_ (refresh).
  • Les routes de gestion du connecteur (/api/institution/mcp/*) n'acceptent que la session web — jamais une clé API ni un token MCP. Consultez le groupe « MCP (ChatGPT / Claude) » dans la référence de l'API.
  • L'automatisation sans utilisateur humain (CI, scripts) doit utiliser l'API publique avec clé mia_ : le consentement MCP est toujours interactif.

FAQ

Studeia dispose-t-il d'un serveur MCP pour ChatGPT et Claude ?

Oui. Chaque établissement expose un serveur MCP distant à l'adresse https://<slug>.studeia.com/api/mcp (Streamable HTTP + OAuth 2.1 avec enregistrement dynamique de client et PKCE). Il fonctionne avec Claude.ai, Claude Desktop, Claude mobile, Claude Code et les plugins MCP personnalisés de ChatGPT (Mode développeur).

Que peut faire l'IA une fois connectée ?

Exactement ce que l'utilisateur connecté peut faire sur le web. 139 outils sont disponibles (69 en lecture, 70 en écriture) : lire les cours et les leçons (y compris le contenu complet et le guide de l'enseignant), les groupes-classes, les inscriptions, les notes, les rapports d'élèves et de cours ; et — avec la permission d'écriture — créer et modifier des cours, des modules, des leçons, des guides de l'enseignant, des notes, des banques de questions, des sessions en direct, la gamification, les automatisations et les paramètres de l'établissement. Un outil générique permet d'accéder au reste de l'API institutionnelle documentée.

Un enseignant connecté peut-il voir les données de toute l'école ?

Non. Le token MCP agit comme l'utilisateur réel : les enseignants ne voient et ne modifient que les cours qu'ils ont créés, sur lesquels ils collaborent ou qu'ils enseignent (groupes-classes), et les rapports uniquement des élèves de leurs classes — 76 des 139 outils leur sont accessibles. Les administrateurs de l'établissement voient tout du tenant. Les administrateurs globaux de la plateforme ne peuvent pas se connecter.

Les coordinateurs et les responsables pédagogiques peuvent-ils se connecter ?

Oui. Les coordinateurs et les responsables pédagogiques ont la même portée de lecture et d'écriture que l'administrateur de l'établissement, à l'exception de 14 outils réservés à l'administrateur : configuration des prompts et des limites IA, routage des modèles, configuration pédagogique, paramètres généraux du tenant, outils intégrés, modèle de rapport et gamification globale. Seul l'administrateur de l'établissement peut activer ou désactiver le connecteur.

Puis-je limiter la connexion en lecture seule ?

Studeia ne dispose pas d'un interrupteur « lecture seule » — les portées (lecture, écriture, 30 jours) sont demandées par l'assistant au moment de la connexion. En pratique, vous limitez la portée de quatre façons : dans Claude, en désactivant les outils individuellement dans Gérer les connecteurs (et en répondant « Autoriser une fois » avec discernement) ; dans ChatGPT, en maintenant la permission du plugin sur « Autoriser les actions à faible risque » (par défaut), ce qui fait que chaque écriture demande une confirmation ; dans Claude Code, en refusant la permission par outil ; et, en tant qu'admin, en désactivant « Les enseignants peuvent également se connecter ». Révoquez la connexion lorsque vous avez terminé.

Comment révoquer l'accès de l'IA ?

Dans le profil de l'utilisateur (Connexions IA) ou, pour les administrateurs, dans Paramètres → Connecteurs IA (liste de toutes les connexions du tenant). Désactiver le connecteur révoque immédiatement toutes les connexions. Les tokens d'accès durent 1 heure ; le refresh token dure au maximum 30 jours et est rotatif — après cela, il faut autoriser à nouveau.

Les données des élèves sont-elles envoyées à OpenAI ou Anthropic ?

Les données que l'assistant consulte (y compris les données d'élèves mineurs) sont traitées par le fournisseur IA du compte de l'utilisateur, en dehors de Studeia. L'écran de consentement en avertit explicitement, et chaque appel d'outil est enregistré dans les journaux d'audit de l'établissement (nom de l'outil, identifiants et résultat — jamais le contenu). À utiliser uniquement à des fins pédagogiques légitimes dans le respect des réglementations applicables.

Un plan spécifique est-il requis ou y a-t-il un coût supplémentaire ?

Il n'y a aucun coût supplémentaire dans Studeia et le connecteur est disponible dans tous les plans, y compris la démo gratuite. La seule limite par plan est le taux d'appels par connexion : 1 000 par heure sur la démo et 5 000 par heure sur les plans payants. Le plan ChatGPT ou Claude est contracté auprès du fournisseur concerné et peut conditionner l'accès aux connecteurs personnalisés.

Fonctionne-t-il dans Claude Code (terminal) ?

Oui. Exécutez claude mcp add --transport http studeia https://<slug>.studeia.com/api/mcp, ouvrez /mcp dans la session et cliquez sur Authenticate : le navigateur affiche la connexion et le consentement Studeia avec un avertissement indiquant que le retour va vers une adresse locale (localhost). À partir de là, Claude Code utilise les mêmes 139 outils, en demandant une permission par outil.

Veja tambem

Connecter ChatGPT, Claude ou Claude Code à Studeia (serveur MCP)