Configurar los clientes MCP

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:

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:

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:

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:

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

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.
Inicie sesión en su cuenta de Kameleoon.
Haga clic en Authorize.
Cuando el navegador muestre un mensaje de éxito, pulse Ctrl+C en su terminal.

Compruebe la conexión:

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:

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:

{
  "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:

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:

[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:

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

Comportamiento esperado:

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

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

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:

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, como experiment_code_get, feature_flag_list y feature_flag_create.
Obtenga los feature flags: Ejecute feature_flag_list(siteCode = "d1alzzxd7k"). Una respuesta correcta devuelve una lista de feature flags del sitio indicado.
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)

Abra la configuración de Cursor (Cmd+Shift+J en macOS, Ctrl+Shift+J en Windows o Linux).
Vaya a Features > MCP Servers > + Add New MCP Server.
Establezca Name en kameleoon.
Establezca Type en command.

Introduzca la siguiente cadena como Command:

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

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:

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

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.

Inicio

Configuración

Referencia de herramientas

Tutoriales

Solución de problemas

Integración con Claude Code

Paso 1: Registrar el servidor

Paso 2: Completar la autenticación OAuth

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

Paso 4: Comprobar la conexión

Integración con Antigravity

Configuración rápida

Configuración manual

Integración con Codex

Configuración rápida

Configuración manual

Autenticar la conexión

Verificar las operaciones de las herramientas

Integración con Cursor

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

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

Prompts de ejemplo para flujos de trabajo de desarrollo

Consejos para escribir prompts

Inicio

Configuración

Referencia de herramientas

Tutoriales

Solución de problemas

​Integración con Claude Code

​Paso 1: Registrar el servidor

​Paso 2: Completar la autenticación OAuth

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

​Paso 4: Comprobar la conexión

​Integración con Antigravity

​Configuración rápida

​Configuración manual

​Integración con Codex

​Configuración rápida

​Configuración manual

​Autenticar la conexión

​Verificar las operaciones de las herramientas

​Integración con Cursor

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

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

​Prompts de ejemplo para flujos de trabajo de desarrollo

​Consejos para escribir prompts

Integración con Claude Code

Paso 1: Registrar el servidor

Paso 2: Completar la autenticación OAuth

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

Paso 4: Comprobar la conexión

Integración con Antigravity

Configuración rápida

Configuración manual

Integración con Codex

Configuración rápida

Configuración manual

Autenticar la conexión

Verificar las operaciones de las herramientas

Integración con Cursor

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

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

Prompts de ejemplo para flujos de trabajo de desarrollo

Consejos para escribir prompts