Conecta asistentes de IA a Adapty (MCP)

El servidor MCP de Adapty conecta un asistente de IA con tu cuenta de Adapty. Pregunta sobre ingresos y conversiones, configura productos y placements, publica flows o inicia una prueba A/B desde un chat, en lenguaje natural. El asistente inicia sesión con tu cuenta de Adapty en el navegador y obtiene tus permisos. No se necesita ninguna clave de API.


URL del servidor	`https://mcp.adapty.io/mcp`
Protocolo	MCP sobre Streamable HTTP, inicio de sesión OAuth 2.1 en el navegador
Compatible con	La app de Claude (web y escritorio), Claude Code, Codex y otros clientes MCP que admitan inicio de sesión con OAuth

Important

El servidor MCP funciona mejor junto con las skills de Adapty. El servidor da al asistente acceso a tu cuenta; las skills le proporcionan flujos de trabajo probados para el trabajo. Construir flows y paywalls y encontrar qué probar en tus analíticas depende de las skills.

Claude

La conversión de prueba a pago bajó el mes pasado. Averigua dónde y configura una prueba para recuperarla.

Se usaron 6 herramientas de Adapty

analytics_conversion — conversión de trial a pago, por país, últimos dos meses
analytics_conversion — conversión de trial a pago en Alemania, por placement
placements_get — settings_upgrade
paywalls_list
ab_tests_list — pruebas de paywall en settings_upgrade
ab_tests_create — un borrador de prueba, 50/50

La conversión de trial a pago cayó solo en Alemania, del 41% al 29%, y únicamente en el placement settings_upgrade.

Todos los demás países se mantuvieron estables. El 2 de octubre, settings_upgrade cambió de la paywall Annual first a Weekly focus, que presenta el plan semanal en primer lugar. Desde entonces, menos usuarios alemanes que inician una prueba allí pagan al finalizarla.

He creado un borrador de prueba A/B en settings_upgrade para usuarios en Alemania: Annual first frente a Weekly focus, 50/50. Por ahora no ha cambiado nada para tus usuarios.

Iniciar la prueba A/B

Si inicio la prueba, la mitad de los usuarios alemanes que abran settings_upgrade verán Anual primero a partir de hoy. Los usuarios de otros países seguirán viendo Weekly focus. Puedes detener la prueba en cualquier momento, pero no puedes deshacer el inicio. ¿La iniciamos?

Sí, iniciar la prueba
No, mantenerla como borrador

Ejemplo de conversación con una app de muestra. Tus números, paywalls y pruebas serán diferentes.

Añade las skills de Adapty

El servidor MCP da a tu asistente acceso a tu cuenta de Adapty. Las skills de Adapty le proporcionan el conocimiento: flujos de trabajo probados que planifican un cambio, lo verifican y preguntan antes de cada paso que llega a tus usuarios. Instálalos juntos. El plugin adapty-skills incluye las skills y este servidor MCP.

Hay dos tipos de trabajo que dependen de las skills:

Flows y paywalls: El skill flow-generator incluye las reglas de configuración del Flow Builder. Construye pantallas a partir de una descripción o una captura de pantalla, y valida y previsualiza cada cambio antes de guardar el flow. Sin el skill, un asistente puede leer y escribir una configuración de flow, pero no tiene reglas para validarla.
Analítica y qué probar a continuación: El skill growth-advisor sabe qué informes leer y cómo interpretarlos, y convierte tus números en hipótesis para pruebas A/B. Sin el skill, un asistente puede obtener tus gráficos, pero no tiene un método para explicarlos.

Añadir el plugin en la app de Claude

El plugin se añade desde los ajustes de Claude, sin necesidad de usar la línea de comandos.

En Claude, abre Settings → Plugins.
Haz clic en Add → Add marketplace.
Selecciona Add from a repository.
En el campo URL, introduce adaptyteam/adapty-skills y selecciona el repositorio. Para recibir nuevos skills y correcciones a medida que se publiquen, mantén activado Sync automatically.
Haz clic en Sync.

Add marketplace dialog in Claude with adaptyteam/adapty-skills in the URL field and Sync automatically turned on

Claude abre la pestaña Discover con los plugins del marketplace de Adapty. Para instalar los skills, en la fila Adapty, haz clic en Add.

Discover tab in Claude listing the Adapty, Apple ads, and Apple ads benchmarks plugins, each with an Add button

Las skills ejecutan sus scripts en el sandbox de Claude. Para permitirlo, en Settings → Capabilities, activa Code execution and file creation.

Añade el plugin en un agente de código

En Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor y otros agentes de código, ejecuta:

npx adapty skills install

El comando instala el plugin a través del instalador propio de tu agente cuando dispone de uno. Reinicia el agente después. En Claude Code y Codex, el plugin también añade el servidor MCP de Adapty, por lo que solo tienes que iniciar sesión, tal como se describe en Conecta tu asistente.

Qué skills usan el servidor MCP y cuáles usan la CLI

Antes de su primer paso, cada skill detecta si tu agente tiene el servidor MCP, la CLI para desarrolladores de Adapty, o ambos. Con uno de ellos, el skill lo usa. Con ambos, el skill usa el que mejor se adapta a su trabajo:

Servidor MCP: Ejecutar pruebas A/B, integrar el SDK y probar compras.
CLI de Adapty: Crear y auditar flows, identificar qué probar a continuación, migrar placements a flows y crear segmentos. Estos skills ejecutan sus propios scripts y archivos, y la CLI les pasa los archivos directamente.

Crear y editar flows

Instala la skill flow-generator para que tu herramienta de IA pueda crear, traducir y reestructurar flows de Adapty a través de la CLI de Adapty.

Encuentra qué probar a continuación

Instala el skill growth-advisor para que tu herramienta de IA lea tus análisis de Adapty, detecte dónde pierde ingresos tu app y sugiera qué probar en la siguiente prueba A/B.

Ejecutar pruebas A/B

Instala el skill ab-tests para que tu herramienta de IA cree, inicie, detenga y reemplace pruebas A/B de paywalls y flows en Adapty, y te muestre quién ve qué antes de cada paso irreversible.

Integración basada en skills

Usa la skill adapty-integration para integrar el SDK de Adapty en tu app de iOS de extremo a extremo con tu herramienta de codificación con IA.

Qué puede hacer el asistente

Las herramientas del servidor siguen el Adapty Dashboard y el Adapty Developer CLI. El asistente elige las herramientas según tu solicitud; no necesitas nombrarlas tú.

Área	Lo que el asistente puede hacer	Prueba preguntando
Apps y niveles de acceso	Listar, crear y actualizar apps y niveles de acceso	”Crea un nivel de acceso `premium` en Fitness Pro.”
Productos y ofertas	Crear productos con sus IDs de producto en el store y vincular ofertas del store a ellos	”¿Cuáles de mis productos no tienen un ID de producto de Google Play?”
Paywalls	Crear y actualizar paywalls, y encontrar los placements que muestran cada uno	”¿Qué placements muestran el paywall Annual sale?”
Flows	Crear flows, leer y escribir sus configuraciones del builder, validar, previsualizar, publicar y leer métricas de flows	”Publica el flow Onboarding v2 y dime qué placements lo muestran.”
Placements y audiencias	Crear placements y cambiar quién ve qué, y leer las métricas de los placements de flows	”¿Quién ve qué en el placement `onboarding`?”
Segmentos	Leer segmentos y sus filtros	”Lista mis segmentos y por qué filtra cada uno.”
Pruebas A/B	Crear, iniciar, detener, reemplazar y archivar pruebas A/B de paywalls y flows	”Inicia el borrador de la prueba Weekly vs annual para usuarios en Alemania.”
Analytics	Leer ingresos, MRR, conversiones, el funnel, retención, LTV y cohortes de instalación	”Compara la conversión de prueba a pago por país del mes pasado.”
Migración desde RevenueCat	Crear y ejecutar una migración de tu catálogo de RevenueCat a una nueva app de Adapty	”Mueve mi proyecto de RevenueCat a una nueva app de Adapty.”

Adapty Mail tiene su propio servidor MCP. Para conectar un asistente a tu proyecto de Adapty Mail, consulta Gestiona Adapty Mail con asistentes de IA.

Elige el servidor MCP o la CLI

El servidor MCP y la Adapty Developer CLI acceden a la misma cuenta de Adapty. Elige según dónde se ejecute tu asistente:

	Servidor MCP de Adapty	Adapty CLI
Se ejecuta en	Cualquier cliente MCP, incluidas aplicaciones de chat como la app de Claude	Agentes que ejecutan comandos de terminal y tus propios scripts
Inicio de sesión	Una vez por cliente, en el navegador	`adapty auth login`, una vez por máquina
Ideal para	Preguntas y cambios desde un chat	Editar configuraciones de flow, cambios en lote y scripts
Instalación	No requiere instalación	`npm install -g adapty`

Un agente puede usar ambos. En la app de Claude, el servidor MCP requiere menos configuración que la CLI: la CLI debe instalarse y autorizarse en cada conversación, como se describe en Configura la CLI de Adapty en la app de Claude.

Antes de empezar

Cuenta de Adapty: El asistente opera en las empresas y apps a las que tu cuenta de Adapty tiene acceso, con tus permisos.
Cliente MCP con OAuth: Tu cliente es compatible con servidores MCP remotos que inician sesión con OAuth.

Warning

El asistente actúa con tus derechos y sus cambios son reales. Una prueba A/B iniciada o un placement modificado llega a tus usuarios. Antes de que el asistente inicie o detenga una prueba A/B, o cambie quién ve qué en un placement, el servidor le pide que describa el efecto exacto y espere tu confirmación. Lee el plan antes de aprobarlo.

Conecta tu asistente

