Guía de inicio rápido para el CLI para desarrolladores de Adapty

El CLI de Adapty te permite configurar tu app íntegramente desde la línea de comandos. Úsalo como alternativa al inicio rápido desde el dashboard si prefieres herramientas de terminal o clientes MCP.

Al terminar, tu app, nivel de acceso, producto, paywall y placement serán visibles en el Adapty Dashboard.

Si ejecutas la CLI en Claude Cowork, permite los dominios de Adapty antes de empezar — consulta Ejecutar la CLI en Cowork.

1. Instala el CLI

Requiere Node.js 18 o posterior.

Para instalar el CLI, ejecuta el comando:

npm install -g adapty

O directamente:

npx adapty auth login

2. Autentícate

Ejecuta el comando de inicio de sesión para conectar el CLI con tu cuenta de Adapty.

adapty auth login

El CLI abre una pestaña del navegador. Verifica que el código que aparece en la terminal coincida con el del navegador y haz clic en Authorize. La terminal confirmará cuando la autenticación se haya completado.

3. Crea tu app

Una app en Adapty representa tu aplicación móvil. Una misma app de Adapty se conecta tanto a App Store como a Google Play, por lo que solo necesitas crear una, independientemente de en cuántos stores publiques.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

El comando devuelve un <app-id>. Usa este ID en todos los comandos siguientes.

4. Crea un nivel de acceso (opcional)

Los niveles de acceso controlan a qué puede acceder el usuario tras una compra. En lugar de comprobar si un usuario compró un producto concreto, tu app verifica si el usuario tiene un determinado nivel de acceso. Esto desacopla la lógica de tu app de los IDs de producto específicos.

Con cada nueva app se crea automáticamente un nivel de acceso premium. Para la mayoría de las apps puedes saltarte este paso. Usa premium como ID de nivel de acceso en el paso 5.

Solo ejecuta este comando si distintos productos desbloquean distintas funciones para diferentes grupos de usuarios; por ejemplo, si un suscriptor “Basic” y uno “Pro” tienen acceso a partes diferentes de la app.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id es el identificador que usarás en el código de tu app para comprobar si una función debe estar disponible para el usuario (por ejemplo, if user.hasAccessLevel("pro")). Si te saltas este paso y usas el nivel de acceso por defecto, su --sdk-id es premium.
• --title es una etiqueta de visualización para tu referencia en el Adapty Dashboard.

El comando devuelve un <access-level-id>.

5. Crea un producto

En Adapty, un producto representa cualquier cosa que tu app vende: una suscripción o una compra única. Los elementos de App Store Connect y Google Play se pueden agrupar en un único producto de Adapty y gestionarse desde un solo lugar.

Necesitarás los IDs de producto de cada store: el Apple product ID de App Store Connect, y el Android product ID y el base plan ID de Google Play Console. Consulta Productos para saber dónde encontrarlos.

Si omitiste el paso 4, usa el default_access_level.id que devolvió el comando apps create en el paso 3 como tu <access-level-id>.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

El comando devuelve un <product-id>.

Si también vendes este producto en la web a través de Stripe o Paddle, añade esos IDs al mismo comando. Consulta products create en la referencia de comandos.

6. Crea un paywall

Un paywall es el contenedor que alberga tus productos. En Adapty, los paywalls son la única forma de entregar productos a los usuarios. Todo producto debe estar en un paywall antes de poder aparecer en tu app.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

El comando devuelve un <paywall-id>.

7. Crea un placement

Un placement es el punto de tu app donde muestras un paywall. Lo único que tienes que escribir directamente en el código de tu app es el ID del placement. Todo lo demás —qué paywall mostrar y a qué usuarios— se gestiona desde el dashboard sin publicar una nueva versión de la app.

--developer-id es la cadena que usarás más adelante en el código de tu app cuando le pidas a Adapty qué paywall mostrar en ese punto. Elige algo que describa la ubicación, como "main", "onboarding" o "settings".

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

El flag --audiences controla qué paywall se muestra a qué usuarios. El ejemplo anterior establece una audiencia por defecto única: todos los usuarios en este placement ven el mismo paywall.

Ejecutar el CLI en Cowork

Claude Cowork ejecuta comandos en un sandbox que solo accede a dominios incluidos en la lista de permitidos. Hasta que no autorices Adapty, el CLI no podrá iniciar sesión ni leer tu cuenta. Omite esta sección si ejecutas el CLI desde tu propio terminal.

Permite tanto adapty.io como *.adapty.io. Un comodín no cubre el dominio raíz en la mayoría de las implementaciones de listas de permitidos. El CLI en sí accede a api.adapty.io, y un agente que lee la documentación de Adapty mientras trabaja accede al dominio raíz.

Cowork aplica esta configuración cuando comienza una tarea. Si cambias el modo de acceso o añades un dominio durante una conversación, esa conversación mantiene la configuración con la que empezó — inicia una nueva tarea.

Una tarea también comienza en una máquina limpia: sin CLI, sin token y sin configuración que provenga de una sesión anterior, por lo que los pasos de instalación e inicio de sesión se repiten al comienzo de cada una.

Cuentas personales

Configura la lista de permitidos tú mismo:

1. En Claude, abre Settings → Capabilities.
2. Activa Code execution and file creation. El bloque Allow network egress permanece oculto hasta que lo hagas.
3. Activa Allow network egress.
4. En Domain allowlist, selecciona Package managers only.
5. En Additional allowed domains, añade adapty.io y luego *.adapty.io.

El otro modo de acceso, All domains, permite que el sandbox acceda a cualquier sitio. Con esa opción seleccionada, no es necesario añadir los dominios de Adapty.

Espacios de trabajo corporativos

Un administrador controla la lista de permitidos. Pídele que añada ambos dominios para el espacio de trabajo.

¿Qué es lo siguiente?

Todas las entidades ya son visibles en el Adapty Dashboard. A continuación:

• Diseña tu paywall — usa el Paywall Builder sin código para añadir imágenes, diseño y textos al paywall que acabas de crear.
• Integra el SDK — añade el SDK a tu app para obtener y mostrar el placement.
• Dirige distintos segmentos de usuarios a diferentes paywalls — consulta placements update y segments list en la referencia de comandos.