ENT ONE (Edifice)

ent1-mcp

Parlez à l'ENT de vos enfants depuis votre assistant IA.

ent1-mcp est un serveur MCP (Model Context Protocol) pour l'ENT ONE, l'espace numérique de travail des écoles construit sur la plateforme Edifice (ex-Open Digital Education). Il permet à Claude, ChatGPT ou tout autre assistant compatible MCP de lire et d'écrire dans l'ENT à votre place : messagerie avec les enseignants, carnet de liaison, cahier de texte, actualités de l'école, blogs de classe, calendrier, casier, documents, formulaires…

Écrit en Rust, sans dépendance à un navigateur, il se connecte avec vos identifiants habituels et ne stocke rien.

[!IMPORTANT]

Projet communautaire non officiel. Il n'est ni développé, ni soutenu, ni validé par Edifice, par l'Éducation nationale ou par une académie. Il utilise l'API interne que l'application web de l'ENT appelle elle-même, qui peut changer sans préavis.

---

Sommaire

• Ce que vous pouvez demander
• Fonctionnalités
• Installation
• Configuration
• Brancher un assistant
• Sécurité et vie privée
• Autres ENT Edifice
• Architecture
• Développement
• Limites connues
• Feuille de route
• Contribuer
• Licence

---

Ce que vous pouvez demander

« Qu'est-ce qui s'est passé sur l'ENT cette semaine ? »

« Y a-t-il des mots du carnet de liaison que je n'ai pas encore signés ? Signe-les. »

« Quels sont les devoirs de Léa pour jeudi ? Coche ceux qu'elle a déjà faits. »

