> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer les clients MCP

> Enregistrez le serveur MCP Kameleoon dans Claude Code, Antigravity, Codex ou Cursor.

Chaque client enregistre le serveur MCP Kameleoon dans sa propre configuration, puis effectue une connexion OAuth une seule fois. Suivez les étapes de votre client, puis lancez un prompt d'exemple pour vérifier que les outils fonctionnent.

## Intégration à Claude Code

### Étape 1 : enregistrer le serveur

Pour enregistrer le serveur pour votre profil utilisateur (il est alors disponible dans tous les projets), ouvrez un terminal et exécutez la commande suivante :

```bash theme={null}
claude mcp add --scope user kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

Pour enregistrer le serveur uniquement pour le projet en cours (ce qui ajoute un fichier `.mcp.json` à votre dépôt pour le partager avec l'équipe), exécutez :

```bash theme={null}
claude mcp add --scope project kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

Vérifiez que Claude a bien ajouté le serveur :

```bash theme={null}
claude mcp list
```

**Sortie attendue :** `kameleoon: ... - ✗ Failed to connect` (un échec de connexion à cette étape est normal, car vous n'avez pas encore terminé l'authentification).

### Étape 2 : terminer l'authentification OAuth

Dans le même terminal, lancez le flux de connexion :

```bash theme={null}
npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

1. La commande ouvre automatiquement un onglet du navigateur. Si ce n'est pas le cas, copiez l'URL affichée dans le terminal et ouvrez-la manuellement.
2. Connectez-vous à votre compte Kameleoon.
3. Cliquez sur **Authorize**.
4. Lorsque le navigateur affiche un message de réussite, appuyez sur `Ctrl+C` dans votre terminal.

Vérifiez la connexion :

```bash theme={null}
claude mcp list
```

**Sortie attendue :** `kameleoon: ... - ✓ Connected`

### Étape 3 : démarrer une nouvelle session Claude Code

Claude Code ne rend disponibles les outils des serveurs MCP nouvellement ajoutés que dans les sessions que vous démarrez après leur enregistrement. Fermez votre conversation Claude Code en cours, puis ouvrez-en une nouvelle.

### Étape 4 : vérifier la connexion

Dans une nouvelle conversation Claude Code, essayez les prompts suivants :

* "List the Kameleoon feature flags."
* "What experiments are running on site X?"
* "Show the status of experiment Y."
* "Show the code for variation 1 of experiment Z."

## Intégration à Antigravity

### Configuration rapide

Collez le prompt de démarrage suivant directement dans votre chat Antigravity pour vous connecter automatiquement :

```text theme={null}
Connect to the Kameleoon MCP production server. The endpoint is https://mcp.kameleoon.com/mcp, using mcp-remote@0.1.37 on port 35535 with the openid scope. Authenticate by running the npx mcp-remote command to trigger my browser, then verify the connection.
```

### Configuration manuelle

Modifiez le fichier de configuration `~/.gemini/config/mcp_config.json` et ajoutez le bloc JSON suivant. Si le fichier contient déjà un objet `mcpServers`, ajoutez-y uniquement l'entrée `kameleoon` :

```json theme={null}
{
  "mcpServers": {
    "kameleoon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.37",
        "https://mcp.kameleoon.com/mcp",
        "35535",
        "--static-oauth-client-metadata",
        "{ \"scope\": \"openid\" }"
      ]
    }
  }
}
```

## Intégration à Codex

### Configuration rapide

Collez le prompt de démarrage suivant dans votre chat Codex :

```text theme={null}
Configure the Kameleoon MCP server at https://mcp.kameleoon.com/mcp. Use port 35535 for callback. Once configured, run the login command to trigger my browser and then list my feature flags.
```

### Configuration manuelle

Ajoutez le bloc suivant à `~/.codex/config.toml`. Créez le fichier s'il n'existe pas :

```toml theme={null}
[mcp_servers.kameleoon]
command = "npx"
args = ["-y", "mcp-remote@0.1.37", "https://mcp.kameleoon.com/mcp",
        "35535", "--static-oauth-client-metadata",
        "{ \"scope\": \"openid\" }"]
