🔌 MCP Sparted : guide utilisateur

À quoi sert le MCP Sparted

Le MCP Sparted permet de piloter votre back-office Sparted en écrivant simplement à un assistant IA (Claude, par exemple). Vous décrivez ce que vous voulez, l'assistant crée ou modifie les contenus, campagnes, breaking news et sondages directement sur votre instance.

Concrètement, une demande comme « Crée-moi 5 quiz sur la cybersécurité pour des commerciaux et prépare une campagne qui démarre lundi » suffit. L'assistant pose ses questions, rédige, vous montre ce qu'il va faire, puis l'applique après votre accord.

Important : travaillez d'abord tout dans le chat (textes, questions, images, sessions), et ne validez la création dans le back-office qu'une fois le résultat final. Détails dans la section La méthode, plus bas.

Le MCP travaille avec vos droits : il ne voit et ne modifie que ce que votre compte Sparted peut déjà voir et modifier dans le back-office.

Implémentation : connecter votre assistant

Le principe est le même partout : vous ajoutez l'adresse MCP de votre instance comme connecteur personnalisé, puis vous vous identifiez avec votre compte Sparted. Votre adresse MCP est celle de votre instance suivie de /mcp, par exemple https://acme.sparted.com/mcp.

Prérequis

Claude (claude.ai, application desktop et mobile)

Disponible sur tous les forfaits. Sur un forfait Team ou Enterprise, un administrateur de votre organisation doit d'abord ajouter le connecteur pour l'équipe.