« Écris à la maîtresse de CM1 pour la prévenir que Léa sera absente vendredi matin (rendez-vous chez l'orthophoniste). Montre-moi le message avant de l'envoyer. »

« Résume-moi les trois dernières actualités de l'école et ajoute les dates importantes à ma liste. »

« Dépose l'attestation d'assurance dans le casier de l'enseignante. »

L'assistant enchaîne lui-même les outils : il cherche l'enseignante dans l'annuaire, rédige le message, vous le soumet, puis l'envoie.

Fonctionnalités

48 outils, regroupés par application de l'ENT. Les outils de lecture sont annotés readOnlyHint, les suppressions destructiveHint : les clients MCP s'en servent pour demander (ou non) votre confirmation.

Détails utiles :

• Texte brut partout. Le HTML de l'ENT est converti en texte à la lecture ; à l'écriture, votre texte est échappé puis mis en paragraphes. Aucune injection de HTML possible.
• Réponses structurées. Chaque outil renvoie un JSON typé (structuredContent) avec son schéma de sortie, en plus du texte.
• Fichiers en base64, 10 Mo maximum par fichier, dans les deux sens.
• Dates dans votre fuseau horaire (Indian/Reunion par défaut).
• Messages rappelables pendant 60 minutes (messagerie_rappeler), comme dans l'ENT.

Installation

Avec Cargo

Il faut Rust 1.88 ou plus récent.

cargo install --git https://github.com/edouard-claude/ent1-mcp

Le binaire ent1-mcp est installé dans ~/.cargo/bin.

Depuis les sources

git clone https://github.com/edouard-claude/ent1-mcp

cd ent1-mcp cargo build --release

binaire : target/release/ent1-mcp

Avec Docker

L'image est publiée sur GitHub Container Registry à chaque version. Par défaut elle parle en stdio, comme le binaire :

docker run --rm -i -e ENT1_IDENTIFIANT -e ENT1_MOT_DE_PASSE ghcr.io/edouard-claude/ent1-mcp

En mode HTTP :

docker run --rm -p 8080:8080 \

-e ENT1_TRANSPORT=http -e ENT1_ECOUTE=0.0.0.0:8080 \ -e ENT1_IDENTIFIANT -e ENT1_MOT_DE_PASSE -e ENT1_MCP_JETON \ ghcr.io/edouard-claude/ent1-mcp

Depuis le registre officiel MCP

Le serveur est référencé dans le registre MCP sous le nom io.github.edouard-claude/ent1-mcp : les clients qui s'appuient sur le registre le proposent directement, avec les variables à renseigner.

Configuration

Tout se règle par variables d'environnement. Les secrets ne peuvent pas être passés en argument de ligne de commande : ils apparaîtraient dans la liste des processus.

Un modèle est fourni dans .env.exemple.

Au démarrage, le serveur ouvre une session sur l'ENT : des identifiants erronés sont signalés tout de suite, pas au premier appel d'outil.

\* Sans aucun des deux, le serveur démarre quand même (utile pour l'inspecter ou le référencer) : il liste ses outils, et chacun répond qu'aucun compte n'est configuré.

Brancher un assistant

Claude Desktop

Ouvrez *Réglages → Développeur → Modifier la configuration* et ajoutez :

{

"mcpServers": { "ent": { "command": "/Users/vous/.cargo/bin/ent1-mcp", "env": { "ENT1_IDENTIFIANT": "prenom.nom", "ENT1_MOT_DE_PASSE": "votre-mot-de-passe" } } } }

Redémarrez Claude Desktop : les outils de l'ENT apparaissent dans le menu des connecteurs.

Claude Code

claude mcp add ent --env ENT1_IDENTIFIANT=prenom.nom --env ENT1_MOT_DE_PASSE=votre-mot-de-passe -- ent1-mcp

Mode HTTP (assistant distant, API)

Pour un assistant qui ne tourne pas sur votre machine, lancez le serveur en Streamable HTTP derrière un reverse proxy HTTPS :

export ENT1_TRANSPORT=http

export ENT1_ECOUTE=0.0.0.0:8080 export ENT1_HOTES=ent-mcp.mondomaine.fr export ENT1_MCP_JETON="$(openssl rand -hex 32)" ent1-mcp

Le point d'accès est https://ent-mcp.mondomaine.fr/mcp, protégé par l'en-tête Authorization: Bearer . Une sonde de santé répond sur /sante.

Exemple avec le connecteur MCP de l'API Claude :

"mcp_servers": [{

"type": "url", "url": "https://ent-mcp.mondomaine.fr/mcp", "name": "ent", "authorization_token": " " }]

claude.ai et ChatGPT (web et mobile)

Les connecteurs personnalisés de claude.ai et de ChatGPT n'acceptent pas de jeton fixe : ils exigent OAuth 2.1. Le mode HTTP actuel ne suffit donc pas pour eux. C'est la prochaine étape du projet (voir la feuille de route) : une page de connexion où chaque parent saisit ses identifiants ENT, sans jamais les confier à l'assistant.

Sécurité et vie privée

L'ENT contient des données d'enfants. Ce projet part de ce principe.

Ce que fait le serveur

• Il ne stocke rien : ni message, ni document, ni identifiant sur disque. La session ENT (cookie) vit en mémoire et disparaît à l'arrêt.
• Le mot de passe n'est lu que dans l'environnement et reste enveloppé dans un type secrecy : il n'apparaît ni dans les journaux, ni dans les messages d'erreur, ni dans Debug.
• Si l'ENT refuse les identifiants, le serveur cesse toute tentative jusqu'à son redémarrage, pour ne pas faire verrouiller votre compte.
• Les reconnexions sont sérialisées : dix requêtes qui trouvent la session expirée déclenchent une seule connexion.
• Chaque identifiant fourni par l'assistant est vérifié avant d'être placé dans une URL : impossible de détourner un appel vers une autre route de l'ENT.
• Toute écriture porte le jeton anti-CSRF de l'ENT (X-XSRF-TOKEN), comme l'application web.
• En HTTP : jeton obligatoire comparé en temps constant, protection contre le *DNS rebinding* (liste d'hôtes autorisés), unsafe interdit dans tout le code.

Ce que vous devez savoir

• Les contenus lus par l'assistant (messages, mots, noms d'enfants et d'enseignants) sont envoyés au fournisseur de l'assistant (Anthropic, OpenAI…). Lisez sa politique de confidentialité et, si possible, désactivez l'utilisation de vos conversations pour l'entraînement.
• L'assistant agit en votre nom. Demandez-lui de toujours vous montrer un message avant de l'envoyer ; les instructions du serveur le lui rappellent, et la plupart des clients demandent une confirmation avant chaque outil d'écriture.
• N'exposez jamais le mode HTTP sans HTTPS ni sans jeton.

Une faille ? Merci de la signaler en privé (voir SECURITY.md) plutôt que dans une issue publique.

Autres ENT Edifice

L'ENT ONE est une déclinaison de la plateforme open source Edifice, également utilisée sous d'autres noms (NEO, ONE dans d'autres académies, ENT de collectivités…). Les routes utilisées étant celles du socle commun, ent1-mcp devrait fonctionner ailleurs en changeant ENT1_URL. Seule l'instance de La Réunion (ent1d.ac-reunion.fr) a été testée : vos retours sont bienvenus.

Les ENT qui imposent une connexion ÉduConnect ou une double authentification ne sont pas pris en charge pour l'instant (voir limites).

Architecture

  Assistant (Claude, ChatGPT…)

│ MCP : stdio ou Streamable HTTP (+ jeton) ▼ ┌──────────────────────────────┐ │ ent1-mcp │ │ outils/ 48 outils MCP │ un module par application de l'ENT │ texte.rs HTML ⇄ texte │ │ ent/ client HTTP │ session, reconnexion, XSRF, identifiants typés └──────────────┬───────────────┘ │ HTTPS, cookie de session ▼ ENT ONE / Edifice (/conversation, /schoolbook, /homeworks, /actualites, /blog, /rack…)

• Connexion : formulaire POST /auth/login, puis cookie de session. Une réponse 401 ou une redirection vers la page de connexion déclenche une reconnexion et un unique rejeu de la requête.
• Un compte par processus : le client ENT est partagé par toutes les sessions MCP du processus. Pour servir plusieurs familles, lancez un processus par compte (ou attendez le mode OAuth).
• Stack : [rmcp](https://crates.io/cra