Fonctionnalités
Une fois le serveur connecté, votre agent IA peut interagir avec Kameleoon pour :- Découvrir et inspecter les expériences, feature flags, objectifs, segments et règles de ciblage.
- Construire des expériences de bout en bout : créer, dupliquer et exécuter le cycle de vie complet (démarrer, mettre en pause, reprendre, arrêter, supprimer).
- Gérer les feature flags : créer, dupliquer, supprimer, activer/désactiver par environnement et consulter l’historique des modifications.
- Configurer la livraison des flags : ajouter des règles ciblées et d’expérimentation, des variations personnalisées et des variables typées.
- Créer et maintenir des objectifs et des segments d’audience, et associer des segments aux expériences.
- Analyser les résultats des expériences et des feature-flag-experiments, et extraire le code brut des variations (JavaScript et CSS).
- Automatiser le cycle de vie complet de l’implémentation, depuis une variation gagnante jusqu’à un rollout en production sécurisé par feature flag.
Le workflow principal : de l’expérience gagnante à la production
Le serveur MCP Kameleoon automatise le « dernier kilomètre » de l’implémentation. Sans quitter l’IDE, vous pouvez demander à votre assistant IA d’exécuter le workflow suivant :- Récupérer les résultats de l’expérience et identifier la variation gagnante.
- Extraire le code brut de la variation depuis Kameleoon.
- Convertir le code en code natif prêt pour la production (comme des composants React) aligné sur la base de code existante.
- Créer un feature flag dans Kameleoon.
- Encapsuler la nouvelle implémentation derrière le feature flag.
- Activer et valider la fonctionnalité en production.
Utilisation des tokens et choix du forfait
Connecter le serveur MCP Kameleoon à un assistant IA ajoute une surcharge faible et constante : les schémas d’outils qui décrivent les actions disponibles. Cette surcharge reste stable quel que soit le forfait sur lequel fonctionne l’assistant. Le coût en tokens d’un workflow provient du travail lui-même, pas de la connexion. Les facteurs suivants déterminent la consommation :- La quantité de données qu’un workflow récupère, comme des configurations d’expérience complètes, du code de variation ou des historiques de modifications.
- La quantité de code que l’assistant génère ou convertit, par exemple lors de la transposition d’une variation gagnante en code natif d’application.
- Le nombre de sites ou de marques qu’un même workflow couvre. Dupliquer et auditer des expériences sur trois sites consomme proportionnellement plus de tokens qu’exécuter la même opération sur un seul site.
- L’ampleur avec laquelle vous délimitez un même prompt. Une vérification circonscrite à un seul site consomme bien moins qu’une demande ouverte visant à passer en revue toutes les expériences de tous les sites.
Outils disponibles
Le serveur expose les outils ci-dessous, regroupés par domaine. Chaque outil correspond à une action unique et bien délimitée, vous permettant de les composer en workflows plus larges (par exemple : lire les résultats, extraire le code, créer un flag, ajouter une règle, l’activer).Expériences
Créez, inspectez et exécutez des tests A/B (expériences Web).Feature flags
Créez et opérez des feature flags, activez-les ou désactivez-les par environnement, et consultez leur historique et leurs résultats.Livraison des flags, variations et variables
Façonnez la manière dont un flag est livré, et définissez les variations et variables typées qu’il sert.Objectifs
Créez et maintenez les objectifs de conversion utilisés par les expériences et les flags.Segments
Définissez et inspectez les audiences que vous ciblez.Sites et règles de ciblage
Découvrez vos projets et associez des segments à des expériences.Intégration Claude Code
Étape 1 : Enregistrer le serveur
Pour enregistrer le serveur pour votre profil utilisateur (le rendant disponible dans tous les projets), ouvrez un terminal et exécutez la commande suivante :.mcp.json à votre dépôt pour le partage en équipe), exécutez :
kameleoon: ... - ✗ Failed to connect (Un échec de connexion ici est normal car vous n’avez pas encore terminé l’authentification).
Étape 2 : Terminer l’authentification OAuth
Dans le même terminal, déclenchez le flux de connexion :- La commande ouvre automatiquement un onglet de navigateur. Si ce n’est pas le cas, copiez l’URL affichée dans le terminal et ouvrez-la manuellement.
- Connectez-vous à votre compte Kameleoon.
- Cliquez sur Authorize.
- Lorsque le navigateur affiche un message de succès, appuyez sur
Ctrl+Cdans votre terminal.
kameleoon: ... - ✓ Connected
Étape 3 : Démarrer une nouvelle session Claude Code
Claude Code rend les outils des serveurs MCP nouvellement ajoutés disponibles uniquement dans les sessions que vous démarrez après l’enregistrement du serveur. Fermez votre session de chat Claude Code en cours et ouvrez-en une nouvelle.Étape 4 : Vérifier la connexion
Dans une nouvelle conversation Claude Code, essayez les prompts suivants :- « List my Kameleoon feature flags. »
- « What experiments are active on site X? »
- « Show me the status of experiment Y. »
- « Show me the code for variation 1 of experiment Z. »
Dépannage Claude
Intégration Antigravity
Configuration rapide
Collez le prompt d’auto-démarrage suivant directement dans votre chat Antigravity pour vous connecter automatiquement :Configuration manuelle
Modifiez le fichier de configuration à~/.gemini/antigravity/mcp_config.json et ajoutez le bloc JSON suivant :
Intégration Codex
Configuration rapide
Collez le prompt d’auto-démarrage suivant dans votre chat Codex :Configuration manuelle
Ajoutez le bloc suivant à~/.codex/config.toml. Créez le fichier s’il n’existe pas :
Authentifier la connexion
Le serveur MCP Kameleoon utilise OAuth. Exécutez la commande suivante dans votre terminal pour démarrer le flux d’autorisation :- Le navigateur ouvre automatiquement une fenêtre.
- Cliquez sur Authorize sur la page de connexion Kameleoon.
- Kameleoon complète le callback local sur le port 35535.
- Le terminal confirme que le proxy s’est connecté avec succès.
Vérifier les opérations des outils
Après vous être authentifié, exécutez les vérifications suivantes pour confirmer que les outils fonctionnent comme prévu :- Lister les outils disponibles : Confirmez que
tools/listréussit et renvoie les outils Kameleoon. Assurez-vous que la sortie inclut les outils listés dans le tableau des outils, commeexperiment_code_get,feature_flag_listetfeature_flag_create. - Récupérer les feature flags : Exécutez
feature_flag_list(siteCode = "d1alzzxd7k"). Une réponse réussie renvoie une liste de feature flags pour le site spécifié. - Récupérer les résultats d’expérience : Exécutez
experiment_results_get(experimentId = 149640). Une réponse réussie inclut le nom de l’expérience, le code du site, le type et le statut.
Intégration Cursor
Cursor intègre les outils MCP directement dans la barre latérale Chat de l’IDE, ce qui les rend disponibles pendant que vous codez.Option 1 : Configurer via l’UI Cursor (recommandé)
- Ouvrez les paramètres Cursor (
Cmd+Shift+Jsur macOS,Ctrl+Shift+Jsur Windows/Linux). - Naviguez vers Features > MCP Servers > + Add New MCP Server.
- Définissez le Name sur
kameleoon. - Définissez le Type sur
command. - Saisissez la chaîne suivante comme Command :
- Enregistrez la configuration.
Option 2 : Configurer via mcp.json (avancé)
Ouvrez~/.cursor/mcp.json (créez le fichier s’il n’existe pas) et ajoutez l’entrée suivante à l’objet mcpServers :
Redémarrez Cursor après avoir modifié le fichier manuellement.
Exemples de prompts pour les workflows développeur
Une fois le serveur MCP Kameleoon connecté, utilisez des prompts comme les suivants dans votre IDE :- « List the Kameleoon MCP tools available in this session. »
- « Show me all feature flags for site code
d1alzzxd7k. » - « Get the details for feature flag new_search on site
d1alzzxd7k. » - « Fetch experiment results for experiment
149640and summarize the current status. » - « Pull the variation code for experiment
<experimentId>and variation<variationId>. »
- « Inspect feature flag new_search for site
d1alzzxd7kand explain what environments and variations it currently has. » - « Summarize experiment
149640for an engineer. Include status, site code, winner state, and whether any variation data is available. » - « List the active feature flags for site
d1alzzxd7kand point out any flags that look like stale candidates. » - « Retrieve the code for variation
<variationId>in experiment<experimentId>and explain what frontend behavior it changes. » - « Create a new feature flag named
<name>with key<featureKey>for sited1alzzxd7k. » - « Turn on feature flag
<featureKey>in the staging environment for sited1alzzxd7k. » - « Turn off feature flag
<featureKey>in the production environment for sited1alzzxd7k. »
Workflow avancé : Automatisation de bout en bout
Pour découvrir toutes les capacités du serveur MCP, utilisez un prompt système complet. L’exemple suivant montre comment transposer le code de la variation gagnante en composants React, ce qui est principalement destiné aux applications React. Il demande à l’agent IA de gérer l’ensemble du cycle de vie d’implémentation, depuis la récupération des résultats gagnants jusqu’à la génération de code natif prêt pour la production, encadré par un nouveau feature flag, puis de le déployer et de le valider, le tout via les outils MCP. Collez le prompt suivant dans votre assistant IA :Référence des paramètres des outils
Utilisez les noms exacts des outils et des paramètres retournés partools/list. Le schéma MCP en direct prend en charge les paramètres suivants.
Expériences
experiment_create accepte MVT et SDK_HYBRID comme valeurs valides pour type, mais aucune des deux ne peut réellement être créée via cet outil. MVT échoue toujours car l’API exige mvtVariations (sections et variations) à la création, et aucun outil MCP n’expose ce champ. SDK_HYBRID échoue toujours avec une erreur « Incorrect Experiments type », quel que soit le contenu envoyé. AI, CLASSIC, DEVELOPER et PROMPT se créent tous correctement. Pour créer un test multivariate, appelez directement l’Automation API en suivant les étapes de Créer un test multivariate.Feature flags
Livraison des flags, variations et variables
Objectifs
Segments
Sites et règles de ciblage
Valeurs d’énumération acceptées :
experiment_lifecycle_update.status est started, resumed, paused, stopped ou deleted. Le type d’expérience est AI, CLASSIC, DEVELOPER, MVT, PROMPT ou SDK_HYBRID. Le type d’objectif est CLICK, CUSTOM, SCROLL, PAGE_VIEWS, URL, TIME_SPENT, RETENTION_RATE, WAREHOUSE ou RATIO_METRICS. variableType est BOOLEAN, NUMBER, STRING, JSON, JS, CSS ou ENUM. trafficAllocations est une chaîne variationKey:percentage séparée par des virgules dont la somme est 100 (par exemple off:50,on:50). releaseDateTime est une date-heure locale ISO-8601 sans décalage (par exemple 2026-07-01T09:00:00) et timeZone est une zone IANA (par exemple Europe/Paris ou UTC).
Conseils de prompting
- Incluez le code du site lorsque vous travaillez avec des feature flags.
- Incluez l’ID d’expérience lorsque vous interrogez des expériences ou leurs résultats.
- Incluez à la fois
experimentIdetvariationIdlorsque vous demandez le code d’une variation. - Nommez explicitement l’environnement cible lorsque vous demandez à l’agent d’activer ou de désactiver un feature flag.
- Demandez un résumé en langage clair si vous voulez que votre agent IA interprète la réponse MCP plutôt que de simplement récupérer les données brutes.
Dépannage général
Le port 35535 est déjà utilisé
Si l’authentification échoue avec une erreurEADDRINUSE, un autre processus écoute déjà sur le port de callback OAuth.
- Cause : Un processus
mcp-remoteobsolète reste actif depuis une tentative d’authentification précédente. - Solution : Arrêtez le processus obsolète qui utilise le port 35535, puis relancez la commande OAuth.
Le serveur MCP n’apparaît pas dans le chat Codex
Codex peut ne pas recharger à chaud les serveurs MCP nouvellement ajoutés dans un thread déjà en cours d’exécution.- Solution : Rafraîchissez Codex ou démarrez une nouvelle session après avoir mis à jour
config.toml.
Le flux du navigateur ne se termine pas
Si la fenêtre du navigateur OAuth s’ouvre mais que l’autorisation ne se termine pas :- Confirmez que vous avez cliqué sur le bouton Authorize sur la page de connexion Kameleoon.
- Vérifiez que les paramètres de votre navigateur ou de votre système ne bloquent pas les callbacks
localhost. - Ouvrez manuellement l’URL de callback si votre navigateur ne parvient pas à la lancer automatiquement.
Les agents headless ou distants ne parviennent pas à s’authentifier
Les agents distants ou headless (comme Codex hébergé dans le cloud) ne peuvent pas effectuer l’étape d’autorisation basée sur le navigateur.- Solution : Utilisez à la place une version desktop de votre outil.
Commande npx introuvable
Si la commande échoue avec une erreur « not found », assurez-vous quenpx est disponible sur le chemin de votre système. Les versions de Node.js 8.2 et ultérieures incluent npx par défaut.