mcp shopify开发

模型上下文协议（MCP）服务器，通过管理GraphQL API将Claude（或任何兼容MCP的客户端）直接连接到您的Shopify商店。

通过自然语言管理您的整个商店——产品、库存、收藏、媒体和文件——所有这些都来自克劳德。

______________________________________________________________________

快速开始

claude mcp add shopify-dev \
  -e SHOPIFY_SHOP=your-store-name \
  -e SHOPIFY_CLIENT_ID=your_client_id \
  -e SHOPIFY_CLIENT_SECRET=your_client_secret \
  npx -y mcp-shopify-dev

就是这样。无需安装，无需构建步骤，只需使用以下命令运行即可 npx.

为什么 -e 旗帜？ 通过传递秘密 -e 将它们存储在Claude的MCP配置中，而不是在shell历史记录或进程列表中公开它们。

______________________________________________________________________

特性

类别	工具	功能
产品	8	创建、读取、更新、删除产品；管理变体和选项
集合	2	列出所有收藏；获取一个包含其产品的集合
折扣和价格规则	6	创建、阅读、更新、停用折扣和检查使用情况
分析和报告	5	检索店铺信息、销售报告、畅销产品、库存报告和整体仪表板
订单	5	提取、更新和取消订单；创建实现
库存	3	按位置获取库存项目和级别；设定库存数量
媒体	3	更新/删除产品介质；压缩图像
主题	5	列出主题、浏览主题文件、查看代码、更新资产和生成Liquid部分
文件	2	浏览Shopify文件部分；重命名文件或更新alt文本
人工智能	1	使用Claude的视觉为产品图片生成SEO替代文本

______________________________________________________________________

工具参考

产品

工具	说明
`create-product`	创建具有变体和选项的新产品
`get-products`	按标题、类型或日期范围列出或搜索产品
`get-product-by-id`	按ID获取包含完整详细信息的单个产品
`update-product`	更新产品字段（标题、描述、状态、标签等）
`delete-product`	永久删除产品
`manage-product-variants`	创建或更新产品变体和价格
`delete-product-variants`	从产品中删除一个或多个变体
`manage-product-options`	添加、更新、重新排序或删除产品选项（尺寸、颜色等）

集合

工具	说明
`get-collections`	列出所有带分页的集合
`get-collection-by-id`	获取单个收藏及其产品

折扣和价格规则

工具	说明
`get-discount-codes`	列出活动折扣代码及其状态、使用限制和汇总规则。
`create-discount-code`	创建促销代码（百分比、固定金额、免费送货）。
`update-discount-code`	更新现有折扣码的基本设置（标题、日期、使用限制）。
`deactivate-discount`	停用活动折扣码或自动折扣。
`create-automatic-discount`	创建自动折扣（百分比或固定金额）。
`get-discount-usage`	检查代码/折扣被使用了多少次。

分析和报告

工具	说明
`get-shop-info`	获取有关商店的一般信息：名称、计划、货币、时区等。
`get-sales-report`	为某个日期范围（收入、订单数、AOV、税款、运费）生成销售报告。
`get-top-products`	按给定日期范围内的收入或销售单位对产品进行排名。
`get-inventory-report`	存储所有产品变体的低库存和缺货报告。
`get-analytics-dashboard`	关键绩效指标概述：当前与上期收入、AOV、增长、未完成订单和低库存。

订单

工具	说明
`get-orders`	按状态、日期范围、客户电子邮件或标签列出具有高级过滤功能的订单。
`get-order-by-id`	通过ID获取单个订单的完整详细信息，包括行项目和履行情况。
`update-order`	更新订单的标签、内部注释、客户电子邮件、送货地址或自定义属性。
`cancel-order`	取消订单。需要一个理由，以及退款和补货的选项。
`create-fulfillment`	按订单ID完成订单（或特定行项目）

库存

工具	说明
`get-inventory-items`	列出产品的库存项目
`get-inventory-levels`	获取每个位置的库存水平
`inventory-set-quantities`	在特定位置设置可用或现有数量

媒体

工具	说明
`update-product-media`	更新产品图像上的alt文本
`delete-product-media`	从产品中删除未使用或旧的介质
`compress-product-media`	压缩产品图像，重新上传，并可选择替换原始图像——返回文件大小节省报告

主题

工具	说明
`get-themes`	列出商店中的所有主题，包括它们的ID和角色（MAIN、DEVELOPMENT）。
`get-theme-files`	列出主题中的文件，可选择按前缀过滤。
`get-theme-file-content`	阅读单个主题文件的完整源代码（Liquid、JSON、CSS、JS）。
`upsert-theme-file`	在Shopify主题（Liquid、代码片段、CSS、JSON）中创建或覆盖文件。
`generate-liquid-section`	从结构化规范生成一个完整的、准备上传的Shopify Liquid部分文件

文件

工具	说明
`get-files`	在Content中浏览和搜索文件→ 文件
`update-file`	重命名文件和/或更新任何上传文件上的alt文本

人工智能

工具	说明
`generate-alt-text-ai`	将产品图像流式传输到Claude的视觉上下文中以生成SEO alt文本-不需要额外的API密钥

效用

工具	说明
`example-hello-world`	验证MCP连接的测试工具

______________________________________________________________________

先决条件

Node.js 18+
A. Shopify商店 使用自定义应用程序（任何计划）
克劳德代码 或任何MCP兼容客户端

______________________________________________________________________

设置

1.创建Shopify自定义应用程序

转到您的Shopify管理员→ 设置→ Apps → 开发应用程序→ 创建一个应用.

根据授予以下API作用域配置:

作用域	由使用
`read_products`, `write_products`	所有产品、变体和媒体工具
`read_orders`, `write_orders`	订单、履行和销售报告工具
`read_themes`, `write_themes`	主题文件和章节生成工具
`read_discounts`, `write_discounts`	折扣和价格规则工具
`read_inventory`, `write_inventory`	库存工具
`read_analytics`	分析仪表板和报告
`read_files`, `write_files`	`get-files`, `update-file`

安装应用程序并复制您的 API密钥 和 API密钥.

2.用克劳德代码注册

claude mcp add shopify-dev \
  -e SHOPIFY_SHOP=your-store-name \
  -e SHOPIFY_CLIENT_ID=your_client_id \
  -e SHOPIFY_CLIENT_SECRET=your_client_secret \
  npx -y mcp-shopify-dev

如果使用静态访问令牌而不是客户端凭据授予：

claude mcp add shopify-dev \
  -e SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
  -e SHOPIFY_ACCESS_TOKEN=shpat_... \
  npx -y mcp-shopify-dev

验证注册：

claude mcp list

3.使用它

注册后，自然地与克劳德交谈。以下是按范围显示的示例提示：

产品

“使用shopify dev列出我所有的活动产品” “使用shopify-dev创建一款名为‘夏日T恤’的新产品，S、M、L尺码为29.99美元” “使用shopify dev更新产品ID 12345的描述和标签” “使用shopify dev以34.99美元的价格在产品ID 12345中添加新的变体'XL/Black'” “使用shopify dev删除所有超过30天的草稿产品”

集合

“使用shopify dev列出我的所有收藏” “使用shopify dev获取收藏ID 67890，并向我展示其所有产品”

分析和报告

“使用shopify dev向我展示本周与上周的分析仪表板” “使用shopify dev给我一份按天分组的过去30天的销售报告” “使用shopify dev查找我本月最畅销的10款产品” “使用shopify dev运行库存报告，并向我显示所有库存不足的商品”

订单

“使用shopify dev列出我最近10个未完成的订单” “使用shopify dev获取订单ID 12345” “使用shopify dev为订单ID 12345添加标签'Vip'和内部注释” “使用shopify dev取消订单ID 12345并向客户退款” “使用shopify dev完成订单ID 12345，并添加联邦快递跟踪号'1Z99999'”

库存

“使用shopify dev检查我主位置所有产品的库存水平” “使用shopify dev将产品ID 12345的库存设置为位置ID 99处的50个单位” “使用shopify dev查找所有库存为0的产品”

媒体

“使用shopify-dev压缩产品ID 12345上的所有图像并替换原始图像” “使用shopify dev删除产品ID 12345中除第一张图像外的所有媒体” “使用shopify dev将图像ID 67上的alt文本更新为‘白色棉质夏季t恤’”

主题

“使用shopify dev列出所有主题” “使用shopify-dev查找我的主题的‘sections’目录中的所有文件” “使用shopify dev读取layout/theme.liquid的内容” “使用shopify-dev生成一个新的FAQ Liquid部分，并将其上传到我的开发主题中”

文件

“使用shopify-dev列出我的shopify文件部分中的所有文件” “使用shopify-dev将文件ID 88重命名为‘banner-summer-2026’” “使用shopify-dev将文件ID 88的alt文本更新为‘2026年夏季横幅’”

AI——Alt文本生成

“使用shopify dev获取我的第一个产品，获取其第一个图像URL，使用AI生成SEO alt文本，然后将其保存回商店” “使用shopify dev为此图像URL生成alt文本：https://cdn.shopify.com/..."

______________________________________________________________________

发展

克隆仓库并安装依赖项：

git clone https://github.com/YOUR_USERNAME/mcp-shopify-dev.git
cd mcp-shopify-dev
npm install
npm run build

从项目目录本地运行：

claude mcp add shopify-dev \
  -e SHOPIFY_SHOP=your-store-name \
  -e SHOPIFY_CLIENT_ID=your_client_id \
  -e SHOPIFY_CLIENT_SECRET=your_client_secret \
  node "./dist/index.js"

命令

npm run dev      # run with ts-node (no build step)
npm run build    # compile TypeScript → dist/
npm start        # run compiled output from dist/

使用MCP检查员进行测试

直接调用工具的可视化UI——不需要LLM：

SHOPIFY_SHOP=your-store-name \
SHOPIFY_CLIENT_ID=your_client_id \
SHOPIFY_CLIENT_SECRET=your_client_secret \
npx @modelcontextprotocol/inspector node "./dist/index.js"

开放时间： http://localhost:5173 --选择任何工具，填写输入，并检查原始JSON响应。

添加新工具

每个工具都是一个文件 src/tools/.遵循以下模式：

import { z } from "zod";
import { gql } from "graphql-request";
import type { GraphQLClient } from "graphql-request";
import type { ShopifyTool } from "../lib/types.js";
import { checkUserErrors, handleToolError } from "../lib/toolUtils.js";

const MySchema = z.object({
  // define inputs here
});

let shopifyClient: GraphQLClient;

export const myTool: ShopifyTool = {
  name: "my-tool",
  description: "What this tool does",
  schema: MySchema,
  initialize(client) { shopifyClient = client; },
  execute: async (input) => {
    try {
      const data = await shopifyClient.request(gql`...`, { ...input });
      checkUserErrors(data.someMutation.userErrors, "my operation");
      return { /* result */ };
    } catch (error) {
      handleToolError("my operation", error);
    }
  },
};

然后导入并添加到 tools 数组in src/tools/registry.ts.

______________________________________________________________________

技术栈

依赖性	目的
`@modelcontextprotocol/sdk`	MCP服务器框架
`graphql-request`	Shopify Admin API的GraphQL客户端
`zod`	输入验证和模式生成
`sharp`	图像压缩
`dotenv`	环境变量加载

______________________________________________________________________

故障排除

“您必须提供访问令牌…或同时提供客户端ID和密码” 通过 --access-token （或 --api-key 和 --secret-key)作为CLI标志，或设置 SHOPIFY_CLIENT_ID 和 SHOPIFY_CLIENT_SECRET （或 SHOPIFY_ACCESS_TOKEN)在您的环境中。

MCP服务器已连接，但工具未返回任何内容 跑 npm run build 再次进行更改后，服务器从运行 dist/.

图像压缩失败 确保 sharp 本机依赖项安装正确。在Windows上：

npm rebuild sharp

调试输出出现在响应中 所有调试日志记录都将转到 stderr。如果您在工具输出中看到它，则可能是客户端配置错误。

MCP Shopify Dev

快速接入

详细介绍

mcp shopify开发

快速开始

特性

工具参考

产品

集合

折扣和价格规则

分析和报告

订单

库存

媒体

主题

文件

人工智能

效用

先决条件

设置

1.创建Shopify自定义应用程序

2.用克劳德代码注册

3.使用它

发展

命令

使用MCP检查员进行测试

添加新工具

技术栈

故障排除

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP