Shopify MCP 服务管理工具
通过 GraphQL API 启用与 Shopify 商店数据的交互,提供管理产品、客户、订单、折扣等的工具,并具备强大的错误处理功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"shopify": {
"args": [
"-y",
"shopify-mcp-server"
],
"command": "npx",
"env": {
"MYSHOPIFY_DOMAIN": "\u003cSHOP\u003e.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "\u003cTOKEN\u003e"
}
}
}
}
该服务需要配置环境变量:MYSHOPIFY_DOMAIN、SHOPIFY_ACCESS_TOKEN
可用工具 (15 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
get-products 2 个参数 需填 1 项
Get all products or search by title
必填参数:limit
get-products-by-collection 2 个参数 需填 1 项
Get products from a specific collection
必填参数:collectionId
get-products-by-ids 1 个参数 需填 1 项
Get products by their IDs
必填参数:productIds
get-variants-by-ids 1 个参数 需填 1 项
Get product variants by their IDs
必填参数:variantIds
get-customers 2 个参数
Get shopify customers with pagination support
该工具无需必填参数,直接调用即可
tag-customer 2 个参数 需填 2 项
Add tags to a customer
必填参数:customerId、tags
get-orders 5 个参数
Get shopify orders with advanced filtering and sorting
该工具无需必填参数,直接调用即可
get-order 1 个参数 需填 1 项
Get a single order by ID
必填参数:orderId
create-discount 7 个参数 需填 6 项
Create a basic discount code
必填参数:title、code、valueType、value、startsAt、appliesOncePerCustomer
create-draft-order 4 个参数 需填 3 项
Create a draft order
必填参数:lineItems、email、shippingAddress
complete-draft-order 2 个参数 需填 2 项
Complete a draft order
必填参数:draftOrderId、variantId
get-collections 2 个参数
Get all collections
该工具无需必填参数,直接调用即可
get-shop
Get shop details
该工具无需必填参数,直接调用即可
get-shop-details
Get extended shop details including shipping countries
该工具无需必填参数,直接调用即可
manage-webhook 4 个参数 需填 3 项
Subscribe, find, or unsubscribe webhooks
必填参数:action、callbackUrl、topic
服务介绍
🚀 概述
Shopify MCP 服务器通过模型上下文协议在您的应用程序和 Shopify 生态系统之间提供了一个强大的桥梁。通过简单的 API 调用轻松管理产品、客户、订单等。
📋 目录
📥 安装
选择您喜欢的安装方法:
| 方法 | 说明 |
|---|---|
| Smithery | |
| Glama.ai | |
| NPM | npm install shopify-mcp-server |
✨ 功能
- 🛍️ 全面的产品管理 - 搜索、检索和管理产品数据
- 👥 客户数据访问 - 获取客户信息并管理标签
- 📦 高级订单处理 - 轻松过滤、排序和管理订单
- ⚡ 直接 GraphQL 集成 - 直接连接到 Shopify 的管理 API
- 🛡️ 强大的错误处理 - 清晰的故障排除反馈
🧰 可用工具
产品管理
| 工具 | 描述 | 关键参数 |
|---|---|---|
get-products |
按标题查找产品 | searchTitle, limit |
get-products-by-collection |
获取集合中的产品 | collectionId, limit |
get-products-by-ids |
检索特定产品 | productIds |
get-variants-by-ids |
获取变体详情 | variantIds |
客户管理
| 工具 | 描述 | 关键参数 |
|---|---|---|
get-customers |
检索客户数据 | limit, next |
tag-customer |
为客户添加标签 | customerId, tags |
订单管理
| 工具 | 描述 | 关键参数 |
|---|---|---|
get-orders |
过滤和排序订单 | first, after, query, sortKey |
get-order |
获取单个订单详情 | orderId |
商店与集合工具
| 工具 | 描述 | 关键参数 |
|---|---|---|
get-collections |
检索商店集合 | limit, name |
get-shop |
获取基本商店详情 | 无 |
get-shop-details |
获取扩展的商店信息 | 无 |
折扣管理
| 工具 | 描述 | 关键参数 |
|---|---|---|
create-discount |
创建折扣码 | title, code, valueType, value |
🏁 开始使用
-
安装包
npm install shopify-mcp-server -
设置环境变量
SHOPIFY_ACCESS_TOKEN=your_token MYSHOPIFY_DOMAIN=your-store.myshopify.com -
初始化服务器
require('shopify-mcp-server').start(); -
进行您的第一个API调用
const products = await shopifyMcpServer.tools.getProducts({ limit: 10 }); console.log(products);
💡 使用场景
- 电子商务平台集成 - 在系统之间同步产品和订单
- 自定义管理仪表板 - 构建符合您业务需求的界面
- 订单自动化 - 设置工作流程以实现自动订单处理
- 多渠道销售管理 - 管理所有销售渠道的库存
🔧 设置指南
获取Shopify访问令牌
- 从您的Shopify管理员页面,转到 设置 > 应用程序和销售渠道
- 点击 开发应用 > 创建一个应用
- 命名您的应用(例如:“Shopify MCP Server”)
- 配置API权限范围:
read_products,write_productsread_customers,write_customersread_orders,write_orders
- 点击 保存 并 安装应用
- 复制您的 Admin API访问令牌
安全提示: 安全地存储您的访问令牌。切勿将其提交到版本控制系统。
与Claude桌面版一起使用
在您的 claude_desktop_config.json 中添加:
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": ["-y", "shopify-mcp-server"],
"env": {
"SHOPIFY_ACCESS_TOKEN": "<TOKEN>",
"MYSHOPIFY_DOMAIN": "<SHOP>.myshopify.com"
}
}
}
}
👨💻 开发
# Clone the repository
git clone https://github.com/your-username/shopify-mcp-server.git
# Install dependencies
cd shopify-mcp-server
npm install
# Set up environment variables
# Create a .env file with your Shopify credentials
# Build and test
npm run build
npm test
🤝 社区
| 资源 | 链接 |
|---|---|
| GitHub讨论 | 加入对话 |
| 问题追踪器 | 报告错误 |
| @rezajafar | |
| Discord | 加入我们的服务器 |