Shopify Dev MCP Server 是 Shopify 在 2026 年 Winter Edition 中全面升級的 AI 開發基礎設施,讓開發者透過 Claude Code、Cursor、Gemini CLI 等 AI 工具直接存取 Shopify 的文件、API schema 和開發資源。 截至 2026 年 3 月,Shopify 的 MCP 生態系已從單一的開發輔助工具,擴展成涵蓋 Dev MCP、Storefront MCP、Customer Account MCP、Checkout MCP 四層架構的完整 Agentic Commerce 技術棧。搭配 Google 共同開發的 Universal Commerce Protocol(UCP),Shopify 正在把自己從「開店平台」重新定位為「AI 商務基礎設施提供者」。
這篇文章是寫給正在評估 Shopify MCP 導入策略的 CTO 和技術創辦人的。我會拆解每一層 MCP server 的功能、設定方式、安全架構,以及 MCP 跟 UCP 之間的關係。

Shopify MCP 生態系的四層架構
Shopify 這幾年陸續推出了四個官方 MCP server,各自對應不同的使用情境。理解這四層的定位差異,是做技術決策的前提。
| MCP Server | 用途 | 認證需求 | 目標使用者 |
|---|---|---|---|
| Dev MCP | 搜尋 Shopify 文件、introspect API schema、生成 validated code | 不需認證,本機執行 | 開發者(透過 Claude Code / Cursor) |
| Storefront MCP | 商品搜尋、購物車管理、結帳引導 | 不需認證(公開存取) | AI 購物助手、消費端 agent |
| Customer Account MCP | 訂單查詢、退貨管理、帳戶資訊 | OAuth 2.0 + PKCE | 需身份驗證的客服 agent |
| Checkout MCP | 建立結帳、更新結帳、完成付款 | UCP agent profile 必填 | 合作夥伴限定(preview) |
Dev MCP 是開發階段的工具,跑在本機,不碰線上資料。Storefront MCP 跟 Customer Account MCP 是生產環境的 agent 端點,直接跟商店互動。Checkout MCP 目前還在 preview 階段,只開放給特定合作夥伴。
Dev MCP Server:把 AI 編程助手接上 Shopify 平台知識
Dev MCP 解決的是一個很具體的問題:AI 編程工具在寫 Shopify 程式碼時,常常產出過時或語法錯誤的結果,因為它們的訓練資料不一定涵蓋最新的 API 版本。
Dev MCP 的運作方式是在本機啟動一個 MCP server,讓 Claude Code 或 Cursor 可以即時查詢 shopify.dev 的文件、introspect GraphQL Admin API schema、驗證 Liquid 主題程式碼。
支援的 API 範圍
Dev MCP 目前覆蓋的 Shopify API 包括:Admin GraphQL API、Shopify Functions、Hydrogen(Shopify 的 React-based headless 框架)、Storefront Web Components,以及 POS UI extensions。Shopify VP of Product Eytan Seidman 在 Winter '26 Edition 發表時說,他們已經把 Dev MCP 的覆蓋範圍擴展到整個平台。
Claude Code 設定方式
在 Claude Code 裡加入 Dev MCP 只要一行指令:
claude mcp add --scope user shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
重啟 Claude Code 之後,就能直接問類似「幫我寫一個 POS UI extension 顯示訂單裡所有產品的 SKU」這種問題,Claude Code 會自動透過 MCP server 搜尋最新文件來生成 validated code。
如果要關掉 Shopify 的匿名使用統計回傳,可以加上環境變數:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"],
"env": {
"OPT_OUT_INSTRUMENTATION": "true"
}
}
}
}
進階功能:Liquid 主題驗證
Dev MCP 有兩種 Liquid 驗證模式。full 模式(預設)可以驗證整個主題目錄,用 Shopify 的 Theme Check 掃描 Liquid 語法錯誤和跨檔案的 reference 問題。partial 模式則只驗證單一程式碼片段,適合不需要完整主題上下文的場景。如果你需要 Polaris Web Components 的文件,要額外在環境變數加上 POLARIS_UNIFIED=true。
Storefront MCP:讓 AI Agent 幫消費者購物
Storefront MCP 是面向消費者的 MCP server,每家 Shopify 商店都有自己的端點:
https://{shop}.myshopify.com/mcp
這個端點不需要認證就能存取,AI agent 可以直接連上來搜尋商品目錄、管理購物車、查詢商店政策。
Storefront MCP 提供的工具包括:商品目錄搜尋(自然語言查詢)、購物車操作(建立、新增、移除商品、完成結帳)、商店資訊查詢(退貨政策、運費、FAQ)。搭配 Shopify 的 Chat UI theme extension,開發者可以在商店前台嵌入 AI 聊天泡泡,直接跑完從商品探索到結帳的流程。
這個架構的設計思路是把 MCP client(你的 Shopify app 後端)跟 Chat UI(前端 theme extension)分開。後端負責跟 AI model 溝通並轉發請求到 MCP server,前端負責呈現聊天介面。這意味著你可以接上任何 AI model,不用自己寫 Shopify API 的整合邏輯。


