MCP 资源中心
Model Context Protocol (MCP) 正在重塑开发者构建、管理和扩展 Shopify 商店的方式。本资源中心是 Shopify 生态系统中所有 MCP 相关内容的唯一信息来源——从官方服务器和社区工具到高级集成模式。
什么是 MCP？
Model Context Protocol 是由 Anthropic 创建的一个开放标准，定义了 AI 助手（如 Claude）与外部工具和数据源之间的通信方式。可以将其视为 AI 模型与其需要交互的服务之间的通用适配器。
┌─────────────┐ MCP Protocol ┌─────────────────┐
│ AI Client │ ◄────────────────────────► │ MCP Server │
│ (Claude Code,│ JSON-RPC over stdio │ (Shopify Admin, │
│ Cursor, etc)│ or HTTP/SSE │ Docs, GraphQL) │
└─────────────┘ └─────────────────┘
MCP 服务器通过标准化接口暴露工具（AI 可以执行的操作）、资源（AI 可以读取的数据）和提示（可重用的模板）。这意味着你可以将 Claude 连接到你的 Shopify 商店，让它读取产品、创建订单、更新库存等——全部通过自然语言完成。
核心概念
| 概念 | 描述 | Shopify 示例 |
|---|---|---|
| 工具 | AI 可以执行的操作 | create_product、update_inventory、search_orders |
| 资源 | 只读数据源 | 产品目录、订单历史、客户分群 |
| 提示 | 可重用的提示模板 | 商店审计清单、SEO 优化工作流 |
| 传输 | 通信通道 | stdio（本地）、streamable-http（远程） |
为什么 MCP 对 Shopify 开发者很重要
MCP 之前
构建 AI 驱动的 Shopify 工作流意味着需要为每个工具编写自定义集成：
Claude Code → custom script → Shopify Admin API
Claude Code → custom script → Shopify Docs
Claude Code → custom script → Theme files
Claude Code → custom script → Analytics
每个集成都需要自己的认证、错误处理和数据格式化。维护这些是一场噩梦。
MCP 之后
MCP 提供了一个所有工具都使用的统一协议：
Claude Code → MCP Protocol → Shopify Dev MCP Server (docs, APIs, Liquid)
→ Shopify Admin MCP Server (products, orders)
→ Analytics MCP Server (reports, metrics)
→ Custom MCP Server (your business logic)
MCP 不仅仅是为了方便。当你的 AI 助手同时拥有对 Shopify 文档、商店实时数据和代码库的访问权限时，它可以做出人类开发者需要花费数小时进行上下文切换才能完成的决策。像"查找所有具有损坏的 metafield 引用的产品并修复它们"这样的单个提示变得可能。
具体优势
- 10倍开发速度 -- 利用理解最新 API 的 AI 搭建完整的 Shopify 应用
- 更少的错误 -- AI 根据真实文档和 API 架构进行验证，而非过时的训练数据
- 商店自动化 -- 通过自然语言管理产品、订单、库存和客户
- 始终保持最新 -- MCP 服务器从实时文档中获取数据，因此你始终获得最新信息
- 可组合架构 -- 混搭服务器以满足你的精确工作流
本节的组织方式
官方 MCP 服务器
由 Shopify 和 Anthropic 维护的 Shopify Dev MCP 服务器。包含每个主要 AI 编码工具的完整设置说明、完整的工具参考和实际使用示例。
社区 MCP 服务器
精选的 15 个以上社区构建的 Shopify MCP 服务器目录。每个条目包括功能、安装方式、优缺点和维护状态。
MCP 工具参考
官方和社区服务器中每个可用 MCP 工具的完整参考。按领域（产品、订单、客户等）组织，包含参数、返回类型和示例。
MCP 设置指南
Claude Code、Cursor、Claude Desktop、Codex、Windsurf 和 Cline 的分步安装和配置指南。包括常见问题的故障排除。
MCP 集成模式
多服务器配置、CI/CD 管道、自动化商店管理和构建自己的 MCP 服务器的高级模式。
快速入门：你的第一个 MCP 连接
想要立即开始？以下是将 Claude Code 连接到 Shopify 的最快路径：
第 1 步：安装官方 Dev MCP 服务器
# In your Shopify project directory
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
第 2 步：验证连接
打开 Claude Code 并询问：
What tools do you have available from the Shopify Dev MCP server?
Claude 应该会回复一个可用工具列表，包括文档搜索、API 探索和 Liquid 验证。
第 3 步：尝试一个真实查询
Search the Shopify docs for the latest product creation API.
Show me the required fields and a GraphQL mutation example.
Dev MCP 服务器让你可以访问文档和 API 架构。要管理实际商店（创建产品、处理订单等），你需要一个 Store Admin MCP 服务器。请参阅我们的社区 MCP 服务器指南了解可用选项。
MCP 服务器概览
┌──────────────────────────────────┐
│ MCP Server Ecosystem │
└──────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Official │ │ Community │ │ Custom │
│ Servers │ │ Servers │ │ Servers │
├───────────────┤ ├───────────────┤ ├───────────────┤
│ Shopify Dev │ │ shopify-mcp │ │ Your store │
│ MCP (Docs, │ │ (GeLi2001) │ │ automation │
│ APIs, Liquid) │ │ │ │ server │
│ │ │ @ajackus/ │ │ │
│ │ │ shopify-mcp │ │ Internal │
│ │ │ │ │ tools server │
│ │ │ Composio │ │ │
│ │ │ CData, etc. │ │ Analytics │
│ │ │ │ │ pipeline │
└───────────────┘ └───────────────┘ └───────────────┘
前提条件
在深入了解 MCP 服务器之前，请确保你已具备：
- Node.js 18+ 已安装（
node --version） - 支持 MCP 的 AI 客户端（Claude Code、Cursor、Claude Desktop 等）
- Shopify 合作伙伴账户（在 partners.shopify.com 免费注册）
- 开发商店用于测试（从合作伙伴控制面板创建）
多个 MCP 服务器需要 Shopify Admin API 访问令牌来管理商店数据。切勿将这些令牌提交到版本控制中。请使用环境变量或密钥管理器。请参阅我们的设置指南了解安全配置模式。
推荐阅读顺序
如果你是 MCP 和 Shopify 开发的新手：
- 从这个概述开始（你正在这里）
- 阅读官方 MCP 服务器来设置 Dev MCP
- 按照设置指南配置你首选的 AI 客户端
- 浏览社区 MCP 服务器了解商店管理选项
- 学习集成模式了解高级工作流
- 使用工具参考作为持续参考
如果你已经有 MCP 经验，只需要具体内容，请直接跳到你需要的部分。