1. Ouvrez claude.ai (ou l'application desktop), puis Paramètres, Connecteurs.
2. Cliquez sur Ajouter un connecteur personnalisé.
3. Nom : Sparted. URL : https://votre-instance.sparted.com/mcp. Cliquez sur Ajouter.
4. Cliquez sur Se connecter : la page Sparted s'ouvre, identifiez-vous et autorisez l'accès.
5. Dans une conversation, vérifiez que Sparted est activé dans le menu des outils (icône sous la zone de saisie).

ChatGPT

Nécessite un forfait payant (Plus, Pro, Business, Enterprise ou Edu). Sur un espace Business ou Enterprise, un administrateur doit autoriser les connecteurs personnalisés.

1. Cliquez sur votre profil, puis Paramètres, Apps et connecteurs.
2. En bas de la page, ouvrez Paramètres avancés et activez le Mode développeur.
3. Revenez dans Apps et connecteurs et cliquez sur Créer.
4. Nom : Sparted. URL : https://votre-instance.sparted.com/mcp. Authentification : OAuth.
5. Validez, puis identifiez-vous sur la page Sparted qui s'ouvre.
6. Dans une conversation, sélectionnez le connecteur Sparted dans le menu + de la zone de saisie.

Le Chat (Mistral)

Réservé aux administrateurs de l'espace. Sur les forfaits Free, Pro et Student, vous êtes administrateur par défaut.

1. Ouvrez le panneau latéral, dépliez Intelligence et cliquez sur Connecteurs.
2. Cliquez sur + Ajouter un connecteur, puis sur l'onglet Connecteur MCP personnalisé.
3. Nom : sparted (sans espace). URL : https://votre-instance.sparted.com/mcp.
4. Cliquez sur Connecter : Le Chat détecte la connexion OAuth, identifiez-vous sur la page Sparted.
5. Dans une conversation, activez le connecteur Sparted dans la liste des outils.

Gemini

Seule la version Gemini Enterprise est adaptée : l'application Gemini grand public ne permet les connecteurs personnalisés qu'aux comptes personnels situés aux États-Unis, en anglais. C'est un administrateur Google Workspace qui ajoute le serveur MCP pour l'organisation.

1. L'administrateur ajoute un serveur MCP personnalisé dans la console Gemini Enterprise, avec l'URL https://votre-instance.sparted.com/mcp.
2. Chaque utilisateur l'active ensuite dans ses applications connectées et s'identifie avec son compte Sparted.

Microsoft Copilot

Pas encore disponible. Cette section sera complétée dès que Copilot sera pris en charge.

Les menus évoluent souvent chez chaque éditeur : si un intitulé a changé, cherchez « Connecteurs » ou « MCP » dans les paramètres. Sources : Mistral, Gemini, Gemini Enterprise, ChatGPT.

La méthode : tout finaliser dans le chat, créer dans le back-office en dernier

La règle d'or : on ne valide la création qu'une fois le résultat parfait dans le chat. Tant que vous n'avez pas dit « oui », rien n'existe dans votre back-office : c'est le moment de tout ajuster, gratuitement et sans risque.

1. Demandez. Décrivez le besoin : public, objectif, langues, date de lancement.
2. Lisez le brouillon. L'assistant rédige tout dans la conversation : questions, réponses, explications, titres, sessions de campagne.
3. Retouchez dans le chat. « Simplifie la question 3 », « Remplace l'image du contenu 2 », « Passe la campagne à 4 sessions ». Répétez autant de fois que nécessaire.
4. Validez seulement quand tout vous va. L'assistant affiche un aperçu final et attend votre « oui, vas-y ».
5. La création part dans le back-office. Les objets apparaissent sur votre instance, prêts à l'emploi.

Pourquoi insister : une fois créé, un contenu est déjà validé et utilisable dans une campagne. Le corriger ensuite demande une nouvelle modification, et un contenu utilisé dans une campagne ne peut plus être archivé. Corriger dans le chat coûte une phrase ; corriger dans le back-office coûte une manipulation.

Ce verrou est tenu par le serveur Sparted lui-même : sans votre accord explicite, aucune création, modification, archivage ou suppression n'est exécuté. Chaque action demande son propre accord : valider les contenus ne valide pas la campagne. Les consultations (lister, rechercher, ouvrir) se font librement.

Ce que vous pouvez faire

L'assistant peut consulter, créer et modifier les cinq objets principaux du back-office, et aller chercher des images libres de droits pour les illustrer.

L'assistant dispose aussi de guides de rédaction Sparted intégrés (contenus, campagnes, breaking news, sondages, images). Il les suit automatiquement : formats des jeux, longueurs de texte, bonnes pratiques pédagogiques.

Exemples de demandes

Parlez à l'assistant comme à un collègue : plus vous donnez de contexte (public, objectif, date de lancement), moins il a de questions à vous poser.

Avant de rédiger des contenus, l'assistant vous demandera toujours trois choses s'il ne les a pas : le public visé, l'objectif pédagogique et la date de lancement de la campagne.

Règles et limites à connaître

Le MCP prépare tout, mais la mise en ligne auprès des apprenants reste entre vos mains dans le back-office : l'audience et la publication finale se font là-bas.

Types de jeux disponibles : QCM, question ouverte, texte à erreur, cartes à ordonner, cartes à swiper. Un contenu enseigne une seule idée avec un seul jeu.

Longueurs maximales (par langue) :

Ce que le MCP ne fait pas :

• Choisir ou rattacher une audience (à faire dans le back-office).
• Désarchiver un contenu (à faire dans le back-office).
• Archiver un contenu encore utilisé par une campagne en cours ou en brouillon.
• Supprimer une thématique qui a encore des sous-thématiques.
• Consulter les statistiques détaillées ou les réponses aux sondages.
• Gérer les utilisateurs ou les réglages de l'instance.

Questions fréquentes

L'assistant peut-il publier une campagne à ma place ? 

Non. Il crée la campagne en brouillon. Vous ajoutez l'audience et publiez depuis le back-office.

J'ai créé un contenu par erreur, comment l'annuler ? 

Demandez à l'assistant de l'archiver. Pour le récupérer ensuite, désarchivez-le dans le back-office.

La création d'un lot a échoué, qu'est-ce qui a été créé ? 

Rien. Une création groupée est tout ou rien. L'assistant affiche l'erreur renvoyée par Sparted, corrige et vous repropose l'aperçu.

L'assistant me demande une confirmation alors que j'ai déjà dit oui. 

Chaque action qui modifie l'instance demande son propre accord. Un « oui » pour créer les contenus ne vaut pas pour créer la campagne.

Je ne vois pas mes contenus ou mes campagnes. 

Vérifiez que le connecteur pointe sur la bonne instance et que votre compte Sparted y a accès au back-office.

La connexion est refusée ou a expiré. 

Retirez puis rajoutez le connecteur, ou cliquez sur Se reconnecter dans les paramètres de votre assistant.

D'où viennent les images ? 

De la banque Unsplash, libre de droits. Vous pouvez aussi fournir vos propres liens d'images.