Serveur MCP FluoTest
FluoTest dispose d'un serveur MCP (Model Context Protocol) distant, pour que des assistants IA comme Claude et ChatGPT puissent gérer les quiz de votre compte : les lister, les créer et les modifier (y compris le score, les résultats et les paramètres), les publier, lire les résultats et les supprimer sur demande, toujours par leur nom, sans jamais chercher un UUID. Les connexions sont autorisées via OAuth (vous approuvez l'accès sur un écran de consentement) ou avec une clé API personnelle générée dans les Paramètres.
Dernière mise à jour
Comment connecter un assistant IA à FluoTest ?
Dans ChatGPT, ajoutez le plugin FluoTest depuis l'annuaire des plugins ChatGPT et connectez-vous. Dans Claude, le plus rapide est l'annuaire des connecteurs de Claude (claude.ai/directory/fluotest) : cliquez sur Add et connectez-vous. Dans tout autre client MCP, ajoutez manuellement https://fluotest.com/api/mcp comme serveur MCP distant : avec OAuth, vous vous connectez à FluoTest et approuvez l'accès sur un écran de consentement, ou bien vous générez une clé API dans Paramètres → Sécurité → Clés API et l'envoyez comme jeton Bearer.
URL du serveur#
Le serveur MCP se trouve à une seule URL :
https://fluotest.com/api/mcp
Il utilise le transport Streamable HTTP. Chaque requête doit être authentifiée : les requêtes non authentifiées reçoivent une réponse 401 qui indique aux clients MCP où démarrer le flux OAuth.
Authentification#
Il existe deux façons de s'authentifier. Les deux agissent en tant que votre compte utilisateur : l'assistant ne peut voir et créer que ce que vous pouvez voir et créer.
- OAuth 2.1 (recommandé): Pris en charge par les connecteurs personnalisés de Claude et les autres clients MCP compatibles OAuth. Vous vous connectez à FluoTest dans le navigateur et approuvez l'accès sur un écran de consentement, sans clé à copier, et vous gardez le contrôle de ce qui est connecté.
- Clé API: Pour les clients MCP qui acceptent des en-têtes personnalisés (comme Claude Code) ou vos propres scripts. Générez une clé dans Paramètres → Sécurité → Clés API et envoyez-la sous la forme « Authorization: Bearer fluo_… ». Traitez-la comme un mot de passe.
Référence complète de l'API : clés, en-têtes et exemples curl →
Connecter ChatGPT#
Le plus simple : le plugin FluoTest pour ChatGPT
FluoTest figure dans l'annuaire des plugins ChatGPT. Ouvrez la fiche, ajoutez-le et connectez-vous à FluoTest pour approuver l'accès : FluoTest dans l'annuaire des plugins ChatGPT
Une fois ajouté, ChatGPT utilise les mêmes outils que ceux listés sous Outils disponibles : il peut lister, créer, modifier et publier vos quiz, lire leurs résultats et supprimer un quiz quand vous le demandez. La publication est toujours une étape distincte, et modifier un quiz en ligne ou en supprimer un nécessite d'abord votre confirmation. Pour les autres clients MCP, suivez les étapes Claude ou clé API ci-dessous.
Connecter Claude (OAuth)#
Le plus simple : l'annuaire des connecteurs de Claude
FluoTest figure dans le Connectors Directory de Claude en tant que connecteur Community : il n'y a donc ni URL ni champ à remplir. Ouvrez la fiche et cliquez sur Add : claude.ai/directory/fluotest
Vous préférez l'ajouter manuellement, ou vous ne voyez pas encore la fiche ? Dans Claude, allez dans Settings → Connectors → Add custom connector et renseignez :
- Nom : FluoTest
- URL du serveur MCP distant : https://fluotest.com/api/mcp
- Cliquez sur Add, puis sur Connect. Vous serez redirigé vers fluotest.com pour vous connecter et approuver l'accès.
Aucun client ID ni secret à copier : le connecteur s'enregistre automatiquement comme client OAuth public (PKCE, sans secret) lors de votre première connexion.
Se connecter avec une clé API#
Pour les clients où le flux OAuth n'est pas disponible :
- Dans FluoTest, ouvrez Paramètres → Sécurité → Clés API.
- Saisissez un nom (par ex. « Claude Code ») et cliquez sur Générer une clé.
- Copiez immédiatement la clé fluo_…, car elle n'est affichée qu'une seule fois.
- Ajoutez-la à votre client MCP comme en-tête Authorization.
Configuration MCP générique (pour les clients de type mcp.json) :
{
"mcpServers": {
"fluotest": {
"type": "http",
"url": "https://fluotest.com/api/mcp",
"headers": {
"Authorization": "Bearer fluo_YOUR_API_KEY"
}
}
}
}Claude Code (CLI)
claude mcp add --transport http fluotest https://fluotest.com/api/mcp \ --header "Authorization: Bearer fluo_YOUR_API_KEY"
Référence complète de l'API : clés, en-têtes et exemples curl →
Outils disponibles#
Le serveur expose onze outils qui couvrent tout le cycle de vie d'un quiz, de la création d'une évaluation avec score à la lecture de ses résultats. Chaque outil accepte un quiz par titre, slug ou ID, pour qu'un assistant n'ait jamais besoin que vous colliez un UUID. Les quiz partagés avec vous dans un espace de travail d'équipe fonctionnent aussi, avec les mêmes droits de lecture ou de modification que dans le tableau de bord.
Certains paramètres dépendent de l'offre du propriétaire de l'espace de travail, comme dans le tableau de bord : l'e-mail de relance pour les quiz non terminés (abandoned_email_*, désactivé par défaut) nécessite Business, et les aperçus de lien personnalisés (og_title, og_description) nécessitent Pro. Tout le reste, y compris les catégories de score, les résultats, le formulaire de contact et l'e-mail de résultats, fonctionne avec toutes les offres.
- list_quizzes: Liste les quiz que vous pouvez voir : les vôtres et ceux des espaces de travail d'équipe dont vous êtes membre, avec titre, ID, slug, statut brouillon ou publié, nombre de réponses, date de création, espace de travail et possibilité ou non de le modifier. Un assistant l'appelle en premier pour trouver un quiz que vous mentionnez par son nom.
- create_quiz: Crée un quiz en brouillon en un seul appel, y compris une évaluation complète avec score : sections, tous les types de questions avec texte d'aide, catégories de score avec leurs propres paliers, sections qui alimentent une catégorie ou aucune, règles d'affichage conditionnel et de saut, résultats qui pointent vers des réponses par leur libellé, et paramètres du quiz comme le formulaire de contact avant le résultat, un écran de résultat de simple confirmation, l'e-mail de résultats, la langue, les textes et le thème. Renvoie les ID des nouvelles sections, questions et options ainsi que des avertissements, par exemple une plage de palier que personne ne peut atteindre. Le quiz reste non publié jusqu'à ce que vous le publiiez.
- get_quiz_questions: Renvoie la structure complète et le score d'un quiz avec les mêmes noms de champs que create_quiz : sections, questions avec texte d'aide, options avec leurs points par catégorie, règles d'affichage conditionnel et de saut, catégories et paliers de score, chaque résultat avec ses règles et ses actions, et les avertissements de la carte des scores. Les assistants l'utilisent pour vérifier leur travail et obtenir les ID nécessaires aux modifications.
- get_quiz_settings: Renvoie tous les paramètres d'un quiz : lien public, pages d'accueil et de remerciement, ce que voient les répondants après l'envoi, le formulaire de contact, l'e-mail de résultats et la provenance de son adresse, les notifications au propriétaire, la planification et les autres options, la langue et les textes personnalisés, le thème, et les intégrations activées pour le quiz avec leur déclencheur, leur correspondance de champs et leur dernière livraison. Les intégrations sont en lecture seule et n'incluent jamais d'URL ni de clés.
- update_quiz: Modifie un quiz : tous les champs acceptés par create_quiz, plus le slug. Les questions peuvent être remplacées ou modifiées sur place avec des opérations qui ajoutent, modifient, déplacent ou suppriment questions et sections tout en conservant leurs ID, pour que les règles de résultat et les réponses passées restent liées. Un remplacement complet qui ferait perdre des règles, du texte d'aide ou des scores par catégorie demande d'abord une confirmation, et si une partie d'une modification échoue, le quiz reste tel qu'il était. Modifier un quiz publié nécessite confirm_edit_published: true ; la première tentative ne change rien et affiche le nombre de réponses et la liste avant/après de ce qui changerait.
- publish_quiz: Publie un quiz en brouillon et le met en ligne à son URL publique, uniquement quand vous le demandez. Il respecte l'approbation de publication de votre espace de travail et renvoie des avertissements sur les configurations qui ne fonctionneront pas comme prévu, comme un e-mail de résultats sans adresse de destination.
- unpublish_quiz: Remet hors ligne un quiz publié. Ses réponses sont conservées et il peut être republié plus tard.
- import_quiz: Crée un brouillon à partir d'un document de quiz FluoTest : les mêmes champs que create_quiz plus schema_version 1, avec des identifiants ref vers lesquels pointent les règles d'affichage conditionnel, de saut et de résultat. Le document est d'abord vérifié et rien n'est enregistré s'il contient des erreurs, chacune indiquant la question concernée. Les champs inconnus reviennent sous forme d'avertissements, les paramètres réservés à Pro que vous ne pouvez pas utiliser sont ignorés avec un avertissement, et tout ce que le quiz source contenait et que le format ne peut pas transporter est listé dans not_in_file.
- duplicate_quiz: Copie l'un de vos quiz en nouveau brouillon, avec ses questions, son score, ses résultats, ses paramètres et ses intégrations, pour qu'un assistant puisse créer une variante sans toucher à l'original.
- get_results: Renvoie le nombre de réponses, le score moyen, le plus bas et le plus haut, le nombre par palier, les moyennes et paliers par catégorie de score, le nombre par résultat, ainsi que les vues et le taux de complétion. Avec Pro, il ajoute la répartition des réponses, le NPS, l'abandon par question et le temps moyen. Il peut aussi lister les réponses de la plus récente à la plus ancienne, filtrées par date, score, résultat ou contact, avec les scores, le résultat et les réponses de chaque personne. Les noms, e-mails et numéros de téléphone ne sont inclus que si vous demandez les coordonnées.
- delete_quiz: Supprime définitivement l'un de vos quiz et ses réponses. Le premier appel ne supprime jamais rien : il renvoie le titre et le nombre de réponses pour que vous puissiez confirmer, et un second appel avec confirm: true le supprime.
Exemple d'arguments create_quiz : une évaluation avec score
{
"title": "Team health check",
"score_categories": [
{ "label": "Leadership", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] },
{ "label": "Culture", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] }
],
"sections": [
{
"title": "About you",
"scored": false,
"questions": [
{ "text": "Your name", "type": "name" },
{ "text": "Team size", "type": "multiple_choice", "options": [{ "label": "1-10" }, { "label": "11+" }] }
]
},
{
"title": "Leadership",
"category": "leadership",
"questions": [
{
"text": "Leaders give regular feedback",
"description": "Think about the last three months.",
"type": "multiple_choice",
"options": [
{ "label": "Rarely", "score": 0 },
{ "label": "Sometimes", "score": 1 },
{ "label": "Always", "score": 2 }
]
}
]
},
{
"title": "Culture",
"category": "culture",
"questions": [{ "text": "People speak up in meetings", "type": "yes_no", "points": 2 }]
}
],
"contact_gate": { "contact_type": "email", "required": true, "name_required": true, "block_disposable_emails": true },
"results_display": "confirmation",
"send_results_email": true,
"results_email_attach_pdf": true,
"hidden_fields": ["website"],
"capture_utm": true
}Cartes dans la conversation#
Dans les assistants compatibles avec MCP Apps, comme Claude et ChatGPT, list_quizzes, get_results, create_quiz, import_quiz, update_quiz, publish_quiz, unpublish_quiz et duplicate_quiz affichent une carte sous la réponse : des cartes de quiz avec le statut, le nombre de réponses, le nombre de questions et des boutons pour ouvrir le quiz dans l'éditeur ou sa page publique, ou une carte de résultats avec les réponses, le score moyen, le taux de complétion, les niveaux de score ou les issues et les dernières réponses. Les autres clients MCP reçoivent les mêmes résultats texte qu'avant.
Chacun de ces outils porte _meta.ui.resourceUri (et l'alias ChatGPT openai/outputTemplate), qui pointe vers une ressource ui://fluotest/ servie en text/html;profile=mcp-app. La carte affiche le structuredContent de l'outil, les mêmes données que le résultat texte, avec votre langue FluoTest dans le champ locale. C'est du HTML autonome qui ne charge rien depuis le réseau, et les coordonnées des répondants n'apparaissent que si vous les avez demandées (include_contacts).
Cartes dans la conversation
Connecté avant l'arrivée des cartes ? Reconnectez FluoTest ou actualisez-le dans les réglages des connecteurs ou des applications de votre assistant, pour qu'il récupère les nouvelles métadonnées des outils.
Référence des endpoints OAuth#
Les clients MCP les découvrent automatiquement à partir de la réponse 401 du serveur et du document de découverte : vous n'en avez besoin que si un client demande explicitement les endpoints. Essayez d'abord l'URL de découverte OIDC ; elle permet de trouver le reste.
| Endpoint | URL |
|---|---|
| Découverte OIDC | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/openid-configuration |
| Autorisation | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/authorize |
| Jeton | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/token |
| JWKS | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/jwks.json |
FAQ#
Quels quiz un assistant connecté peut-il voir ?
Uniquement les vôtres. Chaque appel d'outil s'exécute en tant que votre compte utilisateur, avec les mêmes règles d'autorisation que l'application : un assistant ne peut donc pas lire les quiz ou les résultats d'autres utilisateurs.
Comment révoquer l'accès ?
Clés API : révoquez-les dans Paramètres → Sécurité → Clés API, et la clé cesse immédiatement de fonctionner. OAuth : supprimez le connecteur dans votre assistant IA ; ses jetons enregistrés sont supprimés et aucun nouveau n'est émis sans repasser par l'écran de consentement.
Peut-il publier des quiz ?
Uniquement sur demande explicite. create_quiz crée toujours un brouillon non publié, et publish_quiz, un outil distinct, est l'étape volontaire qui le met en ligne. Rien n'est publié automatiquement.
Peut-il modifier ou supprimer un quiz déjà en ligne ?
Les deux, mais jamais au premier appel. La première tentative de update_quiz sur un quiz publié est refusée et vous montre le nombre de réponses et la liste avant/après de ce qui changerait, sans rien modifier ; seul un second appel avec confirm_edit_published: true applique la modification, et le remplacement des questions d'un quiz en ligne s'accompagne aussi d'un avertissement indiquant que d'anciennes réponses peuvent faire référence à des questions qui n'existent plus. delete_quiz fonctionne de la même façon : il vous montre d'abord le titre du quiz et son nombre de réponses, et ne supprime qu'après votre confirmation.
Le serveur MCP est-il gratuit ?
Oui, il est disponible avec toutes les offres, y compris les comptes gratuits.