通过 GraphQL API 启用与 Shopify 商店数据的交互,提供管理产品、客户、订单、折扣等的工具,并具备强大的错误处理功能。
438 查看 · 2026-07-07 更新
简介
通过 GraphQL API 启用与 Shopify 商店数据的交互,提供管理产品、客户、订单、折扣等的工具,并具备强大的错误处理功能。
简介
通过 GraphQL API 启用与 Shopify 商店数据的交互,提供管理产品、客户、订单、折扣等的工具,并具备强大的错误处理功能。
🚀 概述
Shopify MCP 服务器通过模型上下文协议在您的应用程序和 Shopify 生态系统之间提供了一个强大的桥梁。通过简单的 API 调用轻松管理产品、客户、订单等。
📋 目录
📥 安装
选择您喜欢的安装方法:
✨ 功能
- 🛍️ 全面的产品管理 - 搜索、检索和管理产品数据
- 👥 客户数据访问 - 获取客户信息并管理标签
- 📦 高级订单处理 - 轻松过滤、排序和管理订单
- ⚡ 直接 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 | 加入我们的服务器 |
使用模型上下文协议❤️构建
工具列表
-
get-products: Get all products or search by title
-
get-products-by-collection: Get products from a specific collection
-
get-products-by-ids: Get products by their IDs
-
get-variants-by-ids: Get product variants by their IDs
-
get-customers: Get shopify customers with pagination support
-
tag-customer: Add tags to a customer
-
get-orders: Get shopify orders with advanced filtering and sorting
-
get-order: Get a single order by ID
-
create-discount: Create a basic discount code
-
create-draft-order: Create a draft order
-
complete-draft-order: Complete a draft order
-
get-collections: Get all collections
-
get-shop: Get shop details
-
get-shop-details: Get extended shop details including shipping countries
-
manage-webhook: Subscribe, find, or unsubscribe webhooks
服务配置
[{'mcpServers': {'shopify': {'args': ['-y', 'shopify-mcp-server'], 'command': 'npx', 'env': {'MYSHOPIFY_DOMAIN': '<SHOP>.myshopify.com', 'SHOPIFY_ACCESS_TOKEN': '<TOKEN>'}}}}]
来源
- 来源:github
- 链接:https://github.com/rezapex/shopify-mcp-server-main