Intégration MCP — Connecter votre agent IA à Scolarium

Scolarium expose un serveur MCP (Model Context Protocol) public qui vous permet de connecter Claude Desktop, Claude Code, un GPT personnalisé ou tout autre agent compatible directement à votre établissement. Vous pouvez ainsi piloter Scolarium en langage naturel depuis votre assistant IA préféré.

Qu’est-ce que MCP ?

Le Model Context Protocol est un standard ouvert qui permet à un assistant IA d’utiliser des outils externes de façon contrôlée et sécurisée. En clair, l’agent peut consulter des informations et déclencher des actions à votre place dans Scolarium, sous votre identité et selon vos droits.

Pour en savoir plus sur le protocole lui-même, consultez le site officiel modelcontextprotocol.io.

À qui s’adresse cette intégration ?

L’intégration MCP s’adresse aux utilisateurs avancés qui souhaitent automatiser ou enrichir leur usage de Scolarium :

• Les équipes d’écoles qui veulent gagner du temps sur des actions répétitives (mise à jour de fiches, créations en masse, recherche dans la base de connaissances)
• Les équipes techniques internes qui souhaitent bâtir un assistant sur mesure pour leur établissement
• Les prestataires qui automatisent des flux de travail complexes pour le compte d’écoles clientes

Note

L’utilisation de l’intégration MCP n’est pas requise pour utiliser Scolarium au quotidien. L’application web reste la voie principale pour toutes les opérations.

Adresse du serveur

Le serveur MCP de Scolarium est exposé à l’adresse suivante :

https://api.scolarium.fr/api/mcp

Le serveur utilise le transport Streamable HTTP défini par la spécification MCP. Toutes les requêtes doivent être effectuées en HTTPS.

Authentification

L’accès au serveur MCP utilise votre jeton JWT Scolarium classique, transmis via l’en-tête Authorization: Bearer <token>. Le jeton porte votre identité, votre établissement et votre rôle. Les outils disponibles et les permissions associées sont automatiquement filtrés en conséquence.

Obtenir un jeton

Pour obtenir un jeton :

1. Connectez-vous à Scolarium dans votre navigateur
2. Ouvrez Mon profil depuis le menu utilisateur
3. Rendez-vous dans la section Jetons d’API
4. Cliquez sur Créer un jeton, donnez-lui un nom explicite (par exemple « Claude Desktop maison »)
5. Copiez immédiatement la valeur affichée — elle ne sera plus visible ensuite

Attention

Conservez ce jeton comme un mot de passe. Il donne accès à votre compte Scolarium avec vos droits actuels. Ne le partagez jamais et révoquez-le immédiatement en cas de doute.

Astuce

Vous pouvez créer plusieurs jetons distincts (un par client ou par appareil) pour mieux suivre leur utilisation et les révoquer indépendamment.

Configuration de Claude Desktop

Pour connecter Claude Desktop à Scolarium, ajoutez le bloc suivant dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "scolarium": {
      "transport": {
        "type": "http",
        "url": "https://api.scolarium.fr/api/mcp",
        "headers": {
          "Authorization": "Bearer VOTRE_JETON_ICI"
        }
      }
    }
  }
}

Remplacez VOTRE_JETON_ICI par le jeton obtenu à l’étape précédente, puis redémarrez Claude Desktop. L’icône d’outils MCP doit afficher la connexion à Scolarium.

Note

La configuration est similaire pour Claude Code (clients de bureau), les GPT personnalisés d’OpenAI ou tout autre client MCP compatible HTTP. Reportez-vous à la documentation de votre client pour la syntaxe exacte.

Outils exposés

Le serveur expose dix outils. Les outils visibles pour votre agent dépendent de votre rôle dans Scolarium.

Outil	Description	Rôle requis	Double validation
search_kb	Rechercher dans la base de connaissances Scolarium (aide, documentation)	Tous	Non
get_my_children	Lister vos enfants rattachés à votre compte	Parent	Non
get_student_info	Consulter la fiche d’un élève (informations, classe, contacts)	Parent, Enseignant, Directeur, Administrateur	Non
update_student_birthdate	Corriger la date de naissance d’un élève	Directeur, Administrateur	Oui
update_user_birthdate	Corriger la date de naissance d’un utilisateur	Administrateur	Oui
create_student	Créer une fiche élève	Directeur, Administrateur	Oui
enroll_student	Inscrire un élève dans une classe	Directeur, Administrateur	Oui
get_invoice_status	Consulter l’état d’une facture	Parent, Directeur, Administrateur	Non
create_ticket_from_session	Ouvrir un ticket de support à partir de la conversation en cours	Tous	Non
request_handoff	Demander une prise en main par un humain (équipe Scolarium)	Tous	Non

Astuce

Vous pouvez demander à votre agent « quels outils Scolarium peux-tu utiliser ? » à tout moment. Il listera ceux auxquels il a effectivement accès, en fonction de votre rôle.

Sécurité

Double validation pour les actions sensibles

Les outils qui modifient des données importantes (création, inscription, correction de date de naissance) utilisent un mécanisme de double validation en deux étapes :

1. L’agent prépare l’action et reçoit un identifiant de pré-validation
2. Vous recevez un récapitulatif des changements proposés
3. L’action n’est exécutée qu’après confirmation explicite avec ce même identifiant

Ce mécanisme protège contre les actions non désirées déclenchées par une interprétation hâtive de la demande de l’agent.

Attention

Si votre agent vous demande de confirmer une action sensible, prenez le temps de lire le récapitulatif. La confirmation engage la même responsabilité qu’une saisie directe dans Scolarium.

Journalisation automatique

Toutes les actions effectuées via le serveur MCP sont enregistrées dans le journal d’audit de votre établissement, au même titre que celles effectuées via l’application web. Vous y retrouvez l’utilisateur, l’horodatage, l’outil utilisé et la nature du changement.

Le journal d’audit est consultable depuis l’espace Administrateur, dans Paramètres > Sécurité > Journal d’audit.

Filtrage par rôle

Le serveur applique exactement les mêmes règles de permissions que l’application web. Un parent ne voit que ses propres enfants, un enseignant ne voit que ses classes, un directeur voit son établissement uniquement. Aucun outil ni aucune donnée ne peut être atteint au-delà de votre périmètre habituel.

Limites

Limites de débit

Le serveur applique une limite de débit (« rate limit ») pour préserver la stabilité de la plateforme. Si vous atteignez la limite, votre agent reçoit une erreur explicite et peut réessayer après quelques secondes.

Type de jeton	Requêtes par minute
Standard	60
Élargi (sur demande)	300

Pour relever la limite sur un usage légitime (intégration interne intensive, prestataire), contactez le support à support@scolarium.fr.

Périmètre par rôle

L’agent ne peut effectuer que les actions auxquelles vous avez vous-même accès dans Scolarium. Si vous changez d’établissement ou perdez un rôle, le jeton continue de fonctionner mais avec le périmètre réduit correspondant.

Disponibilité

Le serveur MCP suit la même disponibilité que l’API Scolarium. En cas d’incident, l’état est annoncé sur la page de statut de Scolarium ainsi qu’auprès du support.

Aller plus loin

• Pour un aperçu commercial de l’intégration, consultez la page Pilotez Scolarium avec votre agent IA.
• Pour toute question technique, écrivez à support@scolarium.fr.
• Pour suggérer un nouvel outil MCP, ouvrez un ticket via l’outil create_ticket_from_session directement depuis votre agent, ou via le centre d’aide Scolarium.