```

## Authentifier la connexion

Le serveur MCP Kameleoon utilise OAuth. Exécutez la commande suivante dans votre terminal pour lancer le flux d'autorisation :

```bash theme={null}
npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 \
  --static-oauth-client-metadata '{ "scope": "openid" }'
```

**Comportement attendu :**

1. Le navigateur ouvre automatiquement une fenêtre.
2. Cliquez sur **Authorize** sur la page de connexion Kameleoon.
3. Kameleoon termine le callback local sur le port 35535.
4. Le terminal confirme que le proxy s'est connecté avec succès.

Une connexion réussie affiche un texte semblable au suivant :

```text theme={null}
Connected to remote server using StreamableHTTPClientTransport
Local STDIO server running
Proxy established successfully between local STDIO and remote StreamableHTTPClientTransport
```

## Vérifier les opérations des outils

Une fois authentifié, exécutez les vérifications suivantes pour confirmer que les outils fonctionnent comme prévu :

1. **Lister les outils disponibles :** Vérifiez que `tools/list` réussit et renvoie les outils Kameleoon. Assurez-vous que la sortie inclut les outils listés dans la [référence des outils](https://docs.kameleoon.com/fr/mcp/mcp-server.md#référence-des-outils), comme `experiment_code_get`, `feature_flag_list` et `feature_flag_create`.
2. **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 indiqué.
3. **Récupérer les résultats d'une expérience :** Exécutez `experiment_results_get(experimentId = 149640)`. Une réponse réussie inclut les résultats de chaque objectif rattaché à l'expérience.

## Intégration à Cursor

Cursor intègre les outils MCP directement dans la barre latérale du chat de l'IDE, ce qui les rend disponibles pendant que vous codez.

### Option 1 : configurer via l'interface de Cursor (recommandé)

1. Ouvrez Cursor Settings (`Cmd+Shift+J` sur macOS, `Ctrl+Shift+J` sous Windows ou Linux).
2. Accédez à **Features > MCP Servers > + Add New MCP Server**.
3. Définissez **Name** sur `kameleoon`.
4. Définissez **Type** sur `command`.
5. Saisissez la chaîne suivante comme **Command** :
   ```bash theme={null}
   npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
   ```
6. Enregistrez la configuration.

### Option 2 : configurer dans un fichier JSON (avancé)

Ouvrez `~/.cursor/mcp.json` (créez le fichier s'il n'existe pas) et ajoutez l'entrée suivante à l'objet `mcpServers` :

```json theme={null}
{
  "mcpServers": {
    "kameleoon": {
      "command": "bash",
      "args": [
        "-lc",
        "npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ \"scope\": \"openid\" }'"
      ]
    }
  }
}
```

> [!NOTE]
>
> Redémarrez Cursor après avoir modifié le fichier manuellement.

## Exemples de prompts pour les flux de travail de développement

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 all feature flags for site code `d1alzzxd7k`."
* "Get the details for feature flag new\_search on site `d1alzzxd7k`."
* "Fetch experiment results for experiment `149640` and summarize the current status."
* "Pull the variation code for experiment `<experimentId>` and variation `<variationId>`."

Pour des flux de travail plus avancés, essayez les prompts suivants :

* "Inspect feature flag new\_search for site `d1alzzxd7k` and explain what environments and variations it has."
* "Summarize experiment `149640` for an engineer. Include status, site code, winner state, and whether any variation data is available."
* "List the active feature flags for site `d1alzzxd7k` and 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 site `d1alzzxd7k`."
* "Turn on feature flag `<featureKey>` in the staging environment for site `d1alzzxd7k`."
* "Turn off feature flag `<featureKey>` in the production environment for site `d1alzzxd7k`."
* "How has the checkout experiment performed week by week on phones?"
* "Did new visitors react differently from returning ones in the pricing test? Use Bayesian statistics."
* "Show the daily trend of the checkout test without Safari, counting every purchase, not only buyers."
* "Create a segment of returning visitors from Germany on desktop who already completed the Purchase goal."

## Conseils pour rédiger vos prompts

* Incluez le code de site lorsque vous travaillez avec des feature flags.
* Incluez l'ID de l'expérience lorsque vous interrogez des expériences ou leurs résultats.
* Incluez à la fois `experimentId` et `variationId` lorsque vous demandez le code d'une variation.
* Indiquez 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 au lieu de simplement récupérer les données brutes.