---
title: "Conecta asistentes de IA a Adapty (MCP)"
description: "Conecta la aplicación Claude, Claude Code, Codex u otro cliente MCP a tu cuenta de Adapty y gestiona productos, paywalls, flows, placements, pruebas A/B y analíticas desde un chat."
---
> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`
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](#add-the-adapty-skills). 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.
:::
*Ejemplo de conversación con una app de muestra. Tus números, paywalls y pruebas serán diferentes.*
**User:** La conversión de prueba a pago bajó el mes pasado. Averigua dónde y configura una prueba para recuperarla.
**Agent ran:** 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
**Agent:**
**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.
**Agent asks:** 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?
1. Sí, iniciar la prueba
2. No, mantenerla como borrador
## Añade las skills de Adapty \{#add-the-adapty-skills\}
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](flow-generator-skill) 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](export-analytics-with-ai) 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 \{#add-the-plugin-in-the-claude-app\}
El plugin se añade desde los ajustes de Claude, sin necesidad de usar la línea de comandos.
1. En Claude, abre **Settings** → **Plugins**.
2. Haz clic en **Add** → **Add marketplace**.
3. Selecciona **Add from a repository**.
4. 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**.
5. Haz clic en **Sync**.
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**.
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 \{#add-the-plugin-in-a-coding-agent\}
En Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor y otros agentes de código, ejecuta:
```bash
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](#connect-your-assistant).
Antes de su primer paso, cada skill detecta si tu agente tiene el servidor MCP, la [CLI para desarrolladores de Adapty](developer-cli), 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.
## Qué puede hacer el asistente \{#what-the-assistant-can-do\}
Las herramientas del servidor siguen el Adapty Dashboard y el [Adapty Developer CLI](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](mail-mcp).
## Elige el servidor MCP o la CLI \{#choose-the-mcp-server-or-the-cli\}
El servidor MCP y la [Adapty Developer CLI](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](developer-cli-cowork).
## Antes de empezar \{#before-you-start\}
- **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 \{#connect-your-assistant\}
La app de Claude (claude.ai y Claude desktop) añade servidores MCP remotos como conectores personalizados.
1. Para añadir el servidor, abre **Settings → Connectors** y haz clic en **Add custom connector**.
2. Introduce un nombre, por ejemplo `Adapty`, y la URL `https://mcp.adapty.io/mcp`.
3. Deja la configuración de autenticación por defecto y haz clic en **Add**.
4. Inicia sesión en Adapty en la pestaña del navegador que se abre. Consulta [Iniciar sesión](#sign-in).
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:
```bash
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:
```bash
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:
```toml
[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](developer-cli-quickstart) desde un agente de terminal.
## Iniciar sesión \{#sign-in\}
Todos los clientes terminan en el mismo sitio: la página de inicio de sesión de Adapty en tu navegador.
1. Inicia sesión con tu cuenta de Adapty, si aún no lo has hecho.
2. 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 \{#start-working\}
Pregúntale al asistente qué apps puede ver y luego indícale en cuál quieres trabajar. Algunas peticiones que puedes probar:
```text
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 \{#disconnect\}
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 \{#troubleshooting\}
| 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](developer-cli-quickstart). |