跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Appstle Subscriptions，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
在任意 AI 智能体中管理 Appstle 的 Shopify 订阅：订阅合同和客户，即将到来和过去的续订订单，暂停和恢复，跳过和改期，频率和下次扣款日期，添加、替换或移除商品，折扣，收货地址，销售计划，替换规则，挽留记录和每份合同的收入。取消和立即扣款在安装时关闭。
试试这样问
Appstle Subscriptions 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Appstle Subscriptions、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Appstle Subscriptions
在任意 AI 智能体中管理 Appstle 的 Shopify 订阅：订阅合同和客户，即将到来和过去的续订订单，暂停和恢复，跳过和改期，频率和下次扣款日期，添加、替换或移除商品，折扣，收货地址，销售计划，替换规则，挽留记录和每份合同的收入。取消和立即扣款在安装时关闭。
设置
设置大约需要 2 分钟。你需要一个安装了 Appstle Subscriptions 应用、且套餐包含 API 访问的 Shopify 店铺。
- 在 Shopify 后台打开 Appstle Subscriptions 应用，然后进入 Settings、API Key Management。
- 创建一个 API 密钥（每个店铺最多 10 个），粘贴到
APPSTLE_API_KEY。连接器通过X-API-Key请求头发送它。该密钥拥有店铺订阅的完整访问权限，请妥善保密。 - 安装连接器并运行
appstle_subscriptions_list_subscription_contracts：它会列出订阅合同并确认密钥可用。
连接器使用 Appstle Subscriptions Admin API（https://subscription-admin.appstle.com/api/external/v2）。
可读取的内容：订阅合同，包括状态、客户、下次扣款日期、扣款和配送间隔、商品和订单金额，可按状态、日期、客户姓名或邮箱、订单号、商品、变体、销售计划或金额搜索。Shopify 保存的完整合同，包括订单行 ID、折扣 ID、配送方式和地址以及支付方式。有订阅的客户及其资料、支付方式和合同。带扣款尝试 ID 的即将到来订单（QUEUED），过去的续订订单（成功、失败和已跳过；不包括结账时的首单），以及最近一笔订单的物流跟踪。订阅组和销售计划，商品替换规则，合同可切换的配送方式，每份合同的收入和当前扣款周期，按状态汇总的全店续订扣款报告（SUCCESS 用于收入，FAILURE 用于失败的付款），以及挽留记录：客户每次进入取消或暂停流程时的原因，以及是否接受了挽留优惠。
可写入的操作：暂停（PAUSED）或恢复（ACTIVE）订阅，调整下次扣款日期，修改扣款和配送频率，跳过、恢复或改期某个即将到来的订单，添加、修改、替换或移除商品，切换销售计划，应用 Shopify 折扣码或自定义折扣并移除折扣，修改收货地址和订单备注，以及让 Shopify 给客户发送更新支付方式的链接。它还可以生成客户门户的限时登录链接；该链接会以该客户身份登录，所以只能交给该客户本人。这些更改会影响真实的订阅，通常还会给客户发邮件，因此 AI 会先说明将要更改的内容并等你同意。
安装时关闭：appstle_subscriptions_cancel_contract（停止所有后续扣款和配送；已取消的合同无法恢复）和 appstle_subscriptions_bill_order_now（立即从客户的银行卡扣款；结果稍后出现在过去的订单中）。团队需要时由管理员开启。
数据格式：合同、客户、扣款尝试、订阅组、商品和变体 ID 是数字。订单行 ID 和折扣 ID 是完整的 Shopify GraphQL ID，例如 gid://shopify/SubscriptionLine/...，AI 会原样传递。日期为带时区的 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 是频率限制：稍等后重试。
该连接器不会创建新订阅，不会编辑订阅组、销售计划或替换规则，也不会自行更改支付方式：它会把更新链接发给客户。
前提条件: APPSTLE_API_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 Appstle Subscriptions 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
appstle_subscriptions_list_subscription_contracts | List and search subscription contracts of the shop: contract id, status, customer name and email, next billing date, billing and delivery… |
appstle_subscriptions_get_contract | One subscription contract as Shopify holds it: status, next billing date, billing and delivery policy, lines (with the line ids the line… |
appstle_subscriptions_get_contract_analytics | Revenue analytics of one contract: total revenue generated, number of successful orders and the formatted revenue |
appstle_subscriptions_get_contract_current_cycle | Current billing cycle number of a contract (how many successful billings so far, the initial order counting as 1) |
appstle_subscriptions_get_contract_fulfillments | Fulfillment of the latest successful order of a contract: shipment status, tracking numbers and links, delivery estimate and fulfilled line… |
appstle_subscriptions_get_delivery_options | Delivery methods a contract can switch to, based on its address and products (shipping, local delivery, pickup) |
appstle_subscriptions_list_upcoming_orders | Upcoming (QUEUED) orders of a contract or a customer, by billing date: billing attempt id, billing date and status |
appstle_subscriptions_list_past_orders | Past (processed) renewal orders of the shop, a contract or a customer: successful, failed and skipped billing attempts with order id and… |
appstle_subscriptions_get_past_orders_report | Report of renewal billing attempts across the shop by status (e.g |
appstle_subscriptions_list_customers | Customers that have subscriptions, with name, email, number of subscriptions and their status |
appstle_subscriptions_get_customer | One customer with profile (name, email, phone, addresses), payment methods and a page of their subscription contracts |
appstle_subscriptions_list_customer_subscriptions | All valid (active, paused or otherwise not deleted) subscription contracts of one customer with full details: status, products, billing and… |
appstle_subscriptions_get_customer_portal_link | Create a time-limited link to the customer portal where a customer manages their own subscriptions |
appstle_subscriptions_list_subscription_groups | Subscription groups (Shopify selling plan groups) with their selling plans (frequency, discount, prepaid settings) and the products and… |
appstle_subscriptions_get_subscription_group | One subscription group (selling plan group) by id with its plans and products |
appstle_subscriptions_list_selling_plans | Every selling plan across all subscription groups in one flat list: selling plan id and name, frequency, discount and group |
appstle_subscriptions_list_product_swaps | Product swap automations of the shop: rules that replace products in subscription orders after a number of cycles, with source and… |
appstle_subscriptions_list_retention_activities | Customer retention activities: each time a customer went through the cancel or pause flow, with the reason, the retention offer shown and… |
appstle_subscriptions_update_contract_status | Pause (PAUSED) or resume (ACTIVE) a subscription |
appstle_subscriptions_cancel_contract | Cancel a subscription contract now: all future billing and deliveries stop and the customer gets the cancellation email if enabled |
appstle_subscriptions_update_next_billing_date | Move the next billing (order) date of a contract |
appstle_subscriptions_update_billing_interval | Change how often the customer is charged, e.g. every 2 WEEK or every 1 MONTH |
appstle_subscriptions_update_delivery_interval | Change how often the subscription is delivered (for prepaid plans this can differ from billing) |
appstle_subscriptions_skip_order | Skip one upcoming (QUEUED) order by its billing attempt id; it stays listed as SKIPPED and later orders are not affected |
appstle_subscriptions_skip_upcoming_order | Skip the next upcoming order of a contract without knowing its billing attempt id |
appstle_subscriptions_unskip_order | Restore a skipped order to QUEUED so it is billed and shipped again; only possible before its billing date |
appstle_subscriptions_reschedule_order | Move one upcoming order to another date; optionally shift the later orders by the same offset |
appstle_subscriptions_bill_order_now | Charge an upcoming order now instead of on its billing date |
appstle_subscriptions_add_line_item | Add a product variant to a subscription, recurring or only for the next order |
appstle_subscriptions_update_line_item | Change a product in a subscription: its quantity, price, variant (swap to another product or flavour) and/or selling plan (frequency), in… |
appstle_subscriptions_remove_line_item | Remove a product from a subscription |
appstle_subscriptions_apply_discount_code | Apply an existing Shopify discount code to the future orders of a subscription |
appstle_subscriptions_add_custom_discount | Give a subscription a manual discount: PERCENTAGE (percentage), FIXED amount off or a fixed PRICE (amount), optionally for a limited number… |
appstle_subscriptions_remove_discount | Remove a discount from a subscription; future orders are priced without it |
appstle_subscriptions_update_shipping_address | Change the delivery address (or delivery method type) of a subscription for future orders |
appstle_subscriptions_update_order_note | Set the note added to every future order of a subscription (empty text clears it) |
appstle_subscriptions_send_payment_method_update_email | Have Shopify email the customer a secure link to update the payment method of a subscription (e.g. after a failed payment) |
示例提示
- “未来 7 天内哪些订阅会扣款？列出客户、商品和金额。”
- “找到 [email protected] 的订阅，并跳过她的下一笔订单。”
- “显示最近 30 天续订失败的付款，在我确认后给每位客户发送更新支付方式的邮件。”
- “上个月客户为什么取消？按原因和接受的优惠汇总挽留记录。”
- “把合同 123456 改为每 2 个月配送一次，并把咖啡换成低因变体。先给我看合同。”
下一步
这份指南对你有帮助吗?