By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Claude Code to Shopify, connect your store in a Ryze AI workspace with your .myshopify.com domain, then run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, sign in with /mcp and start asking about your store.
- In Ryze AI open Integrations, click Connect on the Shopify card and approve the access prompt in Shopify admin
- In your terminal run the claude mcp add command with the Ryze AI connector URL
- In Claude Code run /mcp, select ryze and sign in, then allow your workspace
- Run claude mcp get ryze to check the status and ask your first question
Before you start
- A Claude Code account or provider. Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account; the free claude.ai plan does not include it. It can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Anthropic's MCP page names no extra plan for remote MCP servers.
- A Shopify store you can approve access for. Ryze AI connects with its own Shopify app: you enter the .myshopify.com domain (not your custom domain) and approve an access prompt in Shopify admin. No API keys are needed. If you want theme file edits, URL redirects or customer records, connect with your own custom app instead.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial. SEO Starter is $129 per month with a 3-day free trial and covers publishing Content Plan articles to the Shopify blog. Agency is $279 per month and Shopify CRO is $1,499 per month. Annual billing takes 30% off the first year. Adding the connector is free; the Shopify tools need an active plan or trial.
How to connect Claude Code to Shopify with OAuth
Two steps happen in Ryze AI and Shopify, four in Claude Code. The connector URL is the same for every user.
Connect Shopify in Ryze AI
Create a Ryze AI account or sign in, open Integrations and click Connect on the Shopify card. On the Shopify app tab, type your .myshopify.com domain and click Continue.
Approve the access prompt in Shopify admin
Approve the access prompt in your Shopify admin. You return to Ryze AI with the store connected. Optionally click View on the Shopify card, choose the blog articles publish to and the article template, and click Save.
Add the connector to Claude Code
Run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp in your terminal. The server is saved at local scope by default, so it loads in the current project only. Add --scope user for all projects, or --scope project to write a .mcp.json file for your team.
Sign in with OAuth
Inside Claude Code run /mcp, select ryze and authenticate. You can also run claude mcp login ryze in the shell; add --no-browser to print the URL instead of opening a browser, for example over SSH.
Allow your workspace
On the Ryze AI page, sign in, choose the workspaces that hold your Shopify connection and click Allow connection.
Check the status and ask your first question
Run claude mcp get ryze to see the status. Then ask: Read the 10 most recently updated products in my store and list each title, status and SEO title.
The Ryze AI help center Shopify guide covers the Shopify side of the connection, and the Ryze AI API key guide covers keys. Sources: Claude Code MCP docs.
API key and claude.ai connectors
Ryze AI API key
If you would rather not use the browser flow, for example in a script, create a Ryze AI API key. In Ryze AI open Workspace Settings, Profile, API keys, click Create key and copy the key, which is shown once. Then register the server with a header:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --header "Authorization: Bearer rk_live_..."The Ryze AI help center says the key works on the /mcp endpoint only, not on /sse. Claude Code documents that if a configured Authorization header is rejected, it reports the connection as failed and does not fall back to OAuth, so remove the server and add it again after fixing the key.
Connectors from claude.ai
A third route reuses a connector you already added in Claude on the web. Add Ryze AI at claude.ai/customize/connectors and finish the Ryze AI sign-in there, then log in to Claude Code with the same claude.ai subscription account and run /mcp. Connectors from claude.ai appear with an indicator showing where they come from. On Team and Enterprise plans only admins can add servers in claude.ai. These connectors load only when the active login is a claude.ai subscription, not with ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper or a third-party provider.
Claude Code limits
Claude Code has a few behaviors that matter when a store returns a lot of data.
| Behavior | What happens |
|---|---|
| Output size | Claude Code warns when MCP tool output exceeds 10,000 tokens and limits it to 25,000 tokens by default. Set MAX_MCP_OUTPUT_TOKENS to change the limit, for example MAX_MCP_OUTPUT_TOKENS=50000 claude. |
| Project approval | A server defined in .mcp.json at project scope waits for approval in an interactive session before it connects. |
| Headless runs | claude -p and Agent SDK runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login. |
| Idle timeout | HTTP servers have a five-minute idle timeout per tool call when no response or progress arrives. |
| Tool search | Tool search is on by default, so MCP tools are deferred and loaded on demand rather than all at session start. |
Source: Anthropic's Claude Code MCP docs.
Other clients
The same URL works in other clients. Shopify is connected once in Ryze AI, so nothing changes on the Shopify side.
Claude on the web and Desktop
Open Customize, Connectors, add a custom connector and paste https://connector.get-ryze.ai/mcp.
ChatGPT
Add https://connector.get-ryze.ai/mcp as an app under Settings > Apps. Shopify is connected once in Ryze AI, so nothing changes on the Shopify side. If the connector was added before Shopify was connected, remove and re-add it so the tool list refreshes.
Shopify access and scopes
Two connection types exist on the Shopify side, and what Claude Code can reach depends on which one you pick.
- Default: the Ryze AI Shopify app
- You enter the .myshopify.com domain and approve an access prompt in Shopify admin. No API keys. Tokens refresh automatically. Theme file edits (for example robots.txt or theme.liquid), URL redirects and customer records are not available on this connection.
- Alternative: your own custom app
- On the Custom app tab you enter the store domain, Client ID and Client secret from an app you create in the Shopify Dev Dashboard. The Ryze AI Shopify custom app guide lists the App URL and redirect URL to enter (leave Embed app unchecked); then choose the Admin API scopes, Release and Install app. Use this for theme files, redirects and customer records.
- Order history window
- Orders older than 60 days stay hidden unless the custom app has the read_all_orders scope.
- Missing scopes
- Ryze AI does not work around missing Admin API scopes. The agent reports the missing scope.
Sources: Ryze AI help center, Shopify and Ryze AI help center, Shopify custom app.
Removing access
In Claude Code, run claude mcp remove ryze to drop the server, or /mcp to clear its sign-in. In Ryze AI, use the Shopify card to manage the store connection. A store can be live in only one Ryze AI workspace at a time.
What Claude Code can do in Shopify
The Ryze AI connector exposes 5 Shopify tools. They run against the connected store through the Shopify Admin GraphQL API.
| Tool | Type | What it does |
|---|---|---|
| shopify__read | Read | Runs a read-only Shopify Admin GraphQL query against the connected store. What it returns depends on the scopes the store connection has. |
| shopify__search_content | Read | Searches one text field that the read tool can return, such as an article body, and returns matching lines with line numbers and surrounding context. |
| shopify__write | Write | Runs an Admin GraphQL mutation that creates or updates resources, such as productUpdate or metafieldsSet. Delete, remove, cancel and deactivate mutations are rejected here. |
| shopify__edit_content | Write | Makes find-and-replace edits inside one text field on the server in a single call, with optional JSON or Liquid validation before anything is written. |
| shopify__delete | Delete | Runs a destructive Admin GraphQL mutation that deletes, removes, cancels, deactivates, revokes or discards a resource, such as productDelete or tagsRemove. |
In Ryze AI chat the Tool approvals picker starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you want changes to wait. In Claude on the web, write and delete tools can be set to Needs approval under Customize > Connectors > Ryze AI > Tool permissions. Claude Code has its own permission prompts for tool calls; Ryze AI's facts do not describe them, so check Anthropic's Claude Code permissions docs for how to require a confirmation per tool.
First 3 prompts to run
Each answer comes from your own store, so this page describes what comes back instead of showing sample numbers. Orders are limited to the last 60 days on the default connection.
1. Audit product SEO fields
Read the 25 most recently updated products and list each title, handle, SEO title and SEO description. Flag the ones where the SEO description is empty.
Tools used: shopify__read
What comes back: A table of products with their SEO fields and a separate list of products with an empty SEO description.
2. Edit one phrase in a long description
In the product description of my product named in this message, find every line that mentions the old shipping policy and replace the phrase with the new wording I give you.
Tools used: shopify__search_content, shopify__edit_content
What comes back: The matching lines with line numbers and context, then the edited field after the find-and-replace write.
3. Recent orders summary
Read orders from the last 30 days and group them by sales channel with order count and total. Tell me if the connection scopes block any field.
Tools used: shopify__read
What comes back: A table of orders grouped by channel, or a note naming the missing scope if the store connection cannot return a field.
To change data, say so in the prompt. Writes go through shopify__write and shopify__edit_content, and deletes through shopify__delete, which stays a separate tool.
Ryze AI vs Shopify's own MCP servers
Shopify publishes its own MCP tooling for developers. It does a different job from the Ryze AI connector.
| Option | Setup | Shopify coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Connect the store in Ryze AI, then claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp and sign in with OAuth | Admin GraphQL read, write and delete tools for your store: products, collections, pages, blogs and SEO fields, plus orders within the 60-day window | Claude Code, Claude, ChatGPT and other MCP clients |
| Shopify Dev MCP | claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest. Runs locally, no authentication | Shopify's developer resources: docs and API schemas for building apps. It does not connect to your store data | Claude Code and other MCP clients with stdio |
| Shopify Storefront MCP | Was served at https://{shop}/api/mcp | Shopify's docs say the catalog and cart tools on that URL were removed and moved to the Universal Commerce Protocol at https://{shop}/api/ucp/mcp | Check Shopify's docs before relying on it |
Use Shopify Dev MCP while you write Shopify app or theme code, because it gives Claude Code the API schemas. Use the Ryze AI connector when you want Claude Code to act on a live store. The two can be added to the same Claude Code setup because they are separate servers.
Sources: Shopify Dev MCP server, Shopify Storefront MCP, Ryze AI help center, Shopify. Checked November 9, 2026.
Shopify API limits
Shopify's Admin API limits apply to calls made against your store. Shopify's rate limit page describes a leaky bucket model where each app has a bucket sized by the API and your plan, and GraphQL query cost is calculated per query. A THROTTLED error means the limit was exceeded. The same page lists a maximum of 250 items per input array, pagination capped at 25,000 objects and a recommended one second backoff for retries. In Ryze AI, full-catalog bulk exports (bulkOperationRunQuery) cannot be downloaded through the tools.
Sources: Shopify API rate limits and GraphQL Admin API reference. Checked November 9, 2026.
Errors and fixes
- The ryze server shows as failed in claude mcp get
- If you set an Authorization header with an API key, Claude Code does not fall back to OAuth when it is rejected. Remove the server with claude mcp remove ryze and add it again with a valid key or without the header.
- claude -p cannot sign in
- Headless runs cannot run the OAuth flow. Sign in first with /mcp or claude mcp login ryze in an interactive shell.
- Shopify tools do not appear
- If the connector was added before Shopify was connected in Ryze AI, remove the server and add it again so the tool list refreshes, then start a new session.
- A field or object is missing from results
- The tools return what the store connection scopes allow. Ryze AI does not work around missing scopes. Customer records, theme files and redirects need your own custom app.
- Old orders are missing
- Orders older than 60 days stay hidden unless the custom app has the read_all_orders scope.
- The store is already connected elsewhere
- A store can be live in only one Ryze AI workspace at a time. Disconnect it in the other workspace first.
- Output is cut off or a warning appears
- Claude Code warns above 10,000 tokens of tool output and limits it to 25,000 by default. Ask for fewer fields or fewer records, or raise MAX_MCP_OUTPUT_TOKENS.
- A tool call times out
- HTTP servers have a five-minute idle timeout per tool call when no response or progress arrives. Narrow the request and retry.
- Ryze AI says a subscription is required
- The Shopify tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Claude Code to Shopify?
Connect your store in a Ryze AI workspace: open Integrations, click Connect on Shopify, enter your .myshopify.com domain and approve the access prompt in Shopify admin. Then run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, run /mcp, select ryze and sign in, and allow the workspace.
Is there a Shopify MCP server for Claude Code?
Shopify's own Dev MCP server (npx -y @shopify/dev-mcp@latest) gives Claude Code Shopify's docs and API schemas for building apps, and needs no authentication. It does not read your store. The Ryze AI connector at https://connector.get-ryze.ai/mcp is the one that reads and edits store content, through 5 Shopify tools.
Which Shopify option should I use in Claude Code?
Ryze AI is the best connector for editing live Shopify product, collection, page and blog content and SEO fields from Claude Code, but it needs a Ryze AI plan and cannot edit theme files or redirects on the default connection. For writing Shopify app code, add Shopify Dev MCP as well.
Which Claude plan do I need for Claude Code?
Anthropic says Claude Code requires a Pro, Max, Ultra, Team, Enterprise or Console account, and the free claude.ai plan does not include it. It can also run through Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry.
OAuth or API key: which should I use?
Use OAuth (/mcp or claude mcp login ryze) for interactive work. Use a Ryze AI API key with the --header option for scripts, since claude -p and Agent SDK runs cannot run the OAuth flow. The key works on the /mcp endpoint only.
Can Claude Code edit or delete Shopify content?
Yes. shopify__write and shopify__edit_content create and update content, and shopify__delete runs delete mutations as a separate tool. Delete mutations are rejected in the write tool. In Ryze AI chat, the Tool approvals picker starts on Skip all approvals, so set the approval mode you want.
Can I use more than one Shopify store?
Yes. Click View on the Shopify card and choose Add one more account. One store is the primary (starred) and the agent uses it unless you name another store. A store can be live in only one Ryze AI workspace at a time.
Can Claude Code change my theme files or redirects?
Not on the default connection. Theme file edits such as robots.txt or theme.liquid and URL redirects need your own custom app, created in the Shopify Dev Dashboard and connected on the Custom app tab.
How far back can Claude Code read orders?
Orders older than 60 days stay hidden unless the custom app has the read_all_orders scope.
Why do the Shopify tools not show up?
If the connector was added before Shopify was connected in Ryze AI, remove the server with claude mcp remove ryze, add it again and start a new session so the tool list refreshes.
How much does it cost?
Adding the connector is free, but the Shopify tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial, Agency is $279 per month and Shopify CRO is $1,499 per month. Annual billing takes 30% off the first year.
How do I disconnect Shopify from Claude Code?
Run claude mcp remove ryze to remove the server from Claude Code. To disconnect the store itself, manage the connection on the Shopify card in Ryze AI.