Evalmee MCP
Connectez votre compte Evalmee à Claude, ChatGPT, Copilot, Cursor ou à n'importe quel assistant compatible MCP, et rédigez vos examens avec lui, directement dans l'éditeur.
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 une chose à votre assistant : l'éditeur d'examen. Il lit la structure d'un examen dont vous êtes l'auteur et la modifie avec vous — c'est l'atelier de rédaction du sujet, pas le cycle de l'épreuve.
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 neuf types (QCM, QCU, vrai-faux, ouverte, texte, 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. Ce qu'il ne fait pas encore : diffuser l'épreuve, surveiller, corriger les copies ou lire les résultats. 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.
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.
Votre client affiche la liste exacte des actions disponibles au moment où il se connecte : c'est elle qui fait foi, et c'est pourquoi elle n'est pas recopiée ici. Le serveur MCP est en bêta : son périmètre rejoindra celui de l'API publique, version après version, 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.
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. Pas aux copies, ni aux résultats, ni aux participants : le serveur MCP ne couvre aujourd'hui que l'éditeur d'examen. 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. Il est encore en bêta.
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