Saltar al contenido principal
El servidor Model Context Protocol (MCP) de Kameleoon conecta los asistentes de codificación con IA directamente a su proyecto de Kameleoon, lo que habilita flujos de trabajo agénticos para feature flags y experimentos. Esta guía le ayuda a automatizar la “última milla” del desarrollo indicando a sus herramientas de IA que busquen configuraciones, analicen resultados y extraigan código de variaciones directamente a su entorno de desarrollo. Registre y autentique el servidor para automatizar su ciclo de vida de implementación, desde la creación del flag hasta el rollout.

​
Funcionalidades

Tras conectar el servidor, su agente de IA puede interactuar con Kameleoon para realizar las siguientes tareas:
  • Buscar, recuperar, alternar y gestionar configuraciones de feature flags.
  • Analizar variaciones ganadoras de experimentos y recuperar resúmenes estadísticos.
  • Extraer código en bruto de variaciones (JavaScript o CSS) directamente desde los experimentos.
  • Automatizar el ciclo de vida completo de la implementación, desde la creación del flag hasta el rollout.

​
Flujo de trabajo principal: del experimento ganador a producción

El servidor MCP de Kameleoon automatiza la “última milla” de la implementación. Sin salir del IDE, puede indicar a su asistente de IA que ejecute el siguiente flujo de trabajo:
  1. Recuperar los resultados del experimento e identificar la variación ganadora.
  2. Extraer el código en bruto de la variación desde Kameleoon.
  3. Convertir el código en código nativo listo para producción (como componentes React) alineado con la base de código existente.
  4. Crear un feature flag en Kameleoon.
  5. Encapsular la nueva implementación tras el feature flag.
  6. Habilitar y validar la funcionalidad en producción.

​
Herramientas disponibles

HerramientaPropósitoEjemplo de prompt
feature_flag_listLista todos los flags de un sitio.”List all feature flags for site d1alzzxd7k.”
feature_flag_getObtiene la configuración detallada de un flag.”Show configuration for flag snake_game.”
feature_flag_enableActiva un flag (ON).”Enable the new_search flag in production.”
feature_flag_createCrea un nuevo flag básico.”Create a flag ui_refresh for site d1alzzxd7k.”
experiment_listLista los experimentos activos.”List all active experiments.”
experiment_results_getObtiene los resultados y los datos del ganador.”Show winner summary for experiment 149640.”
experiment_code_getExtrae el código JavaScript o CSS de la variación.”Pull variation code for experiment 149640.”

​
Integración con Claude

​
Requisitos previos

  • Claude Code instalado (claude --version)
  • Node.js v18 o posterior instalado (node --version)
  • Una cuenta de Kameleoon

​
Paso 1: Registrar el servidor

Para registrar el servidor en su perfil de usuario (haciéndolo 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 únicamente para el proyecto actual (lo que añade un archivo .mcp.json a su repositorio para compartirlo con el equipo), ejecute: 
claude mcp add kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
Verifique que Claude ha añadido el servidor: 
claude mcp list
Salida esperada: kameleoon: ... - ✗ Failed to connect (Esto es normal porque aún 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" }'
  1. El comando abre automáticamente una pestaña del navegador. Si no lo hace, copie la URL impresa 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.
Verifique la conexión: 
claude mcp list
Salida esperada: kameleoon: ... - ✓ Connected

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

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

​
Paso 4: Verificar la conexión

En una nueva conversación de Claude Code, pruebe los siguientes prompts:
  • “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.”

​
Resolución de problemas en Claude

SíntomaCausaSolución
El navegador no se abre.Falló el lanzamiento automático.Copie la URL de la terminal y ábrala manualmente.
Conexión rechazada en el puerto 35535.El puerto está en uso.Ejecute `netstat -anofindstr :35535`, mate el proceso y reintente.
Error al conectar tras OAuth.El token no persistió.Vuelva a ejecutar el comando del Paso 2 para refrescar su token.
Las herramientas no aparecen en Claude.La sesión se inició antes de añadir el servidor.Inicie una nueva conversación de Claude Code.
La clave mcpServers se rechaza en settings.json.Archivo incorrecto; Claude Code no utiliza esa clave.Use el comando claude mcp add en su lugar.
Error de autenticación tras un largo periodo.El token OAuth ha caducado.Vuelva a ejecutar el comando del Paso 2.

​
Integración con Antigravity

​
Configuración rápida

Pegue el siguiente prompt de inicio automático 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 en ~/.gemini/antigravity/mcp_config.json y añada el siguiente bloque JSON: 
"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 automático 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. Cree el archivo si no existe: 
[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 utiliza 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:
  1. El navegador abre automáticamente una ventana.
  2. Haga clic en Authorize en la página de inicio de sesión de Kameleoon.
  3. Kameleoon completa la callback local en el puerto 35535.
  4. La terminal confirma que el proxy se ha conectado correctamente.
Una conexión exitosa muestra una salida similar a la 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

Tras autenticarse, ejecute las siguientes comprobaciones para confirmar que las herramientas funcionan como se espera:
  1. Listar 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 listadas en la tabla de herramientas, como experiment_code_get, feature_flag_list y feature_flag_create.
  2. Recuperar feature flags: Ejecute feature_flag_list(siteCode = "d1alzzxd7k"). Una respuesta exitosa devuelve una lista de feature flags para el sitio especificado.
  3. Recuperar resultados de experimentos: Ejecute experiment_results_get(experimentId = 149640). Una respuesta exitosa incluye el nombre del experimento, el código del sitio, el tipo y el estado.

​
Integración con Cursor

Cursor integra las herramientas MCP directamente en la barra lateral del chat del IDE, lo que las hace disponibles mientras programa.

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

  1. Abra la configuración de Cursor (Cmd + Shift + J en macOS, Ctrl + Shift + J en Windows/Linux).
  2. Navegue 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: 
    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 mediante mcp.json (avanzado)

Abra ~/.cursor/mcp.json (cree el archivo si no existe) 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.

​
Ejemplos de prompts para flujos de trabajo de desarrollador

Tras conectar el servidor MCP de Kameleoon, utilice prompts como los siguientes en su 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 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 currently 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.”

​
Flujo de trabajo avanzado: automatización de extremo a extremo

Para experimentar todas las capacidades del servidor MCP, utilice un prompt de sistema completo. El siguiente ejemplo muestra cómo trasladar el código de la variación ganadora a componentes React, lo que está pensado principalmente para aplicaciones React. Indica al agente de IA que gestione todo el ciclo de vida de la implementación, desde la recuperación de los resultados ganadores hasta la generación de código nativo listo para producción, protegido tras un nuevo feature flag. Pegue el siguiente prompt en su asistente de IA:
You are integrating a Kameleoon A/B experiment into a production codebase by converting a Kameleoon PBX variation into maintainable native React code. Context
  • Experiment ID: 373001
  • Mode: strict_winner_only (default) or manual_variation_conversion (Fallback variation: 1266752)
Rules
  • Inspect the repo first and follow existing conventions (structure, styling, routing, tests, feature flags).
  • Do not copy experiment code directly. Re-implement using idiomatic React (components, hooks, state).
  • Do not keep experiment-specific logic (IDs, Kameleoon APIs) in production code.
  • Prefer existing feature flag systems for rollout.
  • Avoid DOM manipulation (no querySelector, MutationObserver, etc.).
  • Do not add new dependencies unless necessary.
  • Be explicit if something is unclear.
Workflow steps
  1. Get experiment results.
  2. Decide integration:
    • Mode A (default: strict_winner_only): Proceed only if winner.status == "clear_winner".
    • Mode B (manual): Use the fallback variation provided in the context.
  3. Get the variation code and the prompt that was used.
  4. Convert the code to React (convert JS code to React components/hooks, and CSS code to the project styling system).
  5. Create a feature flag “pbx-winning-experiment-373001” and gate the converted code behind it.

​
Referencia de parámetros de las herramientas

Utilice los nombres exactos de las herramientas y de los parámetros devueltos por tools/list. El esquema MCP en producción admite los siguientes parámetros:
HerramientaParámetros obligatoriosParámetros opcionales
feature_flag_listsiteCodeNinguno
feature_flag_getfeatureKey, siteCodeenvironmentKey
feature_flag_enablefeatureKey, siteCodeenvironmentKey
feature_flag_createfeatureKey, siteCodeNinguno
experiment_results_getexperimentIdNinguno
experiment_code_getexperimentId, variationIdNinguno
Para consultas específicas de un entorno, pase environmentKey = "production" o environmentKey = "staging" cuando esté soportado.

​
Consejos de prompting

  • Incluya el código del sitio cuando trabaje con feature flags.
  • Incluya el ID del experimento cuando consulte experimentos o sus resultados.
  • Incluya tanto experimentId como variationId cuando solicite código de una variación.
  • Nombre explícitamente el entorno objetivo cuando solicite al agente que habilite o deshabilite un feature flag.
  • Solicite un resumen en lenguaje natural si desea que su agente de IA interprete la respuesta MCP en lugar de limitarse a recuperar los datos en bruto.

​
Resolución general de problemas

​
El puerto 35535 ya está en uso

Si la autenticación falla con un error EADDRINUSE, otro proceso ya está escuchando en el puerto de callback de OAuth.
  • Causa: Un proceso mcp-remote obsoleto sigue activo de un intento de autenticación anterior.
  • Solución: Detenga el proceso obsoleto que está usando el puerto 35535 y vuelva a ejecutar el comando OAuth.

​
El servidor MCP no aparece en el chat de Codex

Es posible que Codex no recargue en caliente los servidores MCP recién añadidos en un hilo ya en ejecución.
  • Solución: Refresque Codex o inicie una nueva sesión tras actualizar config.toml.

​
El flujo del navegador no se completa

Si la ventana del navegador de OAuth se abre pero la autorización no finaliza:
  • Confirme que hizo clic en el botón Authorize en la página de inicio de sesión de Kameleoon.
  • Compruebe que la configuración de su navegador o sistema no bloquea los callbacks a localhost.
  • Abra la URL de callback manualmente si su navegador no consigue lanzarla automáticamente.

​
Los agentes headless o remotos fallan al autenticarse

Los agentes remotos o headless (como Codex alojado en la nube) no pueden completar el paso de autorización basado en navegador.
  • Solución: Utilice en su lugar una versión de escritorio de su herramienta.

​
Comando npx no encontrado

Si el comando falla con un error “not found”, asegúrese de que npx esté disponible en el path de su sistema. Las versiones 5.2 y posteriores de Node.js incluyen npx por defecto.