Shopify MCP Pro

Shopify MCP Pro

可正常运行的 Shopify MCP 服务。将 Claude 连接到你的 Shopify 商店，管理产品、订单、客户、库存、分析等。

大多数 Shopify MCP 软件包的分析功能都有问题（存根会返回错误数据），使用已弃用的 API 字段，导致运行时崩溃，而且要求使用会悄无声息地过期的静态令牌。这个服务不会。

由 Denis Maleev 开发。

---

为什么选择它

修复的问题	详情
分析工具只是存根	getSalesReport、getConversionReport、getTrafficReport 现由 ShopifyQL 驱动，可提供真实数据
真正可用的身份验证	使用 Shopify Dev Dashboard 中的 Client ID + Secret，令牌会自动刷新，不会悄无声息地过期
已弃用的 API 字段	getInventoryLevels、listAbandonedCheckouts 已更新为 Shopify 2026-04 字段架构
运行时崩溃	对于没有配送资料的商店，getShippingZones 不再导致崩溃
新增：runShopifyQL	直接运行任意 ShopifyQL 查询，获取与 Admin → Analytics 相同的数据
Shopify Admin API	2026-04（当前 GA）+ @shopify/shopify-api v13

---

快速开始

npx @den.dance/shopify-mcp-pro

---

设置

1. 在 Shopify 中创建自定义应用

1. 前往 Shopify Admin → Settings → Apps and sales channels
2. 点击 Develop apps（如果出现提示，请启用自定义应用开发）
3. 点击 Create an app，为应用命名（例如“Claude MCP”）
4. 前往 Configure Admin API scopes，选择所需的权限范围（见下方列表）
5. 点击 Install app
6. 前往 API credentials 标签页，即可看到 Client ID 和 Client secret

注意：Shopify 默认不再显示静态访问令牌。此服务使用 Client ID + Secret 进行 OAuth 身份验证。

2. 配置 Claude Desktop

编辑 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["@den.dance/shopify-mcp-pro"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_CLIENT_ID": "your-client-id",
        "SHOPIFY_CLIENT_SECRET": "your-client-secret",
        "SHOPIFY_API_VERSION": "2026-04",
        "SHOPIFY_LOG_LEVEL": "WARNING"
      }
    }
  }
}

保存后重启 Claude Desktop。

配置 Claude Code

claude mcp add shopify -e SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
  -e SHOPIFY_CLIENT_ID=your-client-id \
  -e SHOPIFY_CLIENT_SECRET=your-client-secret \
  -- npx @den.dance/shopify-mcp-pro

---

环境变量

变量	必需	说明
SHOPIFY_STORE_DOMAIN	是	例如：my-store.myshopify.com
SHOPIFY_CLIENT_ID	是	来自 Shopify Dev Dashboard
SHOPIFY_CLIENT_SECRET	是	来自 Shopify Dev Dashboard
SHOPIFY_API_VERSION	否	默认为 2026-04
SHOPIFY_LOG_LEVEL	否	error、warning、info、debug（默认：warning）
TRANSPORT_MODE	否	stdio（默认）或 sse
PORT	否	SSE 模式的 HTTP 端口（默认：3000）

---

API 权限范围

最低推荐配置

• read_products、write_products
• read_orders
• read_customers
• read_inventory、write_inventory

分析功能所需

• read_analytics
• read_reports

完整功能集

• read_draft_orders、write_draft_orders
• read_fulfillments、write_fulfillments
• read_shipping
• read_marketing_events、write_marketing_events
• read_discounts、write_discounts
• read_price_rules、write_price_rules
• read_themes
• read_content、write_content
• read_metaobjects、write_metaobjects
• read_gift_cards、write_gift_cards

你不需要授予所有权限范围，服务会使用你授予的权限运行。需要未授予权限范围的工具会返回身份验证错误，不会影响其他工具。

---

工具

产品与库存

• listProducts — 根据筛选条件、分页和排序列出产品
• getProduct — 根据 ID 获取产品（包括库存项目 ID）
• createProduct、updateProduct
• getInventoryLevels — 查看各地点的当前库存
• adjustInventory — 调整数量
• listCollections
• setMetafield
• listMetaobjectDefinitions、createMetaobject、listMetaobjects

订单与履约

• listOrders、getOrder
• createDraftOrder、listDraftOrders
• createFulfillment、listFulfillmentOrders
• getShippingZones
• createRefund
• listTransactions

客户与 B2B

• listCustomers、getCustomer
• getCustomerAnalytics
• createCompany、listCompanies

财务

• getFinancialSummary
• createGiftCard、listGiftCards

营销与内容

• createDiscountCode、listDiscounts
• listPriceRules
• createPage、listPages
• createArticle、listBlogs
• createRedirect
• createWebhook、listWebhooks

分析与报告

• getSalesReport — 收入、订单数、AOV（ShopifyQL）
• getProductAnalytics — 按销售额排列的热门商品（ShopifyQL）
• getConversionReport — 商品转化漏斗（ShopifyQL）
• getTrafficReport — 按引荐来源划分的销售额（ShopifyQL）
• getAbandonmentReport — 按日期范围统计的购物车放弃情况
• listAbandonedCheckouts
• getMarketingReport
• getCustomerAnalytics
• runShopifyQL — 直接运行任意 ShopifyQL 查询

商店配置

• getShopInfo
• listThemes
• listLocations
• listMarkets
• getInventoryReport
• getCustomReport

---

ShopifyQL

runShopifyQL 可用于运行原始 ShopifyQL 查询。ShopifyQL 是 Shopify 原生的类 SQL 分析语言：

FROM sales SHOW total_sales, gross_sales, total_orders SINCE '2026-01-01' UNTIL '2026-05-19'
FROM products SHOW total_sales BY product_title ORDER BY total_sales DESC LIMIT 10
FROM sessions SHOW sessions BY referrer_source

需要在 Shopify 应用设置中启用 read_reports 权限范围和 Level 2 客户数据访问权限。

---

Claude 提示词示例

• “显示上个月按商品细分的销售额”
• “哪些商品的库存少于 10 件？”
• “创建一个 20% 的折扣码，有效期至月底”
• “列出过去一周放弃的结账”
• “运行 ShopifyQL 查询：FROM sales SHOW total_orders SINCE -30d”
• “获取客户生命周期价值指标”
• “显示今年按收入排名前 10 的商品”

---

SSE 模式

用于基于 HTTP 的访问或云端部署：

TRANSPORT_MODE=sse \
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
SHOPIFY_CLIENT_ID=your-client-id \
SHOPIFY_CLIENT_SECRET=your-client-secret \
PORT=3000 \
npx @den.dance/shopify-mcp-pro

端点：

• GET /sse — SSE 流
• POST /messages?sessionId={id} — 发送消息
• GET /health — 健康检查

为远程 SSE 配置 Claude Desktop：

{
  "mcpServers": {
    "shopify-remote": {
      "transport": {
        "type": "sse",
        "url": "https://your-server.com/sse"
      }
    }
  }
}

---

安全

• 切勿将凭据提交到版本控制系统
• 使用环境变量存储所有密钥
• 针对不同用例创建具有最小权限范围的独立应用
• 定期轮换 Client Secret

---

许可证

MIT