Shopify Multi Store

该 Codex 插件可在单个任务中维护多个 Shopify Admin 商店。每个商店有独立的别名和访问令牌，因此切换商店不会断开其他商店的连接。

要求

• 带有钥匙串访问权限的 macOS

• Node.js 20 或更高版本

• 每个商店的 Shopify Admin API 访问令牌

Related MCP server: Shopify Storefront MCP Server

安装

克隆仓库并安装其依赖项：

git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm run build

使用克隆的目录在 Codex 中安装本地插件。仓库包含 Codex 插件清单和 MCP 服务器配置。

添加商店

1. 在此插件目录中打开终端。

2. 运行此命令：

npm run configure -- add

3. 输入简短的商店别名。

4. 输入永久的 *.myshopify.com 域名。

5. 输入 Admin API 访问令牌。

6. 对每个商店重复该命令。

脚本会将每个令牌保存在 macOS 钥匙串中，服务名为 codex-shopify-multi-store。配置文件不包含任何访问令牌。

导入现有工具包

导入兼容的多商店 stores.json 文件：

npm run import-legacy -- /absolute/path/to/stores.json

导入会将每个令牌保存在 macOS 钥匙串中。它会把两个配置文件改为仅所有者可访问。当不再需要旧凭据文件时，请将其删除。

仅使用每个任务所需的 Admin API 作用域。Shopify 通过这些作用域控制可用数据。

管理商店

列出已配置的商店：

npm run configure -- list

移除一个商店及其钥匙串令牌：

npm run configure -- remove store-alias

可用工具

• shopify_list_stores 列出已连接的商店别名。

• shopify_get_shop_info 获取一个商店的身份信息。

• shopify_graphql_query 运行只读的 Admin GraphQL 查询。

• shopify_graphql_mutation 在获得明确授权后更改一个商店。

每次商店操作都需要商店别名。此要求降低了错误更改商店的风险。

安全

• 切勿提交访问令牌、OAuth 客户端密钥、.env 文件或包含凭据的 stores.json 文件。

• 仅授予预期任务所需的 Shopify Admin API 作用域。

• 在执行变更操作前确认目标商店。

• 有关报告说明，请参阅 SECURITY.md。

开发

npm ci
npm test

许可证

MIT