La app de Claude (claude.ai y Claude desktop) añade servidores MCP remotos como conectores personalizados.

Para añadir el servidor, abre Settings → Connectors y haz clic en Add custom connector.
Introduce un nombre, por ejemplo Adapty, y la URL https://mcp.adapty.io/mcp.
Deja la configuración de autenticación por defecto y haz clic en Add.
Inicia sesión en Adapty en la pestaña del navegador que se abre. Consulta Iniciar sesión.

Los administradores del workspace pueden añadir el conector una sola vez para toda la organización. Cada miembro inicia sesión con su propia cuenta de Adapty la primera vez que lo usa.

Si usas el plugin adapty-skills, Claude Code ya muestra el servidor como plugin:adapty-skills:adapty, con el estado Needs authentication. Para iniciar sesión, ejecuta /mcp en Claude Code, selecciona plugin:adapty-skills:adapty y elige Authenticate.

Sin el plugin, primero añade el servidor:

claude mcp add --transport http --scope user adapty https://mcp.adapty.io/mcp

Luego ejecuta /mcp en Claude Code, selecciona adapty y elige Authenticate. Si las herramientas de Adapty no aparecen en la sesión actual, inicia una nueva sesión.

Si usas el plugin adapty-skills, el plugin añade el servidor y Codex te pide que inicies sesión cuando se conecta.

Sin el plugin, añade el servidor e inicia sesión:

codex mcp add adapty --url https://mcp.adapty.io/mcp
codex mcp login adapty

El comando de inicio de sesión abre tu navegador. Para configurar el servidor manualmente, agrégalo a ~/.codex/config.toml y luego ejecuta el comando de inicio de sesión:

[mcp_servers.adapty]
url = "https://mcp.adapty.io/mcp"

Inicia una nueva sesión de codex para cargar las herramientas de Adapty.

Añade https://mcp.adapty.io/mcp como servidor MCP remoto en la configuración de tu cliente o en el archivo de configuración MCP. La primera vez que se conecte, el cliente abrirá tu navegador para iniciar sesión.

El servidor identifica a cada cliente mediante el Client ID Metadata Document, el método de registro de clientes de la especificación MCP actual. Un cliente que no admite este método no puede completar el inicio de sesión. En ese caso, usa el Adapty Developer CLI desde un agente de terminal.

Todos los clientes terminan en el mismo sitio: la página de inicio de sesión de Adapty en tu navegador.

Inicia sesión con tu cuenta de Adapty, si aún no lo has hecho.
Permite que el cliente acceda a tu cuenta de Adapty.

El cliente leerá y modificará los datos de las empresas a las que tiene acceso tu cuenta, y permanecerá conectado hasta que lo desconectes. Aprueba solo un inicio de sesión que hayas iniciado tú mismo.

Para verificar la conexión, pregúntale al asistente con qué cuenta de Adapty ha iniciado sesión. La respuesta debería indicar tu nombre y las empresas a las que tiene acceso tu cuenta.

Empieza a trabajar

Pregúntale al asistente qué apps puede ver y luego indícale en cuál quieres trabajar. Algunas peticiones que puedes probar:

List my Adapty apps and their placements.
How did revenue and new subscriptions change last month compared with the month before?
Which products in Fitness Pro have no App Store product ID?
Show who sees what on the onboarding placement, including any A/B test.
Create a draft A/B test on main_paywall: the current paywall against Annual sale, 50/50.

El asistente pide confirmación antes de los pasos que cambian lo que ven los usuarios. Una solicitud que solo lee datos se ejecuta sin preguntas.

Después de una tarea de varios pasos, el asistente puede enviar al equipo de Adapty una nota breve sobre cómo fue la tarea. La nota no contiene datos personales de los usuarios de tu app.

Desconexión

Para desconectarte, elimina el servidor en el cliente:

Claude app: En Settings → Connectors, elimina el conector de Adapty.
Claude Code: Ejecuta claude mcp remove adapty. Si el servidor venía con el plugin adapty-skills, desactívalo en /mcp.
Codex: Elimina el servidor adapty de ~/.codex/config.toml.

Para volver a conectarte, añade el servidor e inicia sesión de nuevo.

Solución de problemas

Problema	Solución
Claude Code muestra el servidor como Needs authentication	El cliente añadió el servidor pero no inició sesión. Ejecuta `/mcp`, selecciona el servidor de Adapty y elige Authenticate.
El cliente no muestra ninguna herramienta de Adapty	Completa el inicio de sesión y abre una nueva sesión. Algunos clientes cargan las herramientas solo al inicio de una sesión.
El asistente no encuentra una app	La app pertenece a una empresa a la que tu cuenta de Adapty no tiene acceso. Pide acceso a un propietario de la empresa.
El cliente no puede completar el inicio de sesión	El cliente no admite el método de inicio de sesión que usa el servidor. Conéctate desde la app de Claude, Claude Code o Codex, o usa la CLI de desarrollador de Adapty.