Shopify Admin MCP
English | Русский
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
SHOPIFY_STORE_DOMAIN=<value> SHOPIFY_ACCESS_TOKEN=<secret> SHOPIFY_CLIENT_ID=<value> SHOPIFY_CLIENT_SECRET=<secret> SHOPIFY_API_VERSION=<value> SHOPIFY_API_BASE=<value> SHOPIFY_TIMEOUT_MS=<value> SHOPIFY_MAX_RETRIES=<value> SHOPIFY_TOKEN_LEEWAY_SECONDS=<value> claude mcp add io.github.a1-x-tech-mcp-shopify-admin -- npx -y mcp-shopify-admin@1.2.2รันในเทอร์มินัล
{ "mcpServers": { "io.github.a1-x-tech-mcp-shopify-admin": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "SHOPIFY_STORE_DOMAIN": "<value>", "SHOPIFY_ACCESS_TOKEN": "<secret>", "SHOPIFY_CLIENT_ID": "<value>", "SHOPIFY_CLIENT_SECRET": "<secret>", "SHOPIFY_API_VERSION": "<value>", "SHOPIFY_API_BASE": "<value>", "SHOPIFY_TIMEOUT_MS": "<value>", "SHOPIFY_MAX_RETRIES": "<value>", "SHOPIFY_TOKEN_LEEWAY_SECONDS": "<value>" } } }}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.
เปิดจากผู้เผยแพร่
English | Русский
MCP server for the Shopify Admin API: products, orders, customers, inventory, discounts.
A1 Shopify Admin MCP connects AI applications to one Shopify store through the Admin GraphQL API. Ask in plain language about products, orders, customers, inventory, discounts, and shop data; the assistant uses the server's ready-made tools and shows the result.
userErrors and rejects empty or malformed GraphQL responses.Start with a read-only request:
Show the latest orders and the products that currently have inventory.
You: Show the latest orders and the products that currently have inventory.
Assistant: Shows recent orders with their statuses and totals, then products with prices and inventory. Nothing changes.
You: Prepare a 20% discount code called
SUMMERfor two weeks.Assistant: Shows the proposed code, percentage, dates, and limits, then asks for confirmation before creating it.
You: Confirm.
You need Node.js 20+, a store domain such as my-store.myshopify.com, and Admin API credentials. The recommended set is the client ID and secret of a Shopify Dev Dashboard app: the server exchanges them for an access token itself and keeps that token fresh, which matters because the token Shopify issues for this grant expires after 24 hours. The app and the store must belong to the same Shopify organization.
The server runs locally over stdio through npx. Browser-only ChatGPT and Claude web sessions cannot start a local stdio process directly.
Every snippet below uses that pair. If your store still holds a ready-made token from an admin-created custom app, replace SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET with a single SHOPIFY_ACCESS_TOKEN — see Getting access.
Through the app:
Open Settings → MCP servers.
Select Add server.
Choose STDIO, then enter npx -y mcp-shopify-admin@latest and set SHOPIFY_STORE_DOMAIN, SHOPIFY_CLIENT_ID, and SHOPIFY_CLIENT_SECRET.
Select Save, then Restart.
Through the CLI:
codex mcp add shopify-admin \
--env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
--env SHOPIFY_CLIENT_ID=your_client_id \
--env SHOPIFY_CLIENT_SECRET=your_client_secret \
-- npx -y mcp-shopify-admin@latest
codex mcp list
claude mcp add \
--env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
--env SHOPIFY_CLIENT_ID=your_client_id \
--env SHOPIFY_CLIENT_SECRET=your_client_secret \
--transport stdio --scope user shopify-admin \
-- npx -y mcp-shopify-admin@latest
claude mcp list
The current official path is Settings → Extensions. For a custom desktop extension, open Advanced settings → Extension Developer → Install Extension…, select a .mcpb file and follow the prompts.
This repository currently publishes an npm stdio package and does not contain a .mcpb bundle. For Claude Desktop builds that still support local configuration, use the following JSON stdio configuration as a fallback:
{
"mcpServers": {
"shopify-admin": {
"command": "npx",
"args": ["-y", "mcp-shopify-admin@latest"],
"env": {
"SHOPIFY_STORE_DOMAIN": "my-store.myshopify.com",
"SHOPIFY_CLIENT_ID": "your_client_id",
"SHOPIFY_CLIENT_SECRET": "your_client_secret"
}
}
}
}
In those builds, save it to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.
Add this server to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows:
{
"mcpServers": {
"shopify-admin": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-shopify-admin@latest"],
"env": {
"SHOPIFY_STORE_DOMAIN": "my-store.myshopify.com",
"SHOPIFY_CLIENT_ID": "your_client_id",
"SHOPIFY_CLIENT_SECRET": "your_client_secret"
}
}
}
}
Run MCP: Open User Configuration and add:
{
"inputs": [
{
"type": "promptString",
"id": "shopify_store_domain",
"description": "Shopify store domain, for example my-store.myshopify.com"
},
{
"type": "promptString",
"id": "shopify_client_id",
"description": "Client ID of the Shopify Dev Dashboard app"
},
{
"type": "promptString",
"id": "shopify_client_secret",
"description": "Client secret of that app",
"password": true
}
],
"servers": {
"shopify-admin": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-shopify-admin@latest"],
"env": {
"SHOPIFY_STORE_DOMAIN": "${input:shopify_store_domain}",
"SHOPIFY_CLIENT_ID": "${input:shopify_client_id}",
"SHOPIFY_CLIENT_SECRET": "${input:shopify_client_secret}"
}
}
}
}
Check the server with MCP: List Servers.
This server does not provide dedicated tools for creating orders, fulfillment, customer writes, variant creation, media, targeted discounts, or publishing products to sales channels. Use graphql_request only when you understand the document and its userErrors response.
The AI client may ask for confirmation before a write, but confirmation behavior belongs to that client. A clear request to create, update, set, or cancel authorizes the corresponding server operation.
The server authenticates in one of two ways: with the client ID and secret of a Dev Dashboard app, which it exchanges for an access token itself, or with a ready-to-use Admin API access token that it sends as-is. If both are configured, the ready-made token wins.
Shopify stopped allowing new admin-created custom apps on 2026-01-01, so this is the path for any store being set up today.
read_products, write_products, read_orders, read_customers, read_locations, write_inventory, read_discounts, and write_discounts.SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET.From there the server runs the client credentials grant against https://{store}.myshopify.com/admin/oauth/access_token on its own. The token Shopify returns lives 24 hours; the server keeps it in memory only — never on disk — re-mints it shortly before it expires, lets parallel tool calls share one exchange, and mints a fresh one if the API answers 401. Nothing to renew by hand.
The grant works only when the app and the store belong to the same Shopify organization. Otherwise Shopify refuses with shop_not_permitted, and the server relays that as a hint naming the organization mismatch. Re-issuing the credentials does not help: move the app into the store's organization, or use a store from it.
Apps created in the Shopify admin before 2026-01-01 keep working, and their token is still accepted. If you already maintain one:
read_products, write_products, read_orders, read_customers, read_locations, write_inventory, read_discounts, and write_discounts.SHOPIFY_ACCESS_TOKEN.The server sends this token as-is and never refreshes it, so replacing it when it stops working is yours to do. See Shopify's legacy admin-created custom app documentation.
Treat the access token and the client secret as passwords and never commit them to Git. For safe testing, use a Shopify development store.
* SHOPIFY_API_BASE can replace the store domain for local tests, but a real Shopify request still needs credentials.
** One of the two authentication paths is required: SHOPIFY_CLIENT_ID + SHOPIFY_CLIENT_SECRET, or SHOPIFY_ACCESS_TOKEN. With neither, the server still starts and answers initialize, but every tool call returns an error naming both options. Variables are read at startup, so restart the server after changing them.
actualQueryCost, currentlyAvailable, maximumAvailable, and restoreRate when Shopify provides them. A page with first up to 250 is usually cheaper than many small pages.THROTTLED and HTTP 429 are retried with the wait Shopify reports. 5xx and network errors are retried only for reads; mutations are not replayed after those failures.read_all_orders scope; without it, Shopify does not return them.ASKADS_TELEMETRY=0.Found a bug or missing scenario? Create an issue or contact us on Telegram.
MCP server for the Shopify Admin API: products, orders, customers, inventory, discounts.
{ "mcpServers": { "io.github.a1-x-tech-mcp-shopify-admin": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "SHOPIFY_STORE_DOMAIN": "<value>", "SHOPIFY_ACCESS_TOKEN": "<secret>", "SHOPIFY_CLIENT_ID": "<value>", "SHOPIFY_CLIENT_SECRET": "<secret>", "SHOPIFY_API_VERSION": "<value>", "SHOPIFY_API_BASE": "<value>", "SHOPIFY_TIMEOUT_MS": "<value>", "SHOPIFY_MAX_RETRIES": "<value>", "SHOPIFY_TOKEN_LEEWAY_SECONDS": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: SHOPIFY_STORE_DOMAIN, SHOPIFY_ACCESS_TOKEN, SHOPIFY_CLIENT_ID, SHOPIFY_CLIENT_SECRET, SHOPIFY_API_VERSION, SHOPIFY_API_BASE, SHOPIFY_TIMEOUT_MS, SHOPIFY_MAX_RETRIES, SHOPIFY_TOKEN_LEEWAY_SECONDS
Shopify Admin MCP ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-08 MCP server for the Shopify Admin API: products, orders, customers, inventory, discounts.