Cómo conectar Appstle Subscriptions a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Appstle Subscriptions, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Appstle Subscriptions + Cursor

Gestiona suscripciones de Shopify en Appstle desde cualquier agente de IA: contratos y clientes, pedidos de renovación próximos y pasados, pausar y reanudar, saltar y reprogramar, frecuencia y próxima fecha de cobro, añadir, cambiar o quitar productos, descuentos, dirección de entrega, selling plans, reglas de cambio, actividad de retención e ingresos por contrato. Cancelar y cobrar ya vienen desactivados.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

APPSTLE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una tienda Shopify con la app Appstle Subscriptions en un plan que incluya acceso a la API.

1. En el admin de Shopify abre la app Appstle Subscriptions y luego Settings, API Key Management.
2. Crea una clave API (hasta 10 por tienda) y pégala en APPSTLE_API_KEY. El conector la envía en la cabecera X-API-Key. La clave da acceso completo a las suscripciones de la tienda, así que mantenla en secreto.
3. Instala el conector y ejecuta appstle_subscriptions_list_subscription_contracts: lista contratos de suscripción y confirma la clave.

El conector usa la Appstle Subscriptions Admin API (https://subscription-admin.appstle.com/api/external/v2).

Qué lee: los contratos de suscripción con estado, cliente, próxima fecha de cobro, intervalo de cobro y de entrega, productos e importe del pedido, con búsqueda por estado, fechas, nombre o email del cliente, número de pedido, producto, variante, selling plan o importe. El contrato completo tal como lo guarda Shopify, con id de líneas, id de descuentos, método y dirección de entrega y método de pago. Los clientes con suscripciones, con su perfil, métodos de pago y contratos. Los pedidos próximos (QUEUED) con sus id de billing attempt, los pedidos de renovación pasados (correctos, fallidos y saltados; los pedidos iniciales del checkout no se incluyen) y el seguimiento del último pedido. Los grupos de suscripción y los selling plans, las reglas de cambio de productos, los métodos de entrega a los que puede pasar un contrato, los ingresos y el ciclo de cobro actual por contrato, un informe de toda la tienda de los intentos de cobro de renovaciones por estado (SUCCESS para ingresos, FAILURE para pagos fallidos) y las actividades de retención: cada vez que un cliente pasó por el flujo de cancelación o pausa, con el motivo y si aceptó la oferta de retención.

Qué escribe: pausa (PAUSED) o reanuda (ACTIVE) una suscripción, mueve la próxima fecha de cobro, cambia la frecuencia de cobro y de entrega, salta, recupera o reprograma un pedido próximo, añade, modifica, cambia o quita productos, cambia el selling plan, aplica un código de descuento de Shopify o un descuento personalizado y quita descuentos, cambia la dirección de entrega y la nota del pedido, y hace que Shopify envíe al cliente un enlace para actualizar el método de pago. También puede crear un enlace de acceso temporal al portal del cliente; ese enlace inicia sesión como el cliente, así que dáselo solo a ese cliente. Estos cambios afectan a suscripciones reales y suelen enviar un email al cliente, por eso la IA dice qué va a cambiar y espera tu sí.

Desactivadas al instalar: appstle_subscriptions_cancel_contract (detiene todos los cobros y entregas futuros; un contrato cancelado no se puede reanudar) y appstle_subscriptions_bill_order_now (cobra al instante en la tarjeta del cliente; el resultado aparece después en los pedidos pasados). Un admin las activa cuando el equipo las necesite.

Formatos de datos: los id de contratos, clientes, billing attempts, grupos, productos y variantes son numéricos. Los id de líneas y de descuentos son id GraphQL completos de Shopify como gid://shopify/SubscriptionLine/..., y la IA los pasa exactamente como llegan. Las fechas son ISO 8601 con zona horaria (2026-11-01T00:00:00Z). Los importes están en la moneda de la tienda. Los estados de contrato son ACTIVE, PAUSED y CANCELLED; los billing attempts son QUEUED, SUCCESS, FAILURE, SKIPPED y otros. Una dirección de entrega nueva se envía completa, no solo el campo cambiado.

Paginación: las herramientas de lista aceptan page (desde 0) y size (por defecto 20, como máximo 2000). El total está en _headers.x-total-count. sort acepta una columna de la base de datos en snake_case con la dirección, p. ej. next_billing_date,asc. appstle_subscriptions_get_customer pagina los contratos del cliente con cursor.

Errores comunes: 401 o 403 significa que la clave API es incorrecta o fue revocada, o que el plan de Appstle no tiene acceso a la API. 400 explica un cambio rechazado, p. ej. una fecha en el pasado, una línea por debajo del mínimo de la suscripción o un pedido que ya no está QUEUED. 404 es un id desconocido. 429 es un límite de frecuencia: espera y reintenta.

El conector no crea suscripciones nuevas, no edita grupos de suscripción, selling plans ni reglas de cambio y no cambia por sí mismo el método de pago: envía al cliente el enlace para actualizarlo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Appstle Subscriptions.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué suscripciones se cobran en los próximos 7 días? Lista cliente, productos e importe."
• "Busca las suscripciones de [email protected] y salta su próximo pedido."
• "Muestra los pagos de renovación fallidos de los últimos 30 días y, cuando lo confirme, envía a cada cliente el email para actualizar el método de pago."
• "¿Por qué se dieron de baja los clientes el mes pasado? Resume las actividades de retención por motivo y oferta aceptada."
• "Cambia el contrato 123456 a entrega cada 2 meses y sustituye el café por la variante descafeinada. Muéstrame antes el contrato."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot