Skip to main content

Shopify Dev MCP 伺服器

Shopify Dev MCP 伺服器（@anthropic-ai/shopify-dev-mcp）是由 Shopify 和 Anthropic 合作建構的官方 MCP 伺服器。它讓 AI 編碼工具直接存取 Shopify 的開發人員文件、GraphQL Admin API 結構、佈景主題驗證等。這是對 Shopify 開發影響最大的單一 MCP 伺服器。

它提供什麼​

Shopify Dev MCP 伺服器不連接到您的商店。相反，它提供開發智慧——AI 撰寫正確 Shopify 程式碼所需的知識：

  • GraphQL 結構內省：查詢 Admin API 結構以發現類型、欄位、變更操作及其確切簽名
  • 開發者文件搜尋：搜尋 Shopify 官方文件並檢索相關文章
  • 入門指南：存取各種 Shopify 開發路徑的結構化新手引導內容
  • 佈景主題驗證：對您的佈景主題檔案執行 Shopify Theme Check
  • 結帳擴充性工具：存取結帳特定的文件和模式
不需要商店存取

此伺服器不需要 Shopify 存取權杖或商店憑證。它提供開發者知識，而非商店資料。要進行商店資料操作（商品、訂單等的 CRUD），您需要下一節介紹的社群 MCP 伺服器。

安裝​

Claude Code​

建議的安裝方式是在使用者範圍註冊伺服器，使其在所有專案中可用：

為 Claude Code 安裝（全域）
claude mcp add shopify-dev-mcp -s user -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest

僅為特定專案安裝：

為特定專案安裝
claude mcp add shopify-dev-mcp -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest

驗證安裝：

驗證 MCP 伺服器
claude mcp list

Cursor​

添加到您的 Cursor MCP 設定：

.cursor/mcp.json
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}

Claude Desktop​

添加到您的 Claude Desktop 設定檔：

claude_desktop_config.json
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}

設定檔位置因作業系統而異：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json
始終使用 @latest

@latest 標籤確保您取得包含最新文件和結構資料的最新版本。Shopify 的 API 每季度發布時都會演進，MCP 伺服器也會相應更新。

可用工具​

introspect_admin_schema​

伺服器中最強大的工具。它讓您查詢 Shopify 的 GraphQL Admin API 結構，以發現類型、欄位、引數及其確切簽名。

search_dev_docs​

搜尋 Shopify 的官方開發者文件並回傳相關文章、指南和 API 參考。

get_started​

提供不同 Shopify 開發路徑的結構化入門內容。

validate_theme​

對您的佈景主題檔案執行 Shopify Theme Check，識別 Liquid 程式碼問題、效能問題和最佳實務違規。

結合 Claude Code 的檔案存取

Claude Code 可以在單一工作流程中讀取您的佈景主題檔案並透過 MCP 驗證它們。要求它「修復所有佈景主題驗證錯誤」，它會驗證、識別問題、編輯檔案並重新驗證——全部自主進行。

常見工作流程​

工作流程 1：撰寫新的 GraphQL 查詢​

逐步
1. 「內省 Admin API 結構中的 OrderConnection 類型」
2. 「orders 查詢上有哪些可用的篩選器？」
3. 「撰寫一個分頁查詢來擷取最近 7 天出貨狀態為 UNFULFILLED 的訂單」

工作流程 2：建構佈景主題區段​

逐步
1. 「搜尋 OS 2.0 中區段結構最佳實務的文件」
2. 「驗證目前的佈景主題是否有任何現存問題」
3. 「按照文件中的模式建立新的見證區段」
4. 「再次驗證佈景主題以確保沒有新問題」

疑難排解​

伺服器無法啟動​

除錯 MCP 伺服器啟動
# 直接測試伺服器
npx -y @anthropic-ai/shopify-dev-mcp@latest

# 檢查 npm/Node 問題
node --version  # 必須是 18+
npm --version

工具未出現​

重新註冊伺服器
claude mcp remove shopify-dev-mcp
claude mcp add shopify-dev-mcp -s user -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest
claude
需要網路

Shopify Dev MCP 伺服器需要網路存取以擷取文件和結構資料。它在離線或隔離環境中無法運作。

下一步​

Shopify Dev MCP 伺服器提供開發知識。要對您的 Shopify 商店執行實際操作（建立商品、管理訂單等），您需要連接商店的 MCP 伺服器。前往 Shopify Store MCP 伺服器 設定商店資料存取。