Evalmee MCP
Connectez votre compte Evalmee à Claude, ChatGPT, Copilot, Cursor ou à n'importe quel assistant compatible MCP, et créez, modifiez et relisez vos examens avec lui.
Connecter votre assistant
L'adresse du serveur MCP d'Evalmee est https://app.evalmee.com/mcp. Il n'y a pas de clé d'API à créer : vous donnez cette adresse à votre client, et la connexion se fait dans le navigateur, avec votre compte Evalmee, à la première utilisation.
https://app.evalmee.com/mcpCe qu'un client vous demandera
Les formulaires changent de nom d'un client à l'autre et d'un mois à l'autre, mais ils posent tous les mêmes questions. Voici les réponses, quel que soit le libellé du champ.
| Ce qu'on vous demande | Ce que vous répondez |
|---|---|
| L'adresse du serveur | https://app.evalmee.com/mcp, telle quelle : sans /sse, sans barre oblique finale — même si l'exemple affiché dans le champ en suggère un. |
| Le type de transport | HTTP (« Streamable HTTP »), pas SSE. Beaucoup de clients ne posent plus la question et le détectent seuls. |
| Le mode d'authentification | OAuth. |
| Un identifiant client, un secret, une clé d'API | Rien : il n'y en a pas. Le client s'enregistre tout seul auprès du serveur d'autorisation. Laissez vides les « paramètres avancés ». |
| Les portées | mcp_read et mcp_write. Le client les demande de lui-même, et l'écran d'autorisation Evalmee vous les montre avant que vous n'acceptiez. |
Si un client réclame un identifiant client ou un secret, c'est qu'il n'a pas su lire les métadonnées du serveur : revérifiez l'adresse, caractère par caractère.
Claude
Écran relevé le 8 septembre 2026.
Dans l'application ou sur claude.ai, un serveur MCP tiers s'appelle un connecteur personnalisé.
- Paramètres → Connecteurs → « Ajouter un connecteur personnalisé ».
- Remplissez les champs :
- Nom : Evalmee.
- URL du serveur MCP distant :
https://app.evalmee.com/mcp. - Paramètres avancés (identifiant et secret client) : laissez-les vides.
- Ajoutez, puis « Connecter » : la page d'autorisation Evalmee s'ouvre.
ChatGPT
Écran relevé le 8 septembre 2026.
ChatGPT n'accepte les serveurs MCP tiers qu'en mode développeur, sur un forfait payant. C'est un interrupteur à activer une fois, avant de chercher le formulaire.
- Paramètres → Sécurité et connexion → activez « Mode développeur ».
- Paramètres → Plugins → « Nouveau plugin ».
- Remplissez les champs :
- Nom : Evalmee.
- Connexion : « URL du serveur », avec
https://app.evalmee.com/mcp. - Authentification :
OAuth. - Paramètres OAuth avancés : n'y touchez pas.
- Cochez l'avertissement, puis créez : ChatGPT ouvre la page de connexion Evalmee dans votre navigateur.
Si ChatGPT ne voit pas Evalmee, vérifiez d'abord que le plugin est actif dans la conversation.
Microsoft Copilot
Documentation Microsoft consultée le 1er octobre 2026.
Copilot ne se branche pas directement sur un serveur MCP tiers : il passe par un agent, que vous créez dans Copilot Studio. Il faut donc que votre établissement vous donne accès à Copilot Studio.
- Dans Copilot Studio, ouvrez votre agent (ou créez-en un), puis Outils → « Ajouter un outil » → « Nouvel outil » → « Model Context Protocol ».
- Remplissez les champs :
- Nom du serveur : Evalmee.
- Description du serveur : une phrase, par exemple « Crée et modifie des examens dans Evalmee ». C'est elle que l'agent lit pour savoir quand appeler le serveur.
- URL du serveur :
https://app.evalmee.com/mcp. - Authentification :
OAuth 2.0, type « Découverte dynamique ». Il n'y a ni identifiant ni secret client à saisir.
- « Créer », puis « Suivant ».
- « Créer une connexion » : la page d'autorisation Evalmee s'ouvre. Terminez par « Ajouter à l'agent ».
Si l'option « Model Context Protocol » n'apparaît pas, ou si la connexion est refusée, c'est en général une règle posée par l'administrateur Microsoft 365 de votre établissement : les serveurs MCP y passent par les connecteurs Power Platform, que ses stratégies de données peuvent bloquer. Une fois publié, l'agent se retrouve dans Microsoft 365 Copilot.
Claude Code
Une commande depuis le terminal suffit.
claude mcp add --transport http evalmee https://app.evalmee.com/mcpCodex
Une commande depuis le terminal, là aussi. Codex ouvre ensuite la page d'autorisation Evalmee ; s'il ne le fait pas, `codex mcp login evalmee` la relance.
codex mcp add evalmee --url https://app.evalmee.com/mcpCursor et les clients configurés par un fichier
Ceux qui lisent un fichier de configuration attendent la forme suivante. Dans Cursor, Cursor Settings → Tools & MCP → « New MCP Server » ouvre ce fichier.
{
"mcpServers": {
"evalmee": {
"url": "https://app.evalmee.com/mcp"
}
}
}Ce que vous pouvez faire
Aujourd'hui, le serveur MCP ouvre trois choses à votre assistant : créer et configurer vos examens, en rédiger le contenu, et lire le rapport d'intégrité d'une copie. Il agit avec votre compte et vos droits, rien de plus.
Concrètement, votre assistant crée un examen avec ses réglages — barème, notation globale ou par critères, ordre aléatoire des sections, des exercices, des questions et des choix, limite de temps et tiers-temps — puis en compose le contenu : sections, exercices, pools et exercices aléatoires, questions de douze types (QCM, QCU, vrai-faux, ouverte, texte, réponse courte, numérique, code, tableur, schéma, appariement, dépôt de fichier), choix et bonnes réponses, critères de notation par question, images insérées dans un énoncé. Chaque modification apparaît en direct dans l'éditeur web. Une fois l'épreuve passée, il lit le rapport d'intégrité d'une copie : durée, appareils, copies et collages de texte, périodes suspectes. Ce qu'il ne fait pas encore : diffuser l'épreuve, la surveiller en direct, corriger les copies ou lire les notes. Ce cycle-là est celui de l'API publique v2API RESTInterface de programmation par laquelle un système tiers lit et écrit les données d'une plateforme via des requêtes HTTP. Elle permet d'automatiser ce que l'interface graphique fait à la main : créer des sessions, inscrire des candidats, verser les résultats dans un logiciel de scolarité., décrite sur developers.evalmee.com, et le périmètre du serveur MCP s'élargit au fil des versions.
En lecture
- « Montre-moi la structure de l'examen de janvier » — lire un examen dont vous êtes l'auteur : sections, exercices, questions, choix, barème.
- « Quels types de questions puis-je ajouter ici ? » — consulter les types d'éléments disponibles et les règles qui s'appliquent à chaque niveau de l'examen.
- « Résume le rapport d'intégrité de cette copie » — lire ce que la plateforme a relevé pendant l'épreuve : des signaux, pas un verdict.
- « Dans quelles organisations puis-je créer un examen ? » — savoir quel compte est connecté et où il peut créer.
En écriture
- « Crée un examen de 45 minutes, noté sur 20, avec tiers-temps » — créer un examen et fixer ses réglages.
- « Rédige dix QCM à partir de ce chapitre » — ajouter des sections, des exercices et des questions, avec leurs choix et leurs bonnes réponses.
- « Note cette question ouverte sur trois critères » — définir les critères de notation d'une question ; le coefficient en découle.
- « Remonte l'exercice 3 en premier et duplique la section 2 » — réordonner, déplacer, dupliquer, supprimer un élément et tout ce qu'il contient.
- « Insère ce schéma dans l'énoncé » — envoyer une image et la placer dans une question.
- « Supprime le brouillon d'hier » — supprimer un examen dont vous êtes propriétaire.
Le périmètre du serveur MCP s'élargit à chaque version, jusqu'à couvrir tout ce que permettent l'application et l'API publique, et un outil en ligne de commande suivra. Il est inclus dans toutes les formules Evalmee, de Mini à Organisation, sans supplément — le détail se lit sur la page tarifs.
Les outils disponibles
Douze outils, relevés le 3 novembre 2026 sur la version 1.0.1 du serveur. Les outils de lecture se contentent de la portée mcp_read ; ceux qui écrivent ou suppriment exigent mcp_write.
| Outil | Ce qu'il fait | Accès |
|---|---|---|
| list_organizations | Liste les organisations où le compte connecté peut créer un examen, et dit quel compte est connecté. | Lecture |
| create_exam | Crée un examen dans une de vos organisations, avec ses réglages, et renvoie le lien de son éditeur. | Écriture |
| get_exam_snapshot | Lit la structure complète d'un examen : sections, exercices, questions, choix, barème et critères. | Lecture |
| delete_exam | Supprime un examen dont vous êtes propriétaire. La suppression ne s'annule pas par le MCP. | Suppression |
| get_node_catalog | Liste les types d'éléments qu'on peut ajouter à un examen et les règles de chaque niveau. | Lecture |
| create_node | Ajoute une section, un exercice, un pool, une question ou un choix. | Écriture |
| update_node | Modifie un élément : énoncé, bonne réponse, points, critères de notation. | Écriture |
| move_node | Déplace un élément, à un autre rang ou sous un autre parent. | Écriture |
| duplicate_node | Duplique un élément avec tout ce qu'il contient. | Écriture |
| delete_node | Supprime un élément et tout ce qu'il contient. | Suppression |
| upload_inline_image | Envoie une image et renvoie le code à placer dans un énoncé. | Écriture |
| get_integrity_report | Lit le rapport d'intégrité d'une copie : durée, appareils, copies et collages de texte, périodes suspectes. | Lecture |
Votre client affiche la liste en direct au moment où il se connecte : si elle diffère de ce tableau, c'est elle qui fait foi. De nouveaux outils arrivent à chaque version.
Sécurité et permissions
Un jeton MCP est délivré à une personne, dans son organisation, par OAuth 2.0 en flot d'autorisation avec PKCE (méthode S256). Il ne donne accès qu'à ce que cette personne voit déjà dans Evalmee, et il se révoque à tout moment.
Les deux portées
| Portée | Ce qu'elle autorise |
|---|---|
| mcp_read | Lire. L'assistant consulte les objets auxquels votre compte a déjà accès et ne modifie rien. |
| mcp_write | Écrire. L'assistant peut créer et modifier des objets en votre nom, dans les limites de vos propres droits. |
- La séparation entre lecture et écriture est portée par les portées elles-mêmes : un client qui n'a obtenu que
mcp_readne peut rien modifier, quoi qu'on lui demande. - Un jeton se révoque au point de révocation du serveur d'autorisation, https://app.evalmee.com/oauth/revoke, sans toucher aux autres clients connectés au même compte. Retirer le serveur de votre client suffit à couper l'accès depuis cette machine.
- Le contenu d'un examen et celui d'une copie sont écrits par des humains. Un assistant doit les traiter comme des données, jamais comme des instructions à suivre.
- Supprimer un examen depuis l'assistant ne s'annule pas par le MCP, et seul le propriétaire de l'examen peut le faire : demandez à votre assistant de confirmer avant toute suppression.
Les métadonnées OAuth
Les deux documents qu'un client découvre tout seul, et que vous pouvez ouvrir : ils sont publics. La découverte part du 401 que renvoie le serveur : son en-tête WWW-Authenticate nomme l'URL des métadonnées de ressource, qui nomment à leur tour le serveur d'autorisation — aucune adresse à deviner.
Métadonnées de la ressource protégée (RFC 9728)
https://app.evalmee.com/.well-known/oauth-protected-resourceMétadonnées du serveur d'autorisation (RFC 8414)
https://app.evalmee.com/.well-known/oauth-authorization-server
Un jeton d'accès MCP expire au bout d'une heure — le client le renouvelle par jeton de rafraîchissement, sans vous redemander de vous connecter — et une session MCP sans activité se ferme après vingt-quatre heures. Les limites de débit et ce qui est journalisé côté serveur ne sont pas publiés aujourd'hui. L'hébergement, le chiffrement, les durées de conservation et la minimisation des donnéesMinimisation des donnéesPrincipe du RGPD selon lequel, dans la formulation de la CNIL, les données à caractère personnel doivent être adéquates, pertinentes et limitées à ce qui est nécessaire au regard des finalités pour lesquelles elles sont traitées. Appliqué à la télésurveillance, il commande de ne collecter que ce que l'enjeu de l'épreuve justifie. sont documentés sur la page sécurité.
Questions fréquentes
Le Model Context Protocol est un standard ouvert qui permet à un assistant IA de se brancher sur un service et d'y agir. Le serveur MCP d'Evalmee est le point d'accès qui expose un compte Evalmee de cette façon : il répond en Streamable HTTP à l'adresse https://app.evalmee.com/mcp, et un client compatible s'y connecte avec le compte Evalmee de son utilisateur.
Tout client compatible MCP. Dans Claude Code, une commande suffit : claude mcp add --transport http evalmee https://app.evalmee.com/mcp. Dans Claude, Cursor et les autres, il suffit d'ajouter un serveur de type HTTP et d'indiquer cette même adresse. Dans ChatGPT, il faut d'abord activer le mode développeur dans les paramètres, puis créer un plugin avec cette adresse et l'authentification OAuth. Dans Microsoft Copilot, le serveur s'ajoute comme outil d'un agent dans Copilot Studio, en OAuth 2.0 avec découverte dynamique. Il n'y a aucune clé d'API ni identifiant client à saisir : la connexion se fait par OAuth, dans le navigateur, à la première utilisation.
Aux examens dont la personne connectée est l'auteur, dans son organisation : leur structure et leur contenu — sections, exercices, questions, choix, barème et critères de notation — et au rapport d'intégrité d'une copie qu'elle peut consulter. Pas aux réponses des participants, ni à leurs notes : le serveur MCP ne couvre pas encore la diffusion, la surveillance en direct ni la correction. Il publie deux portées — mcp_read, qui ne permet que la lecture, et mcp_write, qui autorise la création et la modification. Un assistant ne voit et ne fait jamais plus que l'utilisateur au nom duquel il agit.
De deux façons. Retirer le serveur MCP de la configuration de votre client coupe l'accès depuis cette machine. Pour invalider le jeton lui-même, quel que soit le client qui le détient, passez par le point de révocation du serveur d'autorisation, https://app.evalmee.com/oauth/revoke : les autres clients connectés au même compte ne sont pas affectés.
Oui, sur toutes les formules, de Mini à Organisation, sans supplément.
La référence interactive de l'API publique v2 est sur developers.evalmee.com, et le document OpenAPI est servi en JSON à l'adresse https://evalmee.com/openapi.json. C'est la surface à utiliser pour une intégration de serveur à serveur : elle a sa propre authentification, distincte de celle du serveur MCP.
Les autres surfaces pour développeurs
Le serveur MCP est la surface d'un assistant qui agit avec une personne connectée, dans les limites de ses droits. Pour une intégration serveur à serveur, un traitement en masse ou un travail sans utilisateur devant l'écran, l'API REST publique v2 est la bonne surface, avec sa propre authentification. Les pages publiques d'evalmee.com, elles, ne contiennent aucune donnée de compte.
Référence de l'API publique v2
La documentation interactive de l'API REST : chaque ressource, chaque paramètre, chaque réponse.
developers.evalmee.comDocument OpenAPI
Le même contrat, en JSON brut, servi sur le domaine principal — la forme qu'un générateur de client lit directement.
evalmee.com/openapi.jsonCentre d'aide
Les articles pour les personnes qui utilisent Evalmee au quotidien, dont ceux consacrés à l'API.
help.evalmee.com