> ## 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.

# Configurar los clientes MCP

> Registre el servidor MCP de Kameleoon en Claude Code, Antigravity, Codex o Cursor.

Cada cliente registra el servidor MCP de Kameleoon en su propia configuración y, después, completa un inicio de sesión OAuth una sola vez. Siga los pasos de su cliente y, a continuación, ejecute un prompt de ejemplo para confirmar que las herramientas funcionan.

## Integración con Claude Code

### Paso 1: Registrar el servidor

Para registrar el servidor en su perfil de usuario (para que esté disponible en todos los proyectos), abra una terminal y ejecute el siguiente comando:

```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" }'
```

Para registrar el servidor solo en el proyecto actual (lo que añade un archivo `.mcp.json` a su repositorio para compartirlo con el equipo), ejecute:

```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" }'
```

Compruebe que Claude añadió el servidor:

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

**Resultado esperado:** `kameleoon: ... - ✗ Failed to connect` (una conexión fallida en este punto es normal, porque todavía no ha completado la autenticación).

### Paso 2: Completar la autenticación OAuth

En la misma terminal, inicie el flujo de inicio de sesión:

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

1. El comando abre automáticamente una pestaña del navegador. Si no lo hace, copie la URL que se muestra en la terminal y ábrala manualmente.
2. Inicie sesión en su cuenta de Kameleoon.
3. Haga clic en **Authorize**.
4. Cuando el navegador muestre un mensaje de éxito, pulse `Ctrl+C` en su terminal.

Compruebe la conexión:

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

**Resultado esperado:** `kameleoon: ... - ✓ Connected`

### Paso 3: Iniciar una sesión nueva de Claude Code

Claude Code solo pone a disposición las herramientas de los servidores MCP recién añadidos en las sesiones que inicie después de registrar el servidor. Cierre el chat actual de Claude Code y abra uno nuevo.

### Paso 4: Comprobar la conexión

En una conversación nueva de Claude Code, pruebe los siguientes prompts:

* "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."

## Integración con Antigravity

### Configuración rápida

Pegue el siguiente prompt de inicio directamente en su chat de Antigravity para conectarse automáticamente:

```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.
```

### Configuración manual

Edite el archivo de configuración `~/.gemini/config/mcp_config.json` y añada el siguiente bloque JSON. Si el archivo ya tiene un objeto `mcpServers`, añada solo la entrada `kameleoon` a ese objeto:

```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\" }"
      ]
    }
  }
}
```

## Integración con Codex

### Configuración rápida

Pegue el siguiente prompt de inicio en su chat de 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.
```

### Configuración manual

Añada el siguiente bloque a `~/.codex/config.toml`. Si el archivo no existe, créelo:

```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\" }"]
```

## Autenticar la conexión

El servidor MCP de Kameleoon usa OAuth. Ejecute el siguiente comando en su terminal para iniciar el flujo de autorización:

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

**Comportamiento esperado:**

1. El navegador abre una ventana automáticamente.
2. Haga clic en **Authorize** en la página de inicio de sesión de Kameleoon.
3. Kameleoon completa la devolución de llamada local en el puerto 35535.
4. La terminal confirma que el proxy se conectó correctamente.

Una conexión correcta muestra un texto similar al siguiente:

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

## Verificar las operaciones de las herramientas

Después de autenticarse, ejecute las siguientes comprobaciones para confirmar que las herramientas funcionan como se espera:

1. **Liste las herramientas disponibles:** Confirme que `tools/list` se ejecuta correctamente y devuelve las herramientas de Kameleoon. Asegúrese de que la salida incluye las herramientas de la [referencia de herramientas](https://docs.kameleoon.com/es/mcp/mcp-server.md#referencia-de-herramientas), como `experiment_code_get`, `feature_flag_list` y `feature_flag_create`.
2. **Obtenga los feature flags:** Ejecute `feature_flag_list(siteCode = "d1alzzxd7k")`. Una respuesta correcta devuelve una lista de feature flags del sitio indicado.
3. **Obtenga los resultados de un experimento:** Ejecute `experiment_results_get(experimentId = 149640)`. Una respuesta correcta incluye los resultados de cada objetivo asociado al experimento.

## Integración con Cursor

Cursor integra las herramientas MCP directamente en la barra lateral del chat del IDE, lo que las pone a su disposición mientras programa.

### Opción 1: Configurar desde la interfaz de Cursor (recomendado)

1. Abra la configuración de Cursor (`Cmd+Shift+J` en macOS, `Ctrl+Shift+J` en Windows o Linux).
2. Vaya a **Features > MCP Servers > + Add New MCP Server**.
3. Establezca **Name** en `kameleoon`.
4. Establezca **Type** en `command`.
5. Introduzca la siguiente cadena como **Command**:
   ```bash theme={null}
   npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
   ```
6. Guarde la configuración.

### Opción 2: Configurar en un archivo JSON (avanzado)

Abra `~/.cursor/mcp.json` (si el archivo no existe, créelo) y añada la siguiente entrada al objeto `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]
>
> Reinicie Cursor después de editar el archivo manualmente.

## Prompts de ejemplo para flujos de trabajo de desarrollo

Después de conectar el servidor MCP de Kameleoon, use prompts como los siguientes en su 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>`."

Para flujos de trabajo más avanzados, pruebe los siguientes prompts:

* "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."

## Consejos para escribir prompts

* Incluya el código del sitio cuando trabaje con feature flags.
* Incluya el ID del experimento cuando consulte experimentos o resultados de experimentos.
* Incluya `experimentId` y `variationId` cuando pida el código de una variación.
* Indique explícitamente el entorno de destino cuando pida al agente que active o desactive un feature flag.
* Pida un resumen en lenguaje sencillo si quiere que su agente de IA interprete la respuesta MCP en lugar de limitarse a recuperar los datos sin procesar.