Serveur MCP

Aperçu

Creator embarque un serveur MCP (Model Context Protocol) intégré. Tout assistant IA compatible MCP — Claude sur claude.ai, Claude Code, MCP Inspector — peut se connecter à votre compte Creator et, depuis un chat, faire tout ce que fait l'éditeur :

  • Parcourir votre espace de travail et vos organisations
  • Créer des dossiers, cours, microlearnings et banques de questions
  • Ajouter, modifier, déplacer et supprimer des leçons et les 46 types de Bricks avec leur configuration complète
  • Gérer la bibliothèque de thèmes de l'organisation et choisir le thème de chaque contenu (couleurs, polices, couverture, CSS personnalisé)
  • Exporter en SCORM, web ou PDF, exporter la banque de questions (GIFT, Moodle XML ou QTI 2.1), publier des liens de partage, gérer les instantanés, dupliquer et traduire

L'authentification utilise OAuth via votre compte SLXD : l'assistant ne voit jamais votre mot de passe et vous pouvez révoquer l'accès à tout moment. Tout ce que fait l'assistant est limité à ce que votre utilisateur peut faire — l'appartenance à l'organisation et les rôles sont appliqués à chaque appel.

Connexion

Le point de terminaison MCP est l'URL de connecteur de votre organisation :

https://<votre-organisation>.slxd.app/mcp/creator

Inutile de la composer à la main : la plateforme SLXD l'affiche sous Organisation > Connecteurs, à côté des connecteurs des autres produits de la suite.

claude.ai

  1. Allez dans Paramètres > Connecteurs > Ajouter un connecteur personnalisé
  2. Collez l'URL du point de terminaison
  3. Terminez la connexion et autorisez l'accès

Claude Code

claude mcp add --transport http creator https://<votre-organisation>.slxd.app/mcp/creator

Le premier appel ouvre le navigateur pour se connecter et autoriser l'accès.

Les clients s'enregistrent automatiquement (enregistrement dynamique de client OAuth) — il n'y a rien à configurer côté serveur.

Fonctionnement des outils

Le serveur expose un ensemble sélectionné d'outils de premier niveau (navigation dans l'espace de travail, CRUD contenu/leçon, Bricks, thème, export, téléversement de fichiers, duplication d'un contenu) ainsi que trois méta-outils qui débloquent le catalogue complet.

browse_workspace répond à trois besoins : parcourir un niveau de dossier, rechercher dans toute la portée par titre/nom avec query, ou cartographier l'arborescence complète des dossiers en un seul appel avec recursive: true (chaque dossier avec son parentId). Pour cloner un contenu — leçons, Bricks et ressources — comme modèle, utilisez duplicate_content (premier niveau) ; duplicate_lesson fait de même pour une seule leçon.

Au-delà de la création de contenu, le catalogue couvre aussi : le cycle de vie complet de la corbeille pour les dossiers (restore_folder, delete_folder_permanently) et les opérations en lot sur les contenus (batch_move_contents, batch_trash_contents) ; la copie d'un contenu vers un autre espace, toujours une copie et jamais un déplacement (copy_content_to_tenant) ; la gestion des versions (rename_snapshot, delete_snapshot) ; la recherche dans les bibliothèques de ressources sous licence et l'importation d'une ressource dans un contenu (search_stock_images/import_stock_image, search_stock_icons/import_stock_icon) ; ainsi que l'audit et la correction des problèmes d'accessibilité (voir ci-dessous). Les médias que le modèle génère lui-même sont téléversés avec request_asset_upload.

Méta-outilObjectif
find_toolsRechercher dans tout le catalogue par mot-clé (publication, instantanés, traduction, modèles, corbeille…)
tool_schemaObtenir le schéma d'entrée de n'importe quel outil du catalogue
run_toolExécuter un outil du catalogue par son nom