Customer Account MCP:處理需要身份驗證的客服場景
Customer Account MCP 跟 Storefront MCP 最大的差異是認證機制。它要求 OAuth 2.0 + PKCE(Proof Key for Code Exchange),因為涉及的是個人訂單紀錄、帳戶資訊這類敏感資料。
設定步驟比較複雜。你的 app 要先在 TOML 設定檔裡配好 customer authentication redirect URI,然後透過 /.well-known/openid-configuration 端點做 OAuth discovery,取得 authorization endpoint 跟 token endpoint。使用者授權後,你用 authorization code + code verifier 換 access token,之後每次對 Customer Account MCP 的請求都帶這個 token。
Customer Account MCP 提供的工具包括:訂單狀態查詢、訂單明細、退貨管理、帳戶偏好設定。錯誤處理上,它有一致的模式:驗證錯誤回傳具體的錯誤訊息,處理錯誤回傳通用的重試提示,資源找不到就回傳明確的 not found 訊息。
商店必須有自訂網域(custom domain)才能用 Customer Account MCP,而且 app 要符合 Shopify 的 protected customer data requirements。
Checkout MCP:Agentic Commerce 的最後一哩
Checkout MCP 目前還在 preview 階段,只開放給特定合作夥伴。它的設計目標是讓 AI agent 在不需要人類介入的情況下完成整個結帳流程。
Checkout MCP 的工具組包括五個核心操作:create_checkout(建立結帳 session)、get_checkout(查詢結帳狀態)、update_checkout(更新結帳資訊)、complete_checkout(提交付款)、cancel_checkout(取消結帳)。
值得注意的是,Checkout MCP 的 request metadata 裡要求包含 ucp-agent.profile,指向你的 agent 的 UCP profile URI。這代表 Checkout MCP 已經跟 UCP 規格綁在一起了,不是獨立運作的。
UCP 的版本號是 2026-01-23(截至 Winter '26 Edition),checkout schema 定義在 https://ucp.dev/services/shopping/openrpc.json。結帳 session 的 response 會包含 continue_url,讓需要人類介入的場景(比如選擇配送時段)可以把使用者導到結帳頁面。
MCP vs UCP:兩個協議的定位差異
MCP 和 UCP 是互補的,不是競爭關係。CTO 做技術決策時要搞清楚這個分工。
| 維度 | MCP (Model Context Protocol) | UCP (Universal Commerce Protocol) |
|---|---|---|
| 開發者 | Anthropic | Google + Shopify 共同開發 |
| 定位 | 通用:連接 AI model 和任何資料來源 | 商務專用:標準化端到端購物流程 |
| 支持者 | 跨產業(開發工具、SaaS、商務) | 20+ 零售和支付夥伴(Visa、Mastercard、Stripe、Walmart、Target) |
| 傳輸層 | STDIO(本機)、HTTP+SSE(遠端) | REST、GraphQL、JSON-RPC、A2A、MCP |
| 認證 | 依 server 實作而定 | OAuth 2.0 + Agent Payments Protocol (AP2) |
| 核心能力 | 結構化的工具呼叫和上下文傳遞 | Checkout、Identity Linking、Order Management、Catalog Discovery |
UCP 是在 2026 年 1 月 11 日的 NRF(National Retail Federation)大會上正式發布的,Google CEO Sundar Pichai 跟 Shopify 同台宣布。UCP 的設計架構讓它可以在不同傳輸層上運作,MCP 就是其中一種。
實際運作上,Shopify 的 Checkout MCP server 就是 UCP 的 MCP 傳輸實作。agent 透過 MCP 的工具呼叫格式跟 Checkout server 溝通,但底層走的是 UCP 定義的 checkout session lifecycle。
Google VP/GM of Merchant Shopping Ashish Gupta 說得很直接:agentic commerce 需要一套跨生態系統的共通語言,UCP 提供的就是這個框架。
Shopify Catalog API:跨商店的商品搜尋基礎設施
Shopify Catalog API 是 Agentic Commerce 技術棧裡的另一個關鍵元件。它讓 AI agent 可以在 Shopify 整個商務圖譜上搜尋商品,不限單一商店。
Catalog API 在 Summer '25 Edition 時是特定合作夥伴限定,到了 Winter '26 Edition 已經開放給所有使用 MCP 工具或 REST API 的開發者。Shopify 用從數百萬商家和商品累積的信號來結構化資料,自動推斷商品類別、抽取屬性、合併重複商品,讓 AI agent 搜到的結果是整理過的。
對開發者來說,Catalog API 搭配 Checkout Kit(Shopify 的結帳嵌入工具)就能在 agent 體驗裡跑完從商品探索到結帳的完整流程。Checkout Kit 支援 web(JavaScript library)、iOS(Swift)、Android、React Native,可以在任何網頁上 render 商家的結帳頁面。
Dev Dashboard:Agentic Commerce 的開發沙箱
Dev Dashboard 是 Shopify 新推出的開發者工作空間,專門用來建構和測試 AI 購物體驗。從 2026 年 1 月 1 日起,新的 Shopify app 都在 Dev Dashboard 裡建立,使用 OAuth client credentials 取代靜態 access token(舊的 shpat_ token 仍可繼續使用)。
Dev Dashboard 裡整合了 Shopify Catalog(商品搜尋)和 Checkout Kit(結帳轉換),開發者可以直接在裡面原型化一個 AI 購物助手、測試、然後拿到一個 personalized endpoint 部署到正式環境。
第三方 MCP Server:社群生態
除了 Shopify 官方的 MCP server,社群也發展出多個第三方方案。
GeLi2001/shopify-mcp 是目前最活躍的開源 Shopify MCP server,直接透過 GraphQL Admin API 跟商店互動。它提供 Product(8 個工具)、Customer(8 個工具)、Order(10 個工具)、Metafield(3 個工具)、Inventory(1 個工具)、Tag(1 個工具)的完整 CRUD 操作。API 版本預設是 2026-01,支援 cursor-based pagination 和 Shopify query syntax 的進階過濾。
在 Claude Code 裡的設定方式:
claude mcp add shopify -- npx shopify-mcp \
--clientId YOUR_CLIENT_ID \
--clientSecret YOUR_CLIENT_SECRET \
--domain your-store.myshopify.com
Composio 的 Tool Router 提供另一種做法:一個 universal MCP endpoint 動態載入 Shopify 和其他 SaaS app 的工具。好處是你不用為每個 app 各跑一個 MCP server,但多了一層中介。
CTO 的技術決策框架
根據你的團隊規模和業務需求,Shopify MCP 的導入可以分成三個階段。
第一階段:開發加速(0-2 週)
把 Dev MCP 接上團隊的 AI 編程工具。投資是零(Dev MCP 不需認證、不需付費),但可以讓 Shopify 開發效率提升 30-50%,因為 AI 助手能即時查到最新的 API 文件和 schema。
第二階段:AI 購物助手(2-8 週)
用 Storefront MCP 在商店前台建一個 AI 聊天助手。需要的基礎建設:一個 MCP client(你的 app 後端)、一個 AI model API(Claude、GPT-4o 等)、Chat UI theme extension。如果你賣的商品需要導購(比如選配件、選尺寸),AI 助手的 ROI 會比較明顯。
第三階段:Agentic Commerce 全通路(8-16 週)
把 Shopify Catalog 開起來,讓商品在 ChatGPT、Perplexity、Microsoft Copilot、Google AI Mode 裡被搜尋到。這需要確保商品資料品質夠高:所有變體都有 unique SKU、庫存即時同步、屬性名稱一致。然後啟用 Agentic Storefronts,在 Shopify Admin 裡一鍵開關不同 AI 平台的銷售通路。
安全和治理考量
MCP 生態系的安全架構是 CTO 的必考題。幾個需要注意的面向:
Tool-Level Scoping:對外部 agent 做工具層級的權限控管。不受信任的 agent 可能可以搜尋商品目錄,但不能存取客戶歷史紀錄。
Rate Limiting:MCP server 必須能辨識和阻擋偽裝成購物 agent 的爬蟲,保護定價和庫存資料。
資料主權:Customer Account MCP 的 OAuth 2.0 + PKCE 確保 PII 只在使用者授權後才被存取。Checkout MCP 要求 agent 提供 UCP profile,讓商家可以追蹤和審計每一次互動。
2026 年 1 月 1 日起的新 app 使用 OAuth client credentials,token 有效期約 24 小時會自動 refresh,比舊的靜態 shpat_ token 安全得多。
Agentic Storefronts:商家端的入口
從商家的角度,Agentic Storefronts 是進入 MCP 生態系最簡單的方式。在 Shopify Admin 裡開啟 Agentic Storefronts 後,Shopify Catalog 會自動把你的商品資料結構化,同步到 ChatGPT、Perplexity、Microsoft Copilot 等 AI 平台。商家可以逐一開關不同平台。
訂單會帶著 AI 通路歸因流回 Shopify Admin,你可以看到哪些訂單來自哪個 AI 平台,以及消費者在 AI 對話中搜尋了什麼。
Shopify CEO Tobi Lütke 的說法是:他們要讓每家 Shopify 商店預設就是 agent-ready 的。
Scripts → Functions 遷移:2026 年 6 月截止
跟 MCP 同步推進的是 Shopify Functions 全面取代 Scripts 的時程。2026 年 6 月後,Scripts 將不再支援。Functions 提供更快的執行速度和更高的 API parity。如果你的商店還在用 Scripts 做自訂結帳邏輯,現在就要開始規劃遷移,測試所有自訂邏輯在 Functions 裡的表現。
Shopify 的 MCP 生態對 CTO 意味著什麼?
Shopify 正在從「你在上面開店」的平台,轉型成「你的商品在所有 AI 對話裡被找到和購買」的基礎設施。MCP 是連接 AI model 和商務資料的通道,UCP 是標準化跨平台交易的協議,Catalog API 是讓商品被全球 AI agent 搜尋到的索引。
對正在做技術架構決策的 CTO 來說,2026 年的關鍵問題不是「要不要接 MCP」,而是接了之後怎麼確保資料品質、怎麼做權限控管、怎麼量化 AI 通路的 ROI。
常見問題
Shopify Dev MCP Server 跟 Storefront MCP Server 有什麼差別?
Dev MCP 是開發者工具,跑在本機、不需認證,用途是讓 Claude Code 或 Cursor 存取 Shopify 文件和 API schema 來生成正確的程式碼。Storefront MCP 是生產環境的 agent 端點,讓 AI 購物助手搜尋商品、管理購物車、完成結帳。兩者不互相取代。
導入 Shopify MCP 需要多少開發資源?
Dev MCP 只要一行指令就能設好。Storefront MCP 的基本整合大約需要 2-4 週的開發工作(含 MCP client 後端和 Chat UI 前端)。Customer Account MCP 因為有 OAuth 2.0 + PKCE 認證流程,大約多加 1-2 週。Checkout MCP 目前是 preview,還不開放一般開發者。
UCP 跟 MCP 要選哪一個?
不用選,它們是互補的。MCP 定義 AI model 和資料來源之間的通訊格式,UCP 定義商務交易的業務邏輯。Shopify 的 Checkout MCP server 就是 UCP 透過 MCP 傳輸層的實作。
Shopify Agentic Storefronts 適合什麼規模的商家?
任何 Shopify 商家都可以啟用。Shopify 的 Catalog 會自動結構化你的商品資料。但如果你的商品資料品質不好(缺 SKU、屬性不一致、庫存不即時),AI agent 搜尋到的結果會不準確。建議先做一輪商品資料清理再啟用。
2026 年有哪些 AI 購物平台已經整合 Shopify?
截至 2026 年 3 月,ChatGPT、Perplexity、Microsoft Copilot 已經上線。Google AI Mode 和 Gemini app 裡的原生購物體驗即將推出,透過 UCP 整合。Shopify 在 Admin 裡提供逐一開關每個平台的控制。
引用來源
- Shopify Dev MCP Server 官方文件
- Shopify Winter '26 Edition 開發者公告
- Shopify Agentic Storefronts
- Universal Commerce Protocol (UCP) 官方網站
- Google Developers Blog — Under the Hood: Universal Commerce Protocol
- 2026 年找 Shopify 專家要花多少錢?外包、Agency 費用與 AI 開發全攻略
- Shopify 2026 開發者大會震撼登場!Winter '26 Editions 最狂更新一次看
- Webflow + Shopify 最強合體術!打造設計感爆棚的電商網站
- 🚀 Shopify CLI 神器!開發效率狂飆3倍,本地開發零痛點全攻略!
- Shopify 鑽戒電商網站完整架設指南:從選戒台到結帳的專業解決方案
- Shopify MCP 完整攻略:Cursor 開發者的終極指南
- 電商成功關鍵:建立完美技術堆疊終極指南
作者
Erik (EKC) 是 Tenten.co 的 Digital Strategy Director。在過去一年裡,我們協助超過 15 家台灣和亞太地區的品牌規劃 Shopify 技術架構,從 headless 建置到 MCP 整合評估。我個人的觀察是:多數品牌的瓶頸不在 MCP 的技術設定,而在商品資料的結構化程度。AI agent 非常字面化地理解你的商品資料,屬性不一致、缺少 metafield、SKU 重複這些問題,在傳統電商裡只是管理不便,在 agentic commerce 裡直接導致商品搜不到或搜到錯的結果。如果你正在評估 Shopify MCP 或 Agentic Commerce 的導入策略,歡迎跟 Tenten 團隊預約諮詢。
