关于 mcp-shopify
mcp-shopify 是 Shopify Admin REST API 的 MCP 服务，提供订单、商品、客户、库存、履约等 28 个工具。适合需要通过自定义应用直接管理 Shopify 店铺的商家与开发者，也适用于国际化品牌的电商运营自动化。
主要功能
- 01订单、草稿订单与退款操作
- 02商品、变体与集合管理
- 03客户与库存数量调整
- 04履约及物流单号更新
- 05折扣规则、优惠码与 Webhook 注册
适用场景
- 01根据库存变化自动调整商品库存
- 02自动处理退款与订单履约
- 03创建促销活动与优惠码
MCP 相关
该项目是 MCP 服务，向 MCP 客户端暴露 Shopify 店铺的订单、商品、客户、库存、履约及促销等 28 个工具。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @codespar/mcp-shopifySHOPIFY_SHOPShopify shop subdomain (e.g. 'acme' for acme.myshopify.com)SHOPIFY_ACCESS_TOKEN密钥Shopify Admin API access token (private/custom app) sent as X-Shopify-Access-Token headerSHOPIFY_API_VERSIONShopify Admin API version. Defaults to 2024-01.本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。
工具
28收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | 否 | 要检索的订单 ID 逗号分隔列表 |
| limit | number | 否 | 每页最多结果数（1-250，默认 50） |
| status | enum | 否 | 订单状态。默认为 'open'。open | closed | cancelled | any |
| created_at_max | string | 否 | ISO-8601 格式的 created_at 最晚时间戳 |
| created_at_min | string | 否 | ISO-8601 格式的 created_at 最早时间戳 |
| updated_at_min | string | 否 | ISO-8601 格式的 updated_at 最早时间戳 |
| financial_status | string | 否 | 按财务状态筛选（paid、pending、refunded、voided、partially_paid、partially_refunded、authorized） |
| fulfillment_status | string | 否 | 按配送状态筛选（shipped、partial、unshipped、any、unfulfilled） |
详细介绍
@codespar/mcp-shopify
适用于 Shopify 的 MCP 服务——全球电商平台的 Admin REST API。
Shopify 是全球 DTC 标准，也是拉美地区占主导地位的平台，适用于开展国际业务的品牌（对于仅面向区域市场的商家，可与本目录中的 Nuvemshop/Tiendanube 搭配使用）。构建商家工具的 Agent——例如补货、退款自动化、营销活动和履约编排——可直接集成 Admin API，而不是通过经销商接入。
工具（28）
| 工具 | 用途 |
|---|---|
list_orders | 列出订单，可选筛选条件。 |
get_order | 按 ID 获取单个订单及完整详情。 |
create_order | 创建新订单。 |
update_order | 更新现有订单（标签、备注、电子邮件、shipping_address、metafields 等）。 |
cancel_order | 取消订单。 |
list_products | 列出产品，可选筛选条件。 |
get_product | 按 ID 获取单个产品，包括所有变体和图片。 |
create_product | 创建包含变体、选项和图片的新产品。 |
update_product | 更新现有产品的字段、变体或图片。 |
list_customers | 列出客户，可选查询筛选条件。 |
create_customer | 创建新的客户记录。 |
adjust_inventory | 按增量调整指定位置特定 inventory_item 的可用库存（正数表示增加... |
create_fulfillment | 为订单创建履约记录（将订单项标记为已发货，并附上跟踪编号和承运商）。 |
update_fulfillment_tracking | 更新现有履约记录的跟踪编号、跟踪公司或跟踪 URL（发货后跟踪... |
create_draft_order | 创建草稿订单（发票式报价）。 |
complete_draft_order | 将草稿订单转换为正式订单。 |
create_price_rule | 创建价格规则（用于管理折扣的政策——百分比/固定金额、适用条件、适用对象... |
create_discount_code | 创建与现有价格规则关联的折扣码（客户使用的字符串，例如 'SUMMER20'）。 |
create_smart_collection | 创建智能系列——根据规则自动填充的系列（例如... |
create_custom_collection | 创建自定义系列——手动整理的系列。 |
create_metafield | 将 metafield（自定义类型字段）附加到资源（商店、产品、变体、客户、订单、系列... |
create_variant | 为现有产品添加新变体（具有独立价格和库存的尺寸/颜色/SKU 组合）。 |
update_variant | 更新现有产品变体的价格、SKU、条形码、选项、重量或库存政策。 |
list_transactions | 列出订单的所有支付交易（授权、捕获、销售、退款、撤销），包括网关... |
list_abandoned_checkouts | 列出已放弃的结账（客户填写了联系信息但未完成结账的购物车）。 |
list_locations | 列出所有履约地点（实体店、仓库、3PL）。 |
create_refund | 退款订单中的一个或多个订单项。 |
register_webhook | 为 Shopify 事件主题注册 webhook 订阅（orders/create、orders/paid、products/update、app... |
安装
npm install @codespar/mcp-shopify
环境
SHOPIFY_SHOP="acme" # subdomain (acme.myshopify.com)
SHOPIFY_ACCESS_TOKEN="shpat_..." # Admin API access token (secret)
SHOPIFY_API_VERSION="2024-01" # Optional. Defaults to 2024-01.
身份验证
私有/自定义应用访问令牌会作为标头随每个请求发送：
X-Shopify-Access-Token: <SHOPIFY_ACCESS_TOKEN>
在 Shopify 后台中创建自定义应用：Settings → Apps and sales channels → Develop apps，授予所需的 Admin API 权限范围（订单、产品、客户、库存、履约的读取/写入权限），然后安装应用以生成令牌。
运行
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-shopify
# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-shopify
API 概览
使用 https://{shop}.myshopify.com/admin/api/{version} 上的 Shopify Admin REST API。默认版本为 2024-01（稳定版）。发布更新的稳定版本后，可通过 SHOPIFY_API_VERSION 覆盖此版本。
企业版
需要为 Agent 付款提供治理、预算限制和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。