Integration Guide
Connect Claude Desktop to your SHOPMCP workspace and verify that the connector can reach your Shopify store.
This guide walks through the Claude Desktop side of the setup. Your Shopify store should already be connected to SHOPMCP before you start.
What you are doing here
You are not reconnecting Shopify. You are telling Claude Desktop how to reach your SHOPMCP MCP server, then approving Claude access for your user account.
Before you start
Make sure you have:
- A connected Shopify store in your SHOPMCP dashboard
- Claude Desktop installed on your computer
- Access to edit Claude Desktop's config file
If your dashboard Overview page shows a connected store, you are ready.
How the integration works
Claude Desktop does not connect directly to Shopify. It connects to SHOPMCP through an MCP server entry in Claude's config file.
The flow is:
- Claude Desktop starts the SHOPMCP connector.
- The connector points Claude to your SHOPMCP MCP server.
- SHOPMCP asks you to sign in and approve access.
- Claude can call approved Shopify tools through SHOPMCP.
- SHOPMCP applies workspace permissions, confirmations, and audit logging.
| 1 | { |
| 2 | "mcpServers": { |
| 3 | "shopify": { |
| 4 | "url": "http://localhost:8080/mcp" |
| 5 | } |
| 6 | } |
| 7 | } |
Connect Claude Desktop
1. Copy your Claude Desktop config
Open the SHOPMCP dashboard and go to Overview.
Copy either the ready-made Claude Desktop config or the MCP bridge command shown there. The config points Claude to your SHOPMCP MCP server.
The connector URL is safe to copy. By itself, it does not grant access to your store. A signed-in and authorized user is still required before Claude can use Shopify tools.
2. Open Claude Desktop's config file
Open the Claude Desktop configuration file in a text editor:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
If the file does not exist yet, create it.
3. Add the SHOPMCP server entry
Paste the SHOPMCP entry inside the mcpServers object.
If your file already has other MCP servers, keep them and add SHOPMCP as another entry. Do not replace unrelated servers unless you want to remove them.
After saving the file, restart Claude Desktop so it can reload the config.
4. Approve access when Claude asks
The first time Claude tries to use SHOPMCP, it may open a browser login and consent screen.
Sign in with the same account you use for the SHOPMCP dashboard. Review the requested access, then approve it if it matches what you expect.
This approval is tied to your user and workspace. Teammates approve access separately with their own accounts.
Test the connection
Ask Claude a simple read-only question first:
A good first test should be specific and low risk. Recent orders, top products, or low-stock products are better than broad requests like “analyze my store.”
If Claude returns real store data, the connector is working.
What each screen means
Shows your store connection and the Claude Desktop config you need to copy.
Tells Claude Desktop how to start and reach the SHOPMCP connector.
Confirms that your signed-in user can use SHOPMCP for this workspace.
Adding another device
Each device needs its own Claude Desktop config entry. Copy the same config from the dashboard, add it to the second device, then approve access when Claude asks.
You do not need to reconnect Shopify for every device.
Adding a teammate
Invite the teammate from the Team page first. After they accept the invite, they can add the connector to their own Claude Desktop and approve access with their own SHOPMCP account.
They do not need your Shopify password, your Claude account, or your dashboard login.
When you are asked to log in again
If your session expires, or you sign out from Settings, Claude may ask you to sign in again the next time it uses SHOPMCP.
That does not mean your Shopify store was disconnected. It only means your user session needs to be refreshed.
Troubleshooting
If Claude cannot see the connector:
- Make sure the config was saved in the correct Claude Desktop config file
- Restart Claude Desktop after editing the file
- Check that the SHOPMCP entry is inside
mcpServers - Confirm your store still shows as connected in the dashboard
- Try a simple read-only prompt before testing write actions
If it still fails, continue to Troubleshooting & FAQ.
Was this page helpful?
Your feedback helps keep this documentation accurate and useful.