Pour les Bricks, list_brick_types liste chaque type regroupé par catégorie (texte, médias, collections, questions, jeux, structure de la leçon — structure) avec une indication « quand l'utiliser » pour choisir celui qui convient à un objectif pédagogique, et get_brick_type_schema renvoie la forme exacte de rédaction (avec un exemple) pour chacun — le texte enrichi est rédigé en HTML simple. Le code en ligne (<code>) est accepté dans tout champ de texte multiligne et les blocs de code (<pre><code class="language-…">, langage conservé) dans ceux au format complet (get_brick_type_schema les liste sous richText) ; les champs d'une seule ligne refusent les deux avec une erreur qui nomme le champ. Ce qui est enregistré mais modifié en chemin —une balise, un attribut ou un style que l'éditeur ne peut pas conserver, un lien dans un champ sans liens, des paragraphes réunis dans un champ d'une ligne— revient dans le résultat de add_brick et update_brick sous warnings, champ par champ, sans devoir relire la leçon.

La catégorie structure contient le type CONDITIONAL (Contenu conditionnel) : add_brick reçoit ses branches et les blocs de chacune en un seul appel, get_lesson renvoie les blocs imbriqués dans chaque branche, et update_brick, move_brick et delete_brick agissent sur le groupe entier. La grammaire de la condition et les règles (un seul niveau, jamais dans les évaluations ni les banques) figurent dans Contenu conditionnel ; le manifeste et les messages des simulations qu'il lit, dans Paquets intégrés et simulations.

Choisir le bon Brick

Pour aider l'assistant à choisir le Brick le plus approprié, list_brick_types porte une indication « quand l'utiliser » par type, et la ressource creator://guides/brick-selection est un guide de sélection complet (intention → Bricks recommandés). Les deux sont générés à partir de la même source, donc ils ne divergent jamais, et les deux fonctionnent dans n'importe quel client MCP.

Thèmes

Les thèmes se trouvent dans la bibliothèque de thèmes de l'organisation et chaque contenu en utilise un. Plusieurs contenus peuvent partager le même thème : modifier un thème modifie tous les contenus qui l'utilisent.

OutilÀ quoi il sert
list_themesVoir les thèmes de la bibliothèque, le nombre de contenus qui utilisent chacun et le thème par défaut (celui que reçoivent les nouveaux contenus)
get_themeLire un thème par contentId (celui qu'utilise ce contenu) ou par themeId. Renvoie aussi sa version et le nombre de contenus qui l'utilisent
get_theme_schemaVoir ce qu'un thème peut contenir, sans lire aucun thème : pour chaque champ, son chemin exact, la forme qu'il accepte (une longueur ou jusqu'à quatre, une couleur en texte — palette:accent — dans les styles des Bricks ou en {"paletteId": "accent"} ailleurs, options, plages), sa valeur par défaut ou le champ dont il la tient, ce qu'il change à l'écran et les types de Brick qui l'utilisent. Sans filtre, il liste les sections et ce que le thème ne peut pas changer (avec l'alternative) ; filtrez par section, par brickType (p. ex. TIMELINE) ou par texte avec search
update_themeModifier un thème par contentId ou par themeId. Cela concerne tous les contenus qui l'utilisent, et la réponse indique combien (affectedContents). Si vous passez la version lue et que quelqu'un d'autre a modifié le thème entre-temps, rien n'est enregistré et il faut le relire. Ce qu'il enregistre autrement que reçu, ou avec un problème, revient dans warnings, champ par champ : un champ qui n'existe pas (avec le plus proche), une valeur d'une autre forme (avec celle qu'accepte ce champ, la même que donne get_theme_schema) ou hors plage, une valeur enregistrée autrement, ce qu'il écarte d'une police personnalisée (seulement regular, regularItalic, bold et boldItalic, graisses 400 et 700) et, si les couleurs changent, un « Texte sur l'accent » qui n'atteint pas le contraste AA (4,5:1) avec l'accent ; sans valeur propre, ce texte utilise la couleur du texte
create_themeCréer un thème : avec l'apparence par défaut, à partir d'un préréglage, ou comme copie d'un autre thème ou du thème d'un contenu
set_content_themeChoisir le thème d'un contenu
apply_theme_presetDonner à un contenu l'apparence d'un préréglage : il reçoit un thème de la bibliothèque identique au préréglage, créé s'il n'en existe aucun
reset_themeRemettre le thème par défaut de l'organisation sur un contenu
delete_themeSupprimer un thème qu'aucun contenu n'utilise (pas même dans la corbeille) et qui n'est pas le thème par défaut

Pour modifier l'apparence d'un seul contenu dont le thème est partagé, copiez son thème (create_theme avec fromContentId), attribuez-lui la copie avec set_content_theme et modifiez la copie. Changer le thème d'un contenu ne modifie pas celui qu'il cesse d'utiliser : il reste dans la bibliothèque. import_theme_from_content n'existe plus : utiliser le thème d'un autre contenu revient à le choisir avec set_content_theme.

Toute personne qui peut modifier des contenus dans l'organisation peut modifier ses thèmes.

Téléverser des fichiers

Le contenu Creator utilise des fichiers — images, vidéo, audio, sous-titres, pièces jointes téléchargeables, polices personnalisées, packages d'intégration — et le MCP peut les téléverser. Le binaire ne transite jamais par le MCP (pas de base64) : l'outil génère une URL de téléversement présignée à courte durée de vie et le client envoie le fichier directement au stockage, hors bande.

Le flux pour une ressource de Brick :

  1. Appelez request_asset_upload avec le contentId cible, le kind (image | video | audio | subtitle | attachment | font) et le contentType du fichier (par exemple image/png). Pour un fichier du thème (logo, image d'en-tête, icônes, polices woff2 personnalisées), passez themeId au lieu de contentId : le fichier reste avec le thème et ne dépend d'aucun contenu ; seuls image et font sont acceptés. Chaque type dispose d'une liste MIME autorisée, donc un type incohérent est rejeté d'emblée.
  2. L'outil renvoie { uploadUrl, path, curlCommand, expiresAt }. Téléversez le fichier — exécutez la curlCommand renvoyée (en remplaçant <local-file> par le chemin réel) ou faites un PUT des octets vers uploadUrl avec le Content-Type exact. L'URL expire au bout de 15 minutes.
  3. Placez le path renvoyé dans le champ média du Brick via add_brick / update_brick (imagePath, videoPath, audioPath, filePath, posterPath, subtitlesPath, front*/back*/…), ou dans le thème via update_theme (logo, polices woff2 personnalisées), avec le même themeId. L'image de couverture et le titre du cours appartiennent à chaque contenu, pas au thème : téléversez l'image avec le contentId et appliquez-la avec update_content (coverImagePath ; courseTitle pour le titre du cours) ; get_content les renvoie. Pour remplacer l'image de couverture, placez le nouveau path dans coverImagePath : l'image change, le titre du cours et le voile restent tels quels ; le fichier précédent n'est pas supprimé, le balayage du stockage le récupère. Le voile de l'image ainsi que la position et les styles du titre du cours restent dans le thème. L'image des en-têtes de leçon appartient aussi au contenu : appliquez-la avec update_content (lessonHeaderImagePath) et le thème l'affiche avec lessonHeader.background.type: image ; chaque leçon peut avoir la sienne avec update_lesson (headerImagePath ; null hérite à nouveau), qui l'emporte toujours. Le voile reste dans le thème (lessonHeader.image.overlay).

list_content_assets renvoie les fichiers déjà téléversés pour un contenu, afin qu'une ressource existante puisse être réutilisée plutôt que téléversée à nouveau.

Les images SVG sont l'exception : un SVG est du code, il n'est donc jamais téléversé par une URL signée (request_asset_upload refuse image/svg+xml). Envoyez-le avec upload_svg_image : le SVG voyage dans l'appel, en texte (svg) ou en base64 (svgBase64), jusqu'à 5 Mo, avec contentId ou themeId. Le serveur l'assainit avec les mêmes règles que l'éditeur (scripts, attributs d'événement, liens et ressources externes supprimés) et ne stocke que le résultat ; le path renvoyé s'utilise dans n'importe quel champ d'image. S'il ne peut pas être lu sans risque, rien n'est stocké et l'erreur porte un code stable : [svg_not_svg], [svg_malformed] ou [svg_too_large]. Un SVG s'affiche toujours comme une image, qui ne charge aucune police externe : si son texte n'intègre pas sa police (ou n'est pas converti en tracés), le résultat porte l'avertissement svg_text_without_font et le texte utilisera la police de l'appareil de l'apprenant. Les banques d'images et d'icônes (import_stock_icon, import_stock_image) assainissent les SVG de la même façon. import_stock_image n'accepte qu'une downloadUrl telle que search_stock_images l'a renvoyée, avec le même provider, et n'enregistre que des images : le type est lu dans les octets téléchargés (PNG, JPEG, WebP, GIF, AVIF ou un SVG assaini, jusqu'à 30 Mo), jamais dans l'URL ni dans le Content-Type. Le reste n'enregistre rien et échoue avec un code stable : [stock_url_not_allowed], [stock_not_image], [stock_too_large], [stock_blocked_target] (une redirection vers une adresse sans https ou interne) ou [stock_too_many_redirects].

Les Bricks d'intégration (un package autonome index.html + ressources) utilisent request_embed_upload : téléversez chaque fichier du package sous le même folderId, puis définissez le embedFolderPrefix renvoyé sur le Brick EMBED. Ces fichiers atterrissent dans le bucket privé embeds avec leur Content-Type fixé, et sont servis aux spectateurs via des URL éphémères propres à chaque dossier — jamais depuis un domaine public. Pour que le paquet puisse terminer le brick (et respecter ainsi son blocage) ou fixer sa propre hauteur, téléversez aussi un slxd-embed.json à sa racine —p. ex. {"protocol":"slxd-embed","version":1,"capabilities":["complete","resize"]}— avant de définir le dossier sur le brick : il est lu à ce moment-là et conservé dans la propriété en lecture seule embedPackage. add_brick et update_brick avertissent (warnings) si le blocage ne pourra pas être respecté. Pour une simulation, déclarez aussi state, result et interaction, et écrivez dans le bloc simulationId (unique dans le contenu : un identifiant répété est refusé), scored et weight — get_brick_type_schema décrit le protocole et la notation ; un bloc écrit avant que le paquet déclare les nouvelles capacités doit réécrire son embedFolderPrefix pour relire le manifeste. Son slxd-embed.json peut aussi déclarer les variables de son état, avec leur type ("variables": {"trust": "number", "reused": "boolean"}), pour que le contenu conditionnel les lise ; grade, score, maxScore, ending et kind sont des noms réservés (ils lisent toujours le résultat du paquet) et un paquet qui les déclare comme variables est refusé au téléversement. Le manifeste, les messages et leurs limites sont expliqués dans Paquets intégrés et simulations.

Les imports suivent le même schéma présigné :

  • Articulate Rise — start_rise_import (téléverser le .zip) → confirm_rise_import → interroger get_rise_import jusqu'à completed pour lire le contentId créé.

L'import de documents (Importer un document) n'est intentionnellement pas exposé via MCP : son étape d'analyse dépend d'une extraction côté navigateur dans l'application, donc le flux ne peut pas se terminer en mode headless — faites-le depuis l'application.

Tous les outils de téléversement autorisent le contenu ou le thème cible (portée + appartenance à l'organisation ; pour un thème, également le droit de modifier les thèmes) avant de signer, et le serveur construit la clé de stockage — un client ne fournit jamais de chemin brut.

Accessibilité

Le même vérificateur WCAG 2.2 qui alimente le vérificateur d'accessibilité de l'éditeur est exposé via MCP, afin qu'un assistant puisse examiner et corriger un cours de bout en bout :

  1. audit_content_accessibility — comptes d'erreurs/avertissements par leçon sur un contenu. Commencez ici pour une vue d'ensemble du cours.
  2. audit_lesson_accessibility — tous les problèmes d'une leçon : la règle, le critère WCAG, le Brick concerné, une raison et un texte de remédiation (dans la langue du contenu), et — lorsqu'une correction sûre existe — un descripteur autofixes.
  3. apply_accessibility_autofix — applique l'un de ces descripteurs (marquer une image comme décorative, corriger un niveau de titre, activer un en-tête de tableau, …) au Brick/élément exact. Une seule étape d'annulation ; les changements atteignent un éditeur ouvert en temps réel, comme update_brick.
  4. generate_accessibility_alt_text — pour les images sans correction déterministe sûre, envoie l'image au modèle de vision IA configuré et renvoie un texte alternatif suggéré. Cela n'écrit rien — appliquez le résultat avec apply_accessibility_autofix (kind: "set-property", ou "set-item-property"/"set-character-property" pour les images de galerie/dialogue). Consomme des Crédits de l'organisation, comme les autres outils IA.

Un flux typique : appelez audit_content_accessibility, choisissez une leçon avec des problèmes, appelez audit_lesson_accessibility dessus, appliquez les corrections déterministes, générez et appliquez le texte alternatif pour le reste, puis relancez l'audit de la leçon pour confirmer qu'elle est propre.

Conception pédagogique

Un assistant peut construire et vérifier une conception pédagogique entière, par exemple en reconstruire une à partir d'un fichier Excel que vous lui donnez. Les outils commencent par design_matrix_. design_matrix_create, design_matrix_get, design_matrix_list, design_matrix_validate et design_matrix_generate_course sont de premier niveau ; les autres s'atteignent avec find_tools et run_tool.

OutilÀ quoi il sert
design_matrix_createCréer une conception : nom, durée, niveau, public, langue (idioma ; par défaut, celle de votre compte) et modèle de structure (non modifiable une fois choisi)
design_matrix_getLire toute la conception en un appel — fiche, compétences, objectifs, arbre de structure et activités — avec les identifiants nécessaires à toute modification
design_matrix_listLister les conceptions, ou la corbeille avec inTrash: true
design_matrix_update, design_matrix_delete, design_matrix_restoreModifier la fiche (y compris sa langue) ; envoyer une conception à la corbeille et l'en sortir (la supprimer définitivement, uniquement dans l'application)
design_matrix_competencia_create, _update, _delete, _reorderCompétences
design_matrix_objetivo_create, _update, _delete, _set_competencias, _reorderObjectifs, avec leur niveau de Bloom, leur code visible (clave, facultatif) et les compétences qu'ils servent
design_matrix_node_create, _rename, _update_horas, _update_objetivo_general, _set_rol, _reorder, _move, _change_level, _subdivide, _deleteL'arbre de structure : modules, unités, sections et sous-sections ; _set_rol marque une section comme introduction ou résumé de son unité
design_matrix_node_link_objetivo, design_matrix_node_unlink_objetivoRelier un objectif à une feuille de l'arbre, ou le délier
design_matrix_aa_*, design_matrix_ae_* (create, update, delete, set_objetivos, reorder)Les activités d'apprentissage (aa, d'une unité ou d'une section) et d'évaluation (ae, d'une unité), et les objectifs qu'elles servent
design_matrix_validateExécuter les mêmes vérifications que le panneau de Validation de l'application et lire chaque résultat sous forme de phrase, dans la langue de la conception ou dans celle demandée (locale) et avec le titre de l'élément concerné
design_matrix_exportObtenir un lien de téléchargement signé pour le classeur Excel (.xlsx), avec les libellés dans la langue de la conception ou dans celle demandée (locale) ; le lien expire au bout de 24 heures environ
design_matrix_generate_courseCréer les cours d'une conception qui passe la validation, dans la langue de la conception sauf si vous en demandez une autre (locale). Une seule génération à la fois par conception ; si l'une s'arrête à mi-chemin, la redemander avec la même portée reprend ce qui manquait sans dupliquer de cours. Avec leccionActividades et leccionesEvaluacion (true, false ou "separadas"), vous choisissez, comme dans la boîte de dialogue de l'application, si les leçons d'activités sont créées et où vont les questionnaires
design_matrix_redaccion_statusSuivre la rédaction par l'IA des cours générés et savoir si la génération est toujours en cours, sans consommer de crédits
design_matrix_review_contextObtenir le matériel pour réviser la rédaction et l'alignement avec le propre modèle d'IA de l'assistant : les mêmes critères que la révision IA de l'application, sans consommer de crédits
design_matrix_dictamen_submitEnregistrer les avis de l'assistant comme avis en attente, avec l'étiquette « Revue de l’agent » dans la section de révision IA de l'application ; rien dans la conception ne change tant que vous ne les acceptez pas là-bas. Sans consommer de crédits
design_matrix_dictamen_listLister les avis d'une conception, venant de l'IA de l'application ou de l'assistant, et leur état

Supprimer une conception, un nœud, une compétence, un objectif ou une activité exige confirm: true, comme toute autre action destructrice. La révision IA de l'application et la rédaction par l'IA des cours générés ne sont pas disponibles via MCP — elles consomment des crédits et demandent la confirmation à l'écran — faites-les donc dans l'application ; l'état de la rédaction se consulte avec design_matrix_redaccion_status. Votre assistant peut en revanche faire la révision lui-même, avec son propre modèle d'IA et sans consommer de crédits : il demande le matériel avec design_matrix_review_context et enregistre ses avis avec design_matrix_dictamen_submit. Ils apparaissent dans la section Révision IA avec l'étiquette « Revue de l’agent », en attente jusqu'à ce que vous les acceptiez, les corrigiez ou les rejetiez là-bas.

Les outils qui remplacent tout un ensemble de liens (design_matrix_objetivo_set_competencias, design_matrix_aa_set_objetivos et design_matrix_ae_set_objetivos) acceptent expectedUpdatedAt, le updatedAt de cet élément tel que design_matrix_get l'a renvoyé : si quelqu'un l'a modifié entre-temps, l'appel est refusé sans rien écrire et l'assistant sait qu'il doit le relire.

Le updatedAt de la conception que renvoient design_matrix_get et design_matrix_list change à chaque modification de son contenu —compétences, objectifs, structure, liens, activités ou heures—, pas seulement de sa fiche : le comparer indique si quelque chose a changé depuis la dernière lecture.

Collaboration en temps réel

Les modifications de Bricks effectuées via MCP sont fusionnées via le serveur de collaboration : si quelqu'un a la leçon ouverte dans l'éditeur, il voit les changements de l'assistant apparaître en temps réel, et le travail de personne n'est écrasé.

Actions destructrices

Supprimer du contenu, des leçons, des Bricks ou des thèmes, revenir au thème par défaut, restaurer des instantanés et vider la corbeille exigent tous un confirm: true explicite. Sans cela, l'outil répond par un aperçu de ce qui se passerait afin que l'assistant puisse d'abord vous demander confirmation.

Notes d'exploitation

  • Le serveur d'autorisation OAuth fait partie de l'application (plugin mcp de Better Auth) ; les jetons vivent dans les tables oauth_* et expirent au bout d'1 heure (jetons de rafraîchissement : 7 jours).
  • Le point de terminaison est limité en débit par utilisateur (120 requêtes/minute).
  • Lorsque la facturation est activée, l'accès MCP est conditionné par la fonctionnalité apiAccess du plan, exactement comme les clés API.
Serveur MCP