Cómo conectar Appstle Subscriptions a ChatGPT 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 + ChatGPT

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Appstle Subscriptions.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

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

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

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