Quick answer: "Shopify MCP" is not one tool. It is a group of servers that let AI assistants connect to Shopify through the Model Context Protocol (MCP). The two main official ones are:
- Storefront MCP: built for AI shopping agents. It lets an agent browse a store's catalog, use the cart and read store policies.
- Dev MCP (part of the Shopify AI Toolkit): built for developers. It gives AI coding tools access to Shopify docs, API schemas and code checks.
There are also community servers for managing a store from chat. They need extra care.
What Is Shopify MCP and How Does It Work?
- MCP stands for Model Context Protocol. It is a standard way for AI assistants (like Claude, or coding tools like Cursor) to connect to outside tools and data.
- An MCP server is the connection point. It lists what the AI is allowed to do, such as "search products" or "look up API docs."
- Without MCP, an AI guesses from its training data. With MCP, it can check live information.
Think of it as a set of labeled doors. Each Shopify MCP server opens a different door, and each has different rules.
Which Shopify MCP Server Should You Use?
Storefront MCP
- For: stores that want AI shopping agents to find and buy their products.
- What it does: connects an agent to one store's catalog, cart and policies.
- Login needed: Shopify's docs say Storefront MCP servers do not require authentication.
- Who sets it up: developers building shopping agents.
Dev MCP / Shopify AI Toolkit
- For: developers and agencies using AI coding tools.
- What it does: searches Shopify docs and API schemas, and validates GraphQL, Liquid and UI extension code.
- Login needed: the docs server runs locally. Store actions go through the Shopify CLI.
Community admin MCP servers
- For: running a store from an AI chat, such as updating products or checking orders.
- What they do: connect to your store using API credentials you create.
- Risk: they can change real store data. See the safety checklist below.
Not sure?
- Store owner wanting AI sales on your store: start with Storefront MCP and an agentic commerce audit.
- Developer building on Shopify: start with the AI Toolkit.
- Store owner wanting AI to manage products: use a development store first and ask a developer for a review.
How to Set Up the Shopify AI Toolkit (Dev MCP)
The AI Toolkit is open source and lives at github.com/Shopify/shopify-ai-toolkit. It supports several coding tools.
Install the Shopify AI Toolkit in Claude Code
Run these two commands in a chat:
/plugin marketplace add Shopify/shopify-ai-toolkit
/plugin install shopify-plugin@shopify-ai-toolkit
Add Shopify Dev MCP to Claude Code
claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
Configure Shopify Dev MCP in Cursor, Claude Desktop and Other Clients
Add this to your MCP configuration:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}
Configure Shopify Dev MCP on Windows
If `npx` fails, wrap it:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "cmd",
"args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
}
}
}
Connect the Shopify AI Toolkit to Other Coding Tools
- Gemini CLI: `gemini extensions install https://github.com/Shopify/shopify-ai-toolkit`
- Codex: run `/plugins`, search for Shopify and add it.
- VS Code: open the Command Palette and run Chat: Install Plugin From Source, then paste the repository link.
What Features Does the Shopify AI Toolkit Provide?
- Search of Shopify's documentation and API schemas from inside your editor.
- Checks for GraphQL queries, Liquid templates and UI extensions against Shopify's schemas.
- Store management through the Shopify CLI's store capabilities.
Requirements: Node.js is needed for the `npx` method. Check Shopify's current docs for the supported version.
How Shopify Storefront MCP Connects AI Shopping Agents to Your Catalog
This is the part most store owners ask about.
- Every store has its own endpoint. Shopify's docs say each store exposes an MCP server for storefront features.
- Tools the agent can use:
- Catalog tools (`search_catalog`, `lookup_catalog`, `get_product`) for finding and reading products.
- Cart tools (`get_cart`, `update_cart`) to build a cart.
- A policies tool (`search_shop_policies_and_faqs`) to answer shipping and returns questions.
- Catalog scope: the Storefront Catalog MCP is for buyer questions about a single merchant. It follows the UCP Catalog capability, an open commerce standard.
- Why it matters: an AI agent can answer "Do you have this in blue?" from your real product data. If your data is messy, the answer will be wrong or missing.
How to Make Your Shopify Product Catalog Ready for AI Agents
- Write clear product titles and descriptions.
- Fill in variants, sizes, materials and stock correctly.
- Keep shipping and returns policies complete and easy to read.
- Remove duplicate and outdated products.
- Check that images load and have alt text. See our guide: Shopify product images not showing? 9 fixes.
What Can You Do With Shopify MCP?
Developers:
- Ask an AI to draft a Liquid section and have it checked against real schemas.
- Write and validate GraphQL queries for the Admin API.
- Build apps faster with correct, current documentation.
Store owners (with a developer's help):
- Prepare your catalog for AI shopping.
- Test how an agent reads your products and policies.
Agencies:
- Speed up theme and app work.
- Keep AI tools from guessing outdated code.
Shopify MCP Security: Safety Checklist Before You Connect
- Use a development store first. Never test on a live store.
- Give the least access possible. Create API credentials with only the permissions needed, and prefer read-only.
- Keep secrets out of code. Put tokens in your client's environment settings, never in a file you commit.
- Review before approving. Check what the AI plans to change before it runs.
- Back up your store. Export products and duplicate your theme before any bulk change.
- Pin versions for team work. `@latest` updates automatically, which can change behavior.
- Know what is sent where. Code validated through a toolkit may be sent to Shopify's servers. Read the privacy notes.
- Be careful with community servers. Check who maintains them, when they were last updated and what permissions they ask for.
- Fake packages exist. Install only from the official Shopify repository or package names in Shopify's docs.
Common Shopify MCP Setup Problems and Fixes
- The server does not start: check your Node.js version, then try the Windows `cmd` configuration.
- Old repository link: you may see old links to Shopify/dev-mcp. Shopify's docs point to the AI Toolkit repository, and the package name `@shopify/dev-mcp` still works.
- The AI gives outdated answers: make sure the server is connected and enabled in your client.
- Plugin install fails: use the manual `claude mcp add` command instead.
When to Hire a Shopify Developer for MCP Setup
Get help if:
- You want your catalog and policies ready for AI shopping agents.
- You want to connect AI tools to your store without risking live data.
- You need custom Shopify Functions, apps or theme work built faster.
- You want an expert to check your store's AI readiness.
Ecomheroes has been building Shopify stores since 2018. See our agentic commerce quick audit, read our guide to Shopify AI shopping and agentic commerce, or hire a Shopify developer. For small jobs, a fixed-price task from $59 works well.
Shopify MCP FAQ
What is Shopify MCP?
It is a group of servers that let AI tools connect to Shopify using the Model Context Protocol. The main official ones are Storefront MCP for shopping agents and Dev MCP for developers.
What is the Shopify AI Toolkit?
An open-source toolkit that connects AI coding tools to Shopify's docs, API schemas and code validation, plus store management through the Shopify CLI.
Does Shopify Storefront MCP need authentication?
According to Shopify's documentation, Storefront MCP servers do not require authentication.
Can Claude manage my Shopify store?
Claude can connect through MCP tools. For live store changes, use a development store, limited permissions and review each action.
Is Shopify MCP free?
The Dev MCP and AI Toolkit are open source. Your AI client may have its own costs.
What does the Shopify catalog MCP do?
It lets an AI agent search and look up products from one store's catalog, so it can help buyers find and purchase from that store.
Is it safe to connect AI to my Shopify store?
It can be, if you use limited permissions, test first and review changes. Never share admin credentials in chat.
Conclusion: Choose the Right Shopify MCP Server for Your Goal
Shopify MCP gives AI tools a safe, standard way to work with your store data and Shopify's documentation. Pick the server that matches your goal, start on a development store and keep permissions tight. If you want a second pair of eyes, contact Ecomheroes.