MCP Shopify Integration
Shopify MCP Integration: A Practical Setup Guide for D2C Brands
By Sharon Nath ·
Step-by-step on installing the Shopify MCP server, scoping tokens, connecting Claude Desktop, and adding Saara MCP for returns and reverse shipping.
This guide is the no-fluff version: how to actually get Shopify MCP integration working in your store, with the gotchas we've hit while deploying it for D2C brands.
Step 1 - Decide Read-Only or Read + Write
Start read-only. Always. The first week is for learning what the model is good (and bad) at. Move to write actions only after you've audited the tool calls in logs.
Step 2 - Install the Shopify MCP Server
Shopify's official MCP server runs as a hosted endpoint. Generate an Admin API token under *Settings → Apps and sales channels → Develop apps*. Scope it to: `read_orders`, `read_products`, `read_customers`, `read_fulfillments`. Save the token securely.
Step 3 - Add to Claude Desktop
Open `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or the Windows equivalent. Add your MCP server URL and token under `mcpServers`. Restart Claude. The tools appear in the composer.
Step 4 - Test the Read Flow
Ask: *"list my last 5 orders with status and total"*. Confirm the response matches your Shopify admin. If it doesn't, re-check the token scope.
Step 5 - Add Saara MCP for Post-Purchase
Shopify MCP stops at orders and products. To handle returns, exchanges, refunds, reverse shipping, and AI-agent actions, install Saara MCP alongside it. One config block, one extra token - now Claude can also:
- Query open returns and RMA status (via EcoReturns)
- Generate reverse shipping labels across 100+ carriers (via EcoShip)
- Issue refunds and store credit
- Trigger FlyOS agents to escalate, refund, or notify
Step 6 - Lock It Down
- Rotate tokens monthly
- Keep an MCP tool-call audit log
- Restrict write actions to a dedicated ops user
- Use Shopify staff permissions to mirror MCP token scope
What Good Looks Like After 30 Days
- CX team resolves 40%+ more tickets in Claude / ChatGPT without opening Shopify admin
- WISMO tickets drop 30%+
- Ops manager runs daily standup from a single Claude prompt
For a fuller comparison, see Saara MCP vs Shopify MCP. Ready to install? Book a Saara MCP setup call →