Shopify Multi-Store MCP
One MCP server. Every Shopify store.
Query, compare, report, and make guarded updates across Shopify stores from Claude, ChatGPT, Codex, Cursor, VS Code, and other MCP clients.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add io.github.alex-brecher-shopify-multi-store -- npx -y shopify-multi-store-mcp-server@2.2.0รันในเทอร์มินัล
{ "mcpServers": { "io.github.alex-brecher-shopify-multi-store": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Demo · Quick start · Reports · AI clients · Security
Run it locally, or host one server for your team: everyone signs in with their own Shopify staff account and connects from Claude, ChatGPT, Codex or any remote MCP client, with Shopify's own staff permissions deciding what each person can do. Guided Admin workflows, ShopifyQL reports, schema validation, and a generic action surface for any Admin mutation are included. See feature coverage and acceptance requirements. Full Shopify ChatGPT parity is not yet verified.
The demonstration uses sample stores and sample data. The server keeps each real store credential separate.
Install the server, connect your stores, and run the health check:
npm install --global shopify-multi-store-mcp-server
shopify-multi-store setup
shopify-multi-store doctor
Claude Code users can add the server with one command:
claude mcp add shopify-multi-store -- npx -y shopify-multi-store-mcp-server start
Each store gets a permanent alias and a separate secure credential. Every store operation requires that alias.
The two servers solve different problems. Use both when an agent needs Shopify reference material and access to your stores.
Shopify Dev MCP helps an agent create and examine Shopify code. This server runs the approved operation against the selected store.
shopify_report runs one read-only report across selected stores. Set report to one of these:
To search products across stores, use shopify_search with resource: "products" and stores.
Try prompts like these:
The server works in clients that support local stdio MCP servers. Agent Skills improve tool selection when the client supports them.
Add the MCP server:
claude mcp add shopify-multi-store -- npx -y shopify-multi-store-mcp-server start
Copy the included skill for personal use:
mkdir -p ~/.claude/skills/shopify-multi-store
cp skills/shopify-multi-store/SKILL.md ~/.claude/skills/shopify-multi-store/SKILL.md
Add this server to the client's MCP configuration:
{
"mcpServers": {
"shopify-multi-store": {
"command": "npx",
"args": ["-y", "shopify-multi-store-mcp-server", "start"]
}
}
}
Add this server to .vscode/mcp.json:
{
"servers": {
"shopify-multi-store": {
"type": "stdio",
"command": "npx",
"args": ["-y", "shopify-multi-store-mcp-server", "start"]
}
}
}
Use npx as the command and -y shopify-multi-store-mcp-server start as the arguments.
Copy skills/shopify-multi-store/SKILL.md into the client's skills directory when supported. Clients without skill support still get every MCP tool.
Local use on your own computer (above) is the default. Hosting is optional: whoever wants a shared server runs one, and their team connects from the AI app they already use, on any plan: Claude (personal custom connector), ChatGPT, Codex, Claude Code, Cursor, VS Code, Gemini CLI, Windsurf, or any MCP client that supports remote servers.
People sign in with their own Shopify staff account, and every call runs with that person's own Shopify permissions: Shopify decides what they can do, with no roles or policy file on the server. Shopify tokens stay on the server, encrypted. Reconnecting is at most once a day and one click for all stores. Every tool call is audited.
Two ways to host, both self-hosted by whoever wants a shared server:
shopify-multi-store serve (or the included Dockerfile) and share https://<host>/mcp.See Connect from your AI app for per-client steps, docs/HOSTED.md for setup, and docs/ACTIONS.md for per-user access and the generic action tools.
Authorization code setup uses http://127.0.0.1:3456/oauth/callback. Add it as an allowed redirect URL first.
The default authorization code scopes are read-only. Grant only the Admin API scopes required for the task.
Each store needs an alias (lowercase letters, digits and hyphens, such as main) and its permanent *.myshopify.com domain, which the store admin shows under Settings > Domains. The credential depends on how you get Admin API access. Shopify now creates new apps in the Dev Dashboard; custom apps made in the store admin keep working where they already exist.
With a Dev Dashboard app (new setups):
read_products,read_orders,read_inventory,read_locations,read_customers covers the read tools; for everything the tools can do, print the full list with node "$(npm root -g)/shopify-multi-store-mcp-server/scripts/print-scopes.mjs" --full and remove any scope your app is not approved for. For the authorization code method, also add the redirect URL http://127.0.0.1:3456/oauth/callback.shopify-multi-store oauth. Choose client-credentials if the store is in the same Shopify organization as the app, otherwise authorization-code (a browser window opens to approve). Enter the alias, the *.myshopify.com domain, the client ID and the client secret. With client credentials the server gets and refreshes tokens itself.With a custom app created in the store admin:
shpat_; Shopify shows it once).shopify-multi-store setup and enter the alias, the *.myshopify.com domain and the token.Then run shopify-multi-store doctor to check every store, and repeat for each further store. Secrets go to the operating system credential store, never to the configuration file.
shopify-multi-store list
shopify-multi-store doctor
shopify-multi-store remove store-alias
shopify-multi-store import /absolute/path/to/stores.json
The import copies credentials into the operating system credential store and preserves configured stores. Delete the old credential file after checking the import.
The server exposes 29 tools.
Read-only operations can run in parallel. Mutations stay isolated to the selected stores.
Every guided write tool defaults to dryRun: true, which returns a before/after (or would-create) preview without changing anything; pass dryRun: false, after the user authorizes the exact store and change, to apply it. The tool then reads the result back. Tags on products, orders, and customers change with addTags and removeTags; replaceTags replaces every tag and the preview lists the tags it would remove. Write results are never dropped for size: large results are trimmed, keeping status, counts, and every item that did not apply.
shopify_graphql_mutation and shopify_run_action refuse denylisted mutations and need confirm set to the mutation name for destructive ones, including mutations that are destructive only because of their arguments, such as a product status of ARCHIVED.
Three tools reach every Shopify Admin API mutation (514 in API 2026-04), including the 483 without a dedicated tool:
A denylist blocks mutations that mint credentials or change the app's own billing. Request the full scope set with node scripts/print-scopes.mjs --full. See docs/ACTIONS.md for worked examples and what no third-party app can do.
Install Shopify's official shopify skill:
shopify-multi-store install-shopify-skills
The command installs the skill for every supported agent it detects. Pass --agent <name> to select one agent, for example --agent claude-code.
The shopify skill is one skill with a routing table. Its admin topic searches Shopify documentation and validates custom Admin GraphQL operations. Its shopifyql topic covers sales, revenue, order, conversion, and trend analysis. Shopify's toolkit 2.0.0 merged the former shopify-admin and shopify-shopifyql skills into this one skill, and the toolkit's ucp skill (a shopping CLI) is not part of this install.
If Shopify renames the skill again, the command exits with status 1, prints the skills the toolkit ships, and shows the npx skills add command to install one by name. It never reports success after installing nothing.
This server still controls store selection, credentials, execution, and mutation authorization. Shopify's skill scripts send usage telemetry by default.
Set OPT_OUT_INSTRUMENTATION=true to turn off that telemetry.
This integration uses the official Shopify AI Toolkit. It also reflects useful patterns from Shopify Admin Skills.
Secrets never enter the main configuration file.
The configuration stores aliases, domains, API versions, and non-secret OAuth client IDs. Its default path is ~/.config/codex-shopify-multi-store/stores.json.
The codex-shopify-multi-store name, in that path and as the credential store's service name, is a legacy name from the project's first version. It stays so existing installs keep their stores and credentials; it does not mean the server works only with Codex.
Set SHOPIFY_MULTI_STORE_CONFIG to use another configuration path.
.env files, or credential-bearing configuration files.Linux credential storage requires a Secret Service provider, such as GNOME Keyring or KWallet.
Run a health check without a global install:
npx -y shopify-multi-store-mcp-server doctor
Install directly from GitHub (npm runs the prepare script, which builds the server):
npm install --global github:alex-brecher/shopify-multi-store
git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm test
npm run test:live
npm pack --dry-run
The live test uses configured stores and performs read-only Shopify Admin API calls.
MIT
Read the changelog, contribution guide, security policy, and directory submission guide.
Connect AI agents to multiple Shopify Admin stores for reports, comparisons, and guarded updates.
{ "mcpServers": { "io.github.alex-brecher-shopify-multi-store": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Shopify Multi Store ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-16 Connect AI agents to multiple Shopify Admin stores for reports, comparisons, and guarded updates.