What is Shopify MCP and why do I need it?

Shopify MCP (Model Context Protocol) allows AI agents like Claude, Cursor, and custom applications to directly access your Shopify store data and perform actions like product search, cart management, and customer account operations. It enables agentic commerce where AI can help customers shop, place orders, and get support without manual intervention.

Which Shopify MCP servers are available in 2026?

Four MCP servers are available: Storefront MCP (product discovery, search, pricing - no authentication needed), Customer Account MCP (order history, tracking, loyalty - OAuth required), Checkout MCP (cart operations, checkout completion - authentication required), and Dev MCP (developer tools for building apps). Storefront MCP is enabled by default on all stores.

How do I connect Claude Desktop to my Shopify store?

Open Claude Desktop → Settings → Developer → Edit Config. Add a server entry with your store URL: {"mcpServers": {"shopify": {"command": "mcp-server", "args": ["--url", "https://your-store.myshopify.com/api/mcp"]}}}. Restart Claude Desktop and test with a query like "search this store for products".

Is Shopify MCP free to use?

Yes, Shopify MCP is free. The Storefront MCP endpoint has no additional cost and works on all plans. Customer Account and Checkout MCP use existing Shopify authentication with no added fees. Only advanced enterprise features and some third-party MCP tools may have associated costs.

Ira Bodnar·June 8, 2026·14 min read

How to set up a Shopify MCP connection in 2026

Complete step-by-step guide to connect Claude, Cursor, and any AI agent to your Shopify store via MCP servers. Covers all 4 connection methods, from basic 15-minute setup to advanced authenticated endpoints.

Built by our community of 2,000 marketers

Free skills and prompts for paid ads and SEO

Templates for Claude, ChatGPT and Perplexity.

Clients we work withClients we
work with

Setting up a Shopify MCP connection in 2026 is simpler than most merchants expect — if you follow the right steps.

Shopify's Model Context Protocol servers went live across all stores in March 2026, letting any AI agent connect directly to your store data and operations.

Here's what changed and how to set up a Shopify MCP connection in 2026:

The Storefront MCP server is live on every Shopify store by default — no setup required, no authentication needed.
Customer Account and Checkout MCP servers require one-click activation in Shopify admin under Settings > Apps and sales channels > Agentic commerce.
Average setup time is 15 minutes for basic connections, 45 minutes for authenticated endpoints with custom workflows.

What you need before setting up a Shopify MCP connection in 2026

Before you set up a Shopify MCP connection in 2026, verify you have the right store configuration and AI client ready. Most connection failures happen because merchants skip these prerequisites.

Shopify Store Requirements

✓Any Shopify plan (Basic, Shopify, Advanced, or Plus)
✓Store created after January 2026 (MCP auto-enabled)
✓For older stores: check Settings → Apps → Agentic commerce
✓Admin access to enable Customer/Checkout MCP if needed

AI Client Options

✓Claude Desktop (most popular, built-in MCP support)
✓Cursor IDE (dev-focused, great for custom apps)
✓VS Code with MCP extension
✓Any MCP-compatible client or custom integration

The fastest way to test your setup: try accessing https://your-store.myshopify.com/api/mcp in a browser. If you get a JSON response (not a 404), your Storefront MCP server is ready.

All 10 MCP connection methods compared

Method	Connection Type	Setup Time	Authentication	Best For
Ryze AI Fastest	Auto-configured	2 minutes	Automatic	Zero-setup automation
Claude Desktop + Storefront MCP	Direct JSON-RPC	15 minutes	None	Product discovery
Cursor + Dev MCP Server	Local development	20 minutes	Optional	App development
VS Code + MCP Extension	IDE integration	25 minutes	Token-based	Code editing
Custom MCP Client	API integration	45 minutes	Custom	Enterprise apps
Customer Account MCP	Authenticated	30 minutes	OAuth	Account management
Checkout MCP Server	Cart operations	35 minutes	Session-based	Purchase flows
Catalog MCP (B2B)	Business catalog	40 minutes	JWT	B2B commerce
Make.com + Shopify	Workflow automation	50 minutes	App credentials	Process automation
Zapier + Custom Integration	Third-party bridge	60 minutes	API keys	Legacy connections

Get a free instant audit

Get a free, instant read on your paid ads or SEO — and fix it right away.

Paid ads audit

Catch wasted spend & broad-match leaks
Find account structure gaps
Rank your quickest wins
Spot PMax & brand-search overlap
Check conversion-tracking health
Benchmark CPC vs your industry
Catch wasted spend & broad-match leaks
Find account structure gaps
Rank your quickest wins
Spot PMax & brand-search overlap
Check conversion-tracking health
Benchmark CPC vs your industry

Free · no credit card · instant

SEO audit

Find keyword & ranking gaps
Catch technical SEO issues
Rank your fastest wins
Surface thin & duplicate pages
Check indexing & crawl coverage
Compare backlinks vs competitors
Find keyword & ranking gaps
Catch technical SEO issues
Rank your fastest wins
Surface thin & duplicate pages
Check indexing & crawl coverage
Compare backlinks vs competitors

Free · no credit card · instant

Step-by-step methods

The 4 fastest ways to connect MCP to Shopify

01Fastest setup: 2 minutes

Ryze AI Auto-Configuration

Ryze AI automatically configures Shopify MCP connections when you connect your store. The platform detects which MCP servers are available, sets up the appropriate endpoints, and begins autonomous optimization immediately.

Simply add your store URL during onboarding — Ryze handles Storefront, Customer Account, and Checkout MCP configuration automatically. The AI starts auditing conversions and implementing fixes within 24 hours of connection. Start your free trial here.

Setup Time2 minutes (automatic)

Best ForZero-configuration setup, handles all MCP servers, includes optimization

LimitationsRequires Ryze subscription, less control over individual endpoints

Bottom LineBest for merchants who want MCP benefits without technical setup

02Most popular manual setup

Claude Desktop + Storefront MCP

Claude Desktop with Storefront MCP is the most straightforward manual connection. Storefront MCP is enabled by default on every Shopify store and requires no authentication, making it perfect for testing.

Steps: Open Claude Desktop > Settings > Developer > Edit Config. Add this server entry: {"mcpServers": {"shopify-storefront": {"command": "npx", "args": ["-y", "@shopify/storefront-mcp"], "env": {"SHOPIFY_SHOP_URL": "your-store.myshopify.com"}}}}. Restart Claude and test with: "Search this store for t-shirts and show three with prices."

Setup Time15 minutes (manual)

Best ForNo authentication needed, works immediately, great for product queries

LimitationsLimited to product discovery, requires JSON config editing

Bottom LineBest for exploring products and getting quick store insights

What most guides miss

95% of Shopify MCP setup issues come from using outdated endpoint URLs or missing the agentic commerce toggle. Always test with a minimal JSON-RPC call first: POST /api/mcp with method tools/list.

03Best for developers building apps

Cursor + Dev MCP Server

Cursor with the Dev MCP Server gives developers AI-powered access to Shopify's documentation, CLI tools, and code generation directly in their IDE. It runs locally and requires no authentication.

Install: npm install -g @shopify/dev-mcp. In Cursor, add the MCP server config pointing to the installed package. The AI can now generate Shopify app boilerplate, explain API endpoints, and help debug GraphQL queries using live Shopify documentation.

Setup Time20 minutes (local)

Best ForLocal development environment, no external dependencies, code generation

LimitationsDeveloper-focused, requires Node.js, limited to dev workflows

Bottom LineBest for building custom Shopify apps with AI assistance

04For authenticated customer operations

Customer Account MCP Setup

Customer Account MCP enables AI agents to access authenticated customer data like order history, addresses, and loyalty points. It requires enabling in Shopify admin and implementing OAuth flow for customer consent.

Enable in Shopify admin: Settings > Apps and sales channels > Agentic commerce > Customer Account MCP > Enable. Set up OAuth credentials in your app, implement the customer consent flow, and include the access token in MCP requests. The AI can then retrieve customer-specific data and perform account operations on their behalf.

Setup Time30 minutes (requires OAuth)

Best ForFull customer account access, order history, loyalty data

LimitationsComplex OAuth flow, requires customer consent, session management

Bottom LineBest for personalized customer service and account management AI

Skip the setup. Get AI optimization today.

✓Auto-connects to your Shopify store in 2 minutes
✓Handles all MCP servers and endpoints automatically
✓Starts optimizing conversions while you sleep

2,000+

Stores

31%

Avg lift

6 weeks

To results

05IDE integration for developers

VS Code + MCP Extension

VS Code with MCP extension brings Shopify MCP capabilities directly into your development environment. Install the MCP extension, configure your server endpoints, and get AI assistance with Shopify development.

Install the MCP extension from the VS Code marketplace, open Command Palette (Ctrl+Shift+P), select "MCP: Open User Configuration," and add your Shopify MCP server configurations. The extension provides autocomplete, error checking, and direct execution of MCP calls from the editor.

Setup Time25 minutes (setup + config)

Best ForFull IDE integration, debugging tools, syntax highlighting

LimitationsRequires VS Code setup, more complex than Claude Desktop

Bottom LineBest for developers who want MCP access within their existing VS Code workflow

06For cart and purchase operations

Checkout MCP Configuration

Checkout MCP enables AI agents to manage carts, apply discounts, calculate shipping, and complete purchases on behalf of customers. It requires careful session management and security considerations.

Enable in Shopify admin under Agentic commerce settings. Implement proper session handling to maintain cart state across AI interactions. The AI can add/remove items, apply discount codes, calculate taxes and shipping, and guide customers through checkout completion.

Setup Time35 minutes (session handling)

Best ForFull cart operations, checkout flow control, discount application

LimitationsComplex session management, requires careful security implementation

Bottom LineBest for AI-powered shopping assistants that handle purchases

07Business catalog access

Catalog MCP (B2B)

Catalog MCP provides AI agents with access to B2B catalogs, custom pricing tiers, and wholesale operations. It requires JWT authentication and is available to eligible merchants.

Register for dev credentials in Shopify Partners dashboard, implement JWT token generation, and configure catalog access scopes. The AI can then access customer-specific pricing, custom product catalogs, and B2B ordering workflows tailored to business customers.

Setup Time40 minutes (JWT setup)

Best ForB2B pricing, custom catalogs, wholesale operations

LimitationsLimited to eligible merchants, complex authentication

Bottom LineBest for B2B stores with custom pricing and catalog requirements

08Enterprise-grade custom implementation

Custom MCP Client Integration

Custom MCP client integration gives enterprises complete control over how AI agents interact with their Shopify stores. Build custom workflows, implement specific business logic, and integrate with internal systems.

Implement the MCP protocol specification, create custom tool definitions for your specific use cases, handle authentication and session management according to your security requirements, and build the integration into your existing infrastructure and workflows.

Setup Time45+ minutes (full custom)

Best ForComplete control, custom business logic, enterprise features

LimitationsRequires significant development, ongoing maintenance

Bottom LineBest for large organizations with specific requirements and development resources

09Workflow automation platform

Make.com Integration Bridge

Make.com can bridge AI systems with Shopify through workflow automation. While not a direct MCP connection, it enables AI-triggered actions and data synchronization with Shopify stores.

Create a Make.com account, set up Shopify connector with appropriate permissions, design workflows that respond to AI triggers or webhook calls, and configure the automation to handle the specific Shopify operations your AI system needs to perform.

Setup Time50 minutes (app + workflow setup)

Best ForVisual workflow builder, no-code automation, multiple app connections

LimitationsIndirect connection, workflow complexity, ongoing subscription cost

Bottom LineBest for non-technical users who want AI-triggered Shopify automations

10For older systems and custom needs

Legacy API Bridge Solutions

Legacy API bridge solutions connect older AI systems or custom applications to Shopify when direct MCP support isn't available. These typically involve custom middleware and API translation layers.

Build or configure middleware that translates between your AI system's protocol and Shopify's MCP endpoints, implement proper authentication and security measures, handle error cases and rate limiting, and maintain the bridge as both systems evolve.

Setup Time60+ minutes (complex setup)

Best ForWorks with any system, maximum flexibility, custom protocols

LimitationsComplex implementation, requires maintenance, potential security issues

Bottom LineBest as a last resort for systems that cannot support modern MCP protocols

David L.

Technical Lead
SaaS Ecommerce

★★★★★

“

I spent three days fighting MCP endpoint configurations. Ryze connected to our Shopify store in under 5 minutes and started optimizing immediately. Wish I'd found it sooner.”

2 minutes

Setup time

4 endpoints

Auto-configured

24/7

Optimization

How to fix the most common Shopify MCP connection issues

90% of Shopify MCP connection problems fall into one of these five categories. Here's how to diagnose and fix each issue:

404 Error on /api/mcp

The MCP endpoint isn't enabled or configured

Check if your store was created before March 2026 — older stores need manual activation
Go to Shopify admin → Settings → Apps and sales channels → Agentic commerce
Ensure 'Storefront MCP' is toggled ON (should be default for all stores)
Test the endpoint: POST to https://your-store.myshopify.com/api/mcp with method 'tools/list'

Connection timeout or no response

Network or firewall blocking MCP requests

Verify your store URL is correct: should be store-name.myshopify.com, not custom domain
Check if corporate firewall blocks JSON-RPC requests on port 443
Try connecting from a different network (mobile hotspot) to isolate network issues
Ensure your AI client supports the MCP protocol version (2.0+ required)

Authentication errors on Customer/Checkout MCP

OAuth or session token issues

Verify Customer Account MCP is enabled in Shopify admin under Agentic commerce
Check OAuth token expiry — customer tokens typically last 24-48 hours
Ensure proper scope permissions for the operations you're trying to perform
Test with a fresh OAuth flow to eliminate stale token issues

'Tools not found' or empty response

MCP server configuration problems

Update your MCP client to the latest version — protocol changes frequently
Verify the server configuration points to the correct Shopify endpoint
Check that your AI client properly implements the JSON-RPC 2.0 specification
Try a minimal test call first before complex operations

Rate limiting or 'too many requests'

API call frequency exceeding limits

Shopify MCP has built-in rate limiting — space requests 1-2 seconds apart
Use batch operations where possible instead of individual product queries
Implement exponential backoff in your client for 429 responses
Consider using Ryze AI's optimized connection for automatic rate limit handling

Pro Tip: Quick Diagnostic Test

Before troubleshooting complex issues, run this simple test: curl -X POST https://your-store.myshopify.com/api/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"tools/list","id":1,"params":{}}'. A successful response means your basic MCP connection works — focus troubleshooting on your AI client configuration instead.

1,000+ stores connected via Ryze

Trusted by leading agencies

★★★★★4.9/5

Frequently asked questions about Shopify MCP setup

What is the Shopify MCP server endpoint URL?

Every Shopify store exposes a Storefront MCP server at https://your-store.myshopify.com/api/mcp. No authentication is required for basic product discovery. Customer Account and Checkout MCP use the same base URL but require authentication tokens.

Do I need Shopify Plus to use MCP servers?

No. Storefront MCP is available on all Shopify plans by default. Customer Account and Checkout MCP work on any plan but require enabling in admin settings. Only advanced B2B catalog features require Plus.

How do I know if MCP is working on my store?

Test with a simple JSON-RPC call: POST to your-store.myshopify.com/api/mcp with method 'tools/list'. A successful response listing available tools (like search_shop_catalog) confirms MCP is working.

Why am I getting 404 errors on the MCP endpoint?

Stores created before March 2026 may need manual MCP activation. Go to Shopify admin → Settings → Apps and sales channels → Agentic commerce and ensure MCP servers are enabled.

Can I use MCP with multiple AI agents simultaneously?

Yes, MCP servers can handle multiple concurrent connections. However, be mindful of rate limits and consider using a single optimized connection like Ryze AI for best performance and automatic optimization.

Is there a cost to use Shopify MCP servers?

The MCP servers themselves are free. Storefront MCP has no additional fees. Customer Account and Checkout MCP are included with your Shopify subscription. You only pay for the AI services or tools that connect to them.

Auto-connect Shopify MCP in 2 minutes

Zero setup · all endpoints · free trial