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 範例 |
|---|---|---|
| 工具(Tools) | AI 可以執行的動作 | create_product、update_inventory、search_orders |
| 資源(Resources) | 唯讀資料來源 | 產品目錄、訂單歷史、顧客區段 |
| 提示詞(Prompts) | 可重複使用的提示詞範本 | 商店稽核清單、SEO 最佳化工作流程 |
| 傳輸方式(Transports) | 通訊通道 | 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 schema 進行驗證,而非過時的訓練資料
- 商店自動化 —— 透過自然語言管理產品、訂單、庫存和顧客
- 始終保持最新 —— 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 schema。要管理即時商店(建立產品、處理訂單等),您需要一個 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 Partner 帳號(在 partners.shopify.com 免費註冊)
- 開發商店 用於測試(從您的 Partner 儀表板建立)
多個 MCP 伺服器需要 Shopify Admin API 存取權杖來管理商店資料。切勿將這些權杖提交到版本控制。請使用環境變數或密鑰管理工具。請參閱我們的設定指南以了解安全的設定模式。
建議閱讀順序
如果您是 MCP 和 Shopify 開發的新手:
- 從此概覽開始(您在這裡)
- 閱讀官方 MCP 伺服器以設定 Dev MCP
- 依照您偏好的 AI 客戶端的設定指南操作
- 瀏覽社群 MCP 伺服器以了解商店管理
- 研讀整合模式以了解進階工作流程
- 使用工具參考作為持續參考
如果您已有 MCP 經驗且只需要特定資訊,可以直接跳至您需要的章節。