Как подключить Appstle Subscriptions к ChatGPT через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Appstle Subscriptions, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Appstle Subscriptions + ChatGPT

Управляйте подписками Shopify в Appstle из любого AI-агента: договоры подписки и клиенты, будущие и прошлые заказы продления, пауза и возобновление, пропуск и перенос, частота и следующая дата списания, добавление, замена и удаление товаров, скидки, адрес доставки, selling plans, правила замены, активность удержания и выручка по договору. Отмена и немедленное списание отключены при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

APPSTLE_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен магазин Shopify с приложением Appstle Subscriptions на тарифе с доступом к API.

1. В админке Shopify откройте приложение Appstle Subscriptions, затем Settings, API Key Management.
2. Создайте API-ключ (до 10 на магазин) и вставьте его в APPSTLE_API_KEY. Коннектор передаёт его в заголовке X-API-Key. Ключ даёт полный доступ к подпискам магазина, поэтому храните его в секрете.
3. Установите коннектор и запустите appstle_subscriptions_list_subscription_contracts: он выведет договоры подписки и подтвердит ключ.

Коннектор использует Appstle Subscriptions Admin API (https://subscription-admin.appstle.com/api/external/v2).

Что он читает: договоры подписки со статусом, клиентом, следующей датой списания, интервалом списания и доставки, товарами и суммой заказа, с поиском по статусу, датам, имени или email клиента, номеру заказа, товару, варианту, selling plan или сумме. Полный договор в том виде, в каком его хранит Shopify, с ID позиций, ID скидок, способом и адресом доставки и способом оплаты. Клиентов с подписками, их профиль, способы оплаты и договоры. Будущие заказы (QUEUED) с ID попыток списания, прошлые заказы продления (успешные, неудачные и пропущенные; первые заказы из checkout не входят) и отслеживание последнего заказа. Группы подписок и selling plans, правила замены товаров, способы доставки, на которые может перейти договор, выручку и текущий цикл списания по договору, отчёт по всему магазину о попытках списания продлений по статусу (SUCCESS для выручки, FAILURE для неудачных платежей) и активность удержания: каждый раз, когда клиент проходил сценарий отмены или паузы, с причиной и тем, принял ли он предложение удержания.

Что он записывает: ставит подписку на паузу (PAUSED) или возобновляет её (ACTIVE), переносит следующую дату списания, меняет частоту списания и доставки, пропускает, возвращает или переносит будущий заказ, добавляет, изменяет, заменяет или удаляет товары, меняет selling plan, применяет код скидки Shopify или собственную скидку и удаляет скидки, меняет адрес доставки и примечание к заказу, а также просит Shopify отправить клиенту ссылку для обновления способа оплаты. Он может создать временную ссылку для входа в клиентский портал; по этой ссылке входят как клиент, поэтому давайте её только этому клиенту. Эти изменения затрагивают реальные подписки и обычно отправляют клиенту письмо, поэтому ИИ говорит, что изменится, и ждёт вашего «да».

Отключено при установке: appstle_subscriptions_cancel_contract (останавливает все будущие списания и доставки; отменённый договор нельзя возобновить) и appstle_subscriptions_bill_order_now (сразу списывает деньги с карты клиента; результат появляется позже в прошлых заказах). Администратор включает их, когда они нужны команде.

Форматы данных: ID договоров, клиентов, попыток списания, групп, товаров и вариантов числовые. ID позиций и скидок это полные GraphQL-ID Shopify вида gid://shopify/SubscriptionLine/..., и ИИ передаёт их точно в том виде, в каком получил. Даты в ISO 8601 с часовым поясом (2026-11-01T00:00:00Z). Суммы в валюте магазина. Статусы договоров: ACTIVE, PAUSED и CANCELLED; попытки списания: QUEUED, SUCCESS, FAILURE, SKIPPED и другие. Новый адрес доставки отправляется целиком, а не только изменённое поле.

Пагинация: инструменты списков принимают page (с 0) и size (по умолчанию 20, не более 2000). Общее число в _headers.x-total-count. sort принимает столбец базы данных в snake_case с направлением, например next_billing_date,asc. appstle_subscriptions_get_customer листает договоры клиента через cursor.

Частые ошибки: 401 или 403 означает неверный или отозванный API-ключ либо тариф Appstle без доступа к API. 400 объясняет отклонённое изменение, например дату в прошлом, позицию ниже минимума подписки или заказ, который уже не QUEUED. 404 это неизвестный ID. 429 это ограничение частоты: подождите и повторите.

Коннектор не создаёт новые подписки, не редактирует группы подписок, selling plans и правила замены и не меняет способ оплаты сам: он отправляет клиенту ссылку для обновления.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в ChatGPT

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.

1. Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
2. Введи название, например Name: Appstle Subscriptions.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

Доступные инструменты

Примеры запросов

• «Какие подписки будут списаны в ближайшие 7 дней? Покажи клиента, товары и сумму.»
• «Найди подписки [email protected] и пропусти её следующий заказ.»
• «Покажи неудачные платежи продления за последние 30 дней и после моего подтверждения отправь каждому клиенту письмо для обновления способа оплаты.»
• «Почему клиенты отменяли подписки в прошлом месяце? Сведи активность удержания по причинам и принятым предложениям.»
• «Переведи договор 123456 на доставку раз в 2 месяца и замени кофе на вариант без кофеина. Сначала покажи договор.»

FAQ

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot