By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Windsurf to Shopify is the Ryze AI connector. Connect your store in Ryze AI by approving the access prompt in Shopify admin, then put "ryze": {"url": "https://connector.get-ryze.ai/mcp"} under mcpServers in ~/.config/devin/mcp_config.json. Sign in with the Authenticate button in Devin Desktop, or with devin mcp login ryze in Devin CLI, click Allow connection, and ask the agent about your store.
- In Ryze AI open Integrations, find Shopify and click Connect, then enter your .myshopify.com domain
- Approve the access prompt in your Shopify admin
- In Windsurf open Customize, then MCPs, and add the ryze server with the connector URL
- Click Authenticate (devin mcp login ryze in Devin CLI), then Allow connection, and ask which products have empty SEO fields
Windsurf to Shopify at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, kept in Devin's mcp_config.json as one url entry named ryze, or added with devin mcp add in Devin CLI |
| Server address | https://connector.get-ryze.ai/mcp. The same entry also carries the other platforms connected in the Ryze AI workspace |
| Windsurf in November 2026 | Shipped as Devin Desktop since June 2, 2026. Devin Local is the agent that calls MCP tools; Cascade was removed on September 8, 2026 |
| Sign-in | Shopify is approved once inside Ryze AI, with no API keys on the default connection. Windsurf then signs in to Ryze AI through browser OAuth and registers itself, so no client ID is pasted |
| Shopify tools | 5 in total: 2 read, 2 write, 1 delete |
| Can it change the store | Yes. Write tools update product, collection, page and blog content and SEO fields, and a separate delete tool removes things. Devin Local asks before each MCP tool call by default |
| Other data in the same chat | Google Ads, Meta Ads, GA4 and Search Console tools, when those platforms are connected in the same Ryze AI workspace |
| Windsurf plan needed | Cognition's MCP pages name none and the Devin pricing page has no MCP row. The admin MCP settings carry the label Teams & Enterprise |
| Ryze AI price | Paid Ads at $89 per month after a 7-day free trial. Adding the connector costs nothing |
| Shopify's own option for Windsurf | None named. Shopify's AI Toolkit install lines and its CLI connector page do not list Windsurf, and its merchant connectors cover other assistants |
| Shopify access of the connection | 13 access scopes on the default app. Customer records, discounts and orders older than 60 days are not among them |
| Last tested | Shopify calls on November 13, 2026 through the connector. No step inside Windsurf was run |
Windsurf was renamed Devin Desktop on June 2, 2026; Cognition's changelog, its rename post and its FAQ all give that date. The MCP documentation moved to Devin's site: docs.windsurf.com/windsurf/cascade/mcp redirects to docs.devin.ai, and windsurf.com redirects to devin.ai/desktop, titled Devin Desktop. This guide keeps the name Windsurf because that is what people search for, and uses the menu names and file paths from the current Devin docs. Cascade conversations can no longer be started, so any older step that opens a Cascade MCP panel is out of date. If your install looks different, check which Customize page it shows.
Before you start
- Windsurf (Devin Desktop) on Mac, Windows or Linux. Cognition's MCP documentation names no plan for adding a server. The Devin Local page says Enterprise admins manage MCP registries under MCP & ACP in team settings, and the admin reference lists the MCP allowlist and registry settings under Teams & Enterprise, so on a team account an admin may need to approve the Ryze AI server first.
- Access to your Shopify admin. You need to be able to approve the app prompt for the store. Enter the .myshopify.com domain, not your custom domain. A store can be live in only one Ryze AI workspace at a time.
- 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 articles to the Shopify blog. Adding the connector is free, but the Shopify tools need an active plan or trial.
How to connect Windsurf to Shopify
Two steps happen in Ryze AI and Shopify, three in Windsurf, and the last is your first prompt. The connector URL is the same for every user.
Connect your store 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
Approve the access prompt in your Shopify admin. You return to Ryze AI with the store connected, and no API keys are needed on the default connection.
Open the MCP settings in Windsurf
From the Agents window open the Customize page and click MCPs. Use Install MCPs for to pick the scope, for example This computer.
Add the Ryze AI server
Open the config file and add the server under mcpServers: "ryze": {"url": "https://connector.get-ryze.ai/mcp"}. The user file is ~/.config/devin/mcp_config.json and the project file is .devin/mcp_config.json.
Sign in to the connector
Refresh the list under This computer. When the ryze server wants authorization it offers an Authenticate button: click it, finish the Ryze AI sign-in in your browser and click Allow connection. In Devin CLI the matching command is devin mcp login ryze.
Ask your first question
Ask: Read my Shopify products and list the ones whose SEO title or description is empty. Approve the tool call when Windsurf asks.
The Ryze AI Shopify guide covers the Shopify side of the connection, and the Ryze AI help article on API keys and the MCP endpoint covers the connector URL.
Sources: Devin Desktop: MCP and customizations, Devin CLI: MCP configuration, Devin Desktop changelog, Ryze AI Shopify guide. Checked November 14, 2026.
Config file, Devin CLI and imports
Windsurf now runs on Devin, so the same server can be added in the editor settings, in a config file or from the Devin CLI. Pick the route that matches how you work.
Devin Desktop (Windsurf) config file
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Use ~/.config/devin/mcp_config.json when you want Ryze AI in every project, or .devin/mcp_config.json to keep it with one repository. That project file travels through version control to everyone on the repository; for an entry only you should get, Devin reads the gitignored .devin/mcp_config.local.json. Devin Local supports stdio, Streamable HTTP and SSE with OAuth for each, trying Streamable HTTP first and falling back to SSE on non-auth 4xx errors.
Devin CLI
devin mcp add -s user ryze https://connector.get-ryze.ai/mcp
devin mcp login ryzeThe first command registers the server in your user config. The second opens the Ryze AI sign-in, where you click Allow connection. Run these in a terminal when you prefer not to edit JSON by hand. Leave out -s user and the entry lands in the gitignored local file of the folder you are in.
Servers kept in an old Windsurf file
Cognition's import page says Devin CLI picks up MCP servers from the old Windsurf file ~/.codeium/<channel>/mcp_config.json (the stable channel reads ~/.codeium/windsurf/), so for the CLI an entry there does not need adding twice. That page is written for the CLI. For Devin Desktop the FAQ only says Windsurf settings carry over to Devin Local, so look at the This computer list before you add ryze a second time. Some older Ryze AI pages show the key serverUrl for Windsurf. The reference that Devin Desktop follows lists url, so this guide uses url.
Sign-in and limits
OAuth uses dynamic client registration by default, so you enter no client ID or secret for the Ryze AI connector. Each MCP client keeps its own OAuth session, so signing in to Ryze AI from another tool does not carry over to Windsurf. The Devin Local page describes Needs authentication for expired credentials only. For the first sign-in, the July 29, 2026 release note gave servers that need authorization an Authenticate button, and the Devin CLI page says an OAuth server asks for a sign-in the first time it is used. Since November 8, 2026 the "..." menu in a session header can also re-authenticate a server.
Windsurf and MCP: the facts in one table
| Topic | What Cognition's documentation says |
|---|---|
| Where you add a server | The MCPs tab of the Customize page in the Agents window, with Install MCPs for set to a scope such as This computer. Its Available list installs servers from MCP registries |
| Config files | User: ~/.config/devin/mcp_config.json, or %APPDATA%\devin\mcp_config.json on Windows. Project: .devin/mcp_config.json. Private override inside a project: .devin/mcp_config.local.json, ignored by git |
| A remote entry | url is the one required field. transport, headers, oauthClientId, oauthClientSecret, oauthResource, oauthScopes, disabled and disabledTools are optional |
| Transports | stdio, Streamable HTTP and SSE. A url goes over Streamable HTTP first; SSE is tried on the same address only after a 4xx that is not about sign-in |
| Sign-in | OAuth with dynamic client registration. A 401 carrying a WWW-Authenticate challenge is treated as a request to sign in, and the server URL travels as the OAuth resource |
| Static keys | A token for a remote server goes in headers. ${env:VAR} and ${file:/path} keep the secret itself out of the file |
| Tool names | mcp__<server>__<tool>. By that pattern the Shopify read tool would be mcp__ryze__shopify__read; this guide did not see the name in Windsurf |
| Approval | Devin Local asks before every MCP tool call. A grant covers one tool or the whole server, for the session or for good |
| Rules and modes | Allow, Deny and Ask rules in Devin Local settings take patterns such as mcp__ryze__*, and deny wins. Bypass Permissions mode skips the prompts unless the organization requires approval |
| Where servers are managed | The This computer list (switch on or off, open the config file, refresh) and, since November 8, 2026, the "..." menu of a session header. Each server logs to its own MCP: <server> channel |
| Admin controls | Allow MCP, MCP allowlist, MCP registry and MCP registry URLs, labeled Teams & Enterprise. A single allowlisted server shuts out every other one |
| Plan | Plans are Free, Pro, Max, Teams and Enterprise. None is named for adding an MCP server |
| JetBrains plugin | Windsurf Plugins for JetBrains add servers under Settings > Tools > Windsurf Settings > Add Server. Cognition says that plugin is in maintenance mode |
Sources: Devin Desktop: MCP and customizations, Devin CLI: MCP configuration, Devin CLI: MCP overview, Devin CLI: config file, Devin CLI: read config from other tools, Devin Local permissions, Devin Local modes, Devin Desktop admin controls, Devin Desktop usage and plans, Devin Desktop FAQ, Windsurf Plugins MCP page. Checked November 14, 2026.
Other clients
The same URL works in other MCP clients. Shopify is connected once in Ryze AI, so nothing changes on the Shopify side.
Claude Code
Run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then /mcp inside Claude Code to sign in.
Claude on the web and Desktop
Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter the URL. In Claude you can set write and delete tools to Needs approval under Customize > Connectors > Ryze AI.
Codex
Run codex mcp add ryze --url https://connector.get-ryze.ai/mcp, then codex mcp login ryze.
Cursor
Add the server to ~/.cursor/mcp.json or .cursor/mcp.json.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Shopify access and Windsurf settings
Two sign-ins are involved: Shopify for store access and Ryze AI for the connector. Three things decide what the Windsurf agent can reach.
- Which store
- The store you connected in Ryze AI. You can connect several stores to one workspace; the agent uses the primary store unless you name another one, and the tools accept an optional connection_id.
- Which connection type
- The default Ryze AI Shopify app covers products, collections, pages, blogs, metaobjects, SEO fields and orders. Theme file edits, URL redirects and customer records need your own custom app, connected on the Custom app tab with your Client ID and Client secret.
- Approvals in Windsurf
- By default Devin Desktop asks for approval before the agent calls any MCP tool. Approvals set in Ryze AI chat, such as Skip all approvals, apply to the Ryze AI chat and not to Windsurf.
- Team rules
- On Teams and Enterprise, admins manage MCP registries and the MCP allowlist under MCP & ACP in team settings, which can block or approve the Ryze AI server for everyone.
Access behind each action
What the Shopify tools can do depends on the scopes the store connection has. The table lists what Ryze AI documents for each connection type.
| Action in Ryze AI | Shopify access |
|---|---|
| Read products, collections, pages, blogs, metaobjects and SEO fields | Default Shopify app connection |
| Read orders | Default connection, last 60 days only; older orders need a custom app with the read_all_orders scope |
| Create and update product, collection, page and blog content and SEO fields | Default Shopify app connection |
| Edit theme files such as robots.txt or theme.liquid, and URL redirects | Your own custom app only |
| Customer records | Your own custom app with that scope only |
The 13 Shopify access scopes of the default connection
Windsurf itself only holds a Ryze AI sign-in. The Shopify access stays with the Ryze AI Shopify app, which held 13 access scopes on a development store on November 13, 2026. Here is the full list, with what Shopify says each scope covers.
| Scope | What Shopify says it covers | With Ryze AI |
|---|---|---|
| read_products, write_products | Products, variants, collections and selling plans | Read and edit |
| read_content, write_content | Pages, blogs, articles and comments | Read and edit |
| read_metaobjects, write_metaobjects | Metaobjects | Read and edit |
| read_publications, write_publications | Publishing products and collections to sales channels | Read and edit |
| read_themes, write_themes | Online store themes. Shopify asks for an exemption on top of write_themes before an app may change theme files | Read. Theme file edits go through your own custom app |
| read_orders | Orders, fulfilments and abandoned checkouts created in the last 60 days | Read only |
| read_reports | ShopifyQL analytics queries | Read only |
| read_analytics | Analytics data. Shopify's current scope list no longer describes this scope | Read only |
Not on the list: read_customers, read_discounts, read_all_orders and write_orders. Customer records, discounts and orders older than 60 days therefore need your own custom app, and order changes such as refunds are not available on the default connection.
Sources: Shopify access scopes, Ryze AI Shopify guide. Checked November 13, 2026.
Removing access
Inside Windsurf you have four options: turn the ryze toggle off under Customize > MCPs, add "disabled": true to the entry so its tools disappear, delete the entry from mcp_config.json, or run devin mcp remove ryze. Running devin mcp logout ryze forgets the saved sign-in and keeps the server. To end Shopify access as well, disconnect the store from the Shopify card in Ryze AI.
What Windsurf can do in Shopify
The Ryze AI connector exposes 5 Shopify tools: 2 read, 2 write and 1 delete. Writes and deletes are separate tools, so you can approve them separately. By Cognition's naming pattern, Devin shows each one as mcp__ryze__ followed by the name below.
| 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 of the store connection. |
| 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. |
Approvals in Windsurf
Devin Desktop asks before calling any MCP tool by default, so reads and changes both prompt until you change that. Loosening it for the ryze server also removes the prompt in front of the write and delete tools, so allow only what you need. Scheduled tasks in Ryze AI run without an approval step, and the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals.
To keep the delete tool out of reach, add a Deny rule for mcp__ryze__shopify__delete in Devin Local settings, or list shopify__delete under disabledTools in the ryze entry. Both follow Cognition's documentation and were not tried in Windsurf.
Limits in numbers
| Limit | Number |
|---|---|
| Shopify request budget | Counted in cost points, per app and per store: 100 points per second on standard plans, 200 on Advanced Shopify, 1,000 on Shopify Plus and 2,000 on Shopify for enterprise. |
| One query | At most 1,000 points, on every plan. |
| What things cost | An object costs 1 point and a change costs 10. A list costs more the more items you ask for. |
| Lists | An input list takes up to 250 items. Paging through a list stops at 25,000 objects. |
| After a throttle | Shopify recommends waiting one second before the next request. |
| Seen in the test | A development store had a budget of 2,000 points that refilled at 100 points per second. A Shopify Plus store had 20,000 points that refilled at 1,000 per second. |
| Size of one tool call | The read tool accepts a query of up to 50,000 characters. |
| Orders | The last 60 days on the default connection. Older orders need a custom app with the read_all_orders scope. |
Some limits apply in every client. Full-catalog bulk exports (bulkOperationRunQuery) cannot be downloaded through the tools. Missing Admin API scopes are not worked around; the agent reports the missing scope. Cognition's pages read on November 14, 2026 give no cap on the number of MCP servers or tools in Devin Local.
Sources: Shopify GraphQL Admin API rate limits, Shopify API limits, Shopify access scopes. Checked November 13, 2026.
What the default connection can read, tested
These are the calls behind this guide, sent on November 13, 2026 to a Shopify development store with Shopify's sample snowboard catalog. They went through the default connection from Claude Code, a different MCP client on the same connector that Windsurf uses. The cost is what Shopify charged against the store's budget of 2,000 points.
| What was asked | What came back | Cost in points |
|---|---|---|
| All products with SEO title and description | 17 products. 15 had both SEO fields empty | 7 |
| All collections with SEO title and description | 3 collections. All 3 had both SEO fields empty | 4 |
| Pages, blogs and blog articles | 2 pages, 1 blog and 0 articles | 15 |
| All products with every variant | 17 products with 26 variants. Shopify estimated 156 points and charged 5 | 5 |
| Number of orders | 0, as an exact count. The test store has no orders | 10 |
| The first inventory item | Returned | 3 |
| Themes | 3 themes, one of them live | 4 |
| The installed app and its access scopes | The app Ryze AI with 13 scopes | 3 |
| Customers | Refused with "Access denied for customers field." | 2 |
| Discounts | Refused. The app needs the read_discounts scope | 2 |
A search in the description of one product for the word snowboard through shopify__search_content returned 1 match, on line 1. The two write tools and the delete tool were not run, because they change the store.
First 3 prompts to run
Answers come from your own store, so each prompt says what comes back and shows no sample numbers. Replace the handles and phrases with your own.
1. Find products with missing SEO fields
Read my Shopify products and list the ones whose SEO title or SEO description is empty. Show the product title and handle for each.
Tools used: shopify__read
What comes back: A list of product titles and handles with the empty SEO fields marked. Nothing is changed.
2. Fix a phrase inside a long description
Search the description of the product with handle my-product-handle for the phrase old phrase and show me the matching lines. Then replace it with new phrase.
Tools used: shopify__search_content, shopify__edit_content
What comes back: The matching lines with line numbers, then a single in-place edit to that text field once you approve the tool call in Windsurf.
3. Update a collection SEO title
Update the SEO title of my collection with handle my-collection-handle to the text I give you, and confirm the new value after the change.
Tools used: shopify__read, shopify__write
What comes back: A collection update through a write mutation, then a read of the field so you can compare it with what you asked for.
The first prompt matches a call that ran on November 13, 2026. The second and third change data and were not run, so this page describes what comes back and shows no result for them. Keep Windsurf's approval prompt on for the ryze server when you try them.
10 jobs to hand to the Windsurf agent
Ten jobs to give the Devin Local agent, each tied to the tool it would use. The first seven match calls that ran on November 13, 2026; the two jobs that change the store did not run. A job that changes something waits for your click in Windsurf unless you allowed the tool.
| Job | Ask the agent | Tool | Works on the default connection |
|---|---|---|---|
| SEO audit of products | List every product whose SEO title or SEO description is empty. | shopify__read | Yes |
| SEO audit of collections | List every collection with its SEO title and description, and mark the empty ones. | shopify__read | Yes |
| Content inventory | List my pages, blogs and blog articles with their handles, and say which are published. | shopify__read | Yes |
| Variant check | List every product with its variants and flag the products that have only a default variant. | shopify__read | Yes |
| Order count | How many orders does the store show? | shopify__read | Yes, for the last 60 days |
| Access check | Which Shopify access scopes does this connection have? | shopify__read | Yes |
| Find a phrase | Search the description of the product with handle my-product-handle for a phrase and show the matching lines. | shopify__search_content | Yes |
| Fix a phrase | Replace that phrase in the description and show me the line before and after. | shopify__edit_content | Yes, after you approve the call in Windsurf |
| Fill SEO fields | Set the SEO title and description of these products to the text I give you, then read them back. | shopify__write | Yes, after you approve the call in Windsurf |
| Discount list | List my active discount codes. | shopify__read | No. It needs a custom app with the read_discounts scope |
5 ways to connect Windsurf to Shopify
Five ways reach a Shopify store from Windsurf. This guide uses the first one, the Ryze AI connector, as the main way: Devin Desktop needs one url entry, the store is approved once inside Ryze AI, and no Shopify app of your own is involved. Of the other four, only Zapier's quickstart lists Windsurf by name. For the rest the setup cell describes the route by Devin's file format, because the vendor pages read for this guide give no Windsurf steps. None of the five was run in Windsurf.
| Way | Runs where | Setup in Windsurf | What it reaches in the store | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI at one address | One url entry named ryze in mcp_config.json, or devin mcp add -s user ryze with the address. Sign in with Authenticate in Devin Desktop or devin mcp login ryze in Devin CLI | Products, collections, pages, blogs, metaobjects and SEO fields, to read and to edit. Orders from the last 60 days, to read. Deletes go through a separate tool | Paid Ads is $89 per month with a 7-day free trial |
| Shopify AI Toolkit and Dev MCP server | On your computer | Shopify's install lines name Claude Code, Codex, Antigravity, Cursor, VS Code and OpenClaw, not Windsurf. The Dev MCP server runs as npx -y @shopify/dev-mcp@latest, and Devin Local supports stdio servers. Needs Node.js 18 or higher | Shopify's developer docs and API schemas. The Dev MCP server holds no store data. The Toolkit's separate CLI connector can read and change store data, and its help page names Claude Code, Codex, Cursor and Visual Studio Code | Shopify's pages state no price |
| Composio | Hosted | Composio's address is https://connect.composio.dev/mcp, with a browser authorization. The Composio pages read for this guide give Cursor steps; a url entry in mcp_config.json would be the Devin form | Composio lists 376 Shopify tools and 45 triggers | The free plan stops at 10,000 tool calls a month. Standard is $18 per seat per month |
| Zapier MCP | Hosted | Windsurf is on the quickstart's list of MCP clients. Add Zapier as a connector in the client and sign in; Zapier turns on actions for the apps already connected to your Zapier account | The Shopify actions of your Zapier account (20 triggers and 38 actions by count on Zapier's Shopify MCP page) | Each successful tool call uses two tasks from your Zapier plan |
| GeLi2001/shopify-mcp, open source | A Node process you run | A stdio entry that runs npx shopify-mcp with the Client ID and Client secret of your own Shopify custom app plus the .myshopify.com domain. Needs Node.js 18 or higher | 31 tools: products 8, customers 8, orders 10, metafields 3, inventory 1, tags 1 | Free, MIT licence. 239 GitHub stars, last update April 5, 2026 |
Two Shopify options that do not fit this job
- Shopify's connectors for merchants. Shopify's help center lists a plugin or connector for ChatGPT, Claude, Gemini, Grok, Perplexity, Muse and Microsoft Copilot. Windsurf is not on that list.
- Shopify's UCP servers at https://{shop}/api/ucp/mcp. They serve catalog search, cart and checkout to shopping agents and need an agent profile in every request. They do not edit a store. Shopify's migration page says the older Storefront MCP catalog and cart tools on https://{shop}/api/mcp were removed.
Which one to pick
Ryze AI is the best way to connect Windsurf to Shopify for store content and SEO work, with one caveat: theme files, URL redirects and customer records need your own custom app, and the full catalog cannot be exported in bulk. Add the Dev MCP server when the agent is writing a Shopify app or theme and needs the API schemas; Devin reads several named servers from one config file, so adding it leaves ryze in place. Composio and Zapier make sense when your team already uses one of them for other apps. The open-source server suits you when you need order actions such as refunds or fulfilment and can keep a custom app of your own.
Sources: Shopify AI Toolkit, Shopify CLI connector, Shopify help center on AI tools, Shopify Storefront MCP migration, Composio Shopify toolkit, Composio pricing, Zapier MCP quickstart, Zapier Shopify MCP, GeLi2001/shopify-mcp, Devin Desktop: MCP and customizations, Ryze AI Shopify guide. Checked November 13, 2026.
Windsurf, Shopify and MCP: dates that matter
| Date | What happened |
|---|---|
| February 13, 2025 | Windsurf Wave 3 brought MCP servers to Cascade, on individual plans first (Cognition launch post). |
| March 20, 2025 | Shopify published the first version of its Dev MCP server, @shopify/dev-mcp 1.0.0. |
| July 17, 2025 | Windsurf 1.11.0 added the Streamable HTTP transport and MCP authentication in place of access tokens or API keys in the config. |
| April 22, 2026 | Shopify's Storefront Catalog MCP began to follow the Universal Commerce Protocol (UCP), with the tools search_catalog, lookup_catalog and get_product. The older search and lookup tools were kept until June 15, 2026. |
| June 2, 2026 | Windsurf became Devin Desktop (v3.0.12). |
| June 24, 2026 | Shopify announced that the Storefront MCP cart tools give way to the UCP Cart MCP tools. The older cart tools were kept until August 31, 2026. |
| July 29, 2026 | Devin Desktop 3.6.22 gave servers that need authorization an Authenticate button. |
| September 8, 2026 | Devin Desktop 3.9.19 removed Cascade, leaving Devin Local as the only built-in agent. |
| October 27, 2026 | @shopify/dev-mcp 1.18.0 came out. It was still the newest version on November 13, 2026. |
| November 8, 2026 | Devin Desktop 3.12.32 put each session's MCP servers in the "..." menu of the session header. |
Sources: Devin Desktop changelog, Cognition: Windsurf Wave 3, Cognition: Windsurf is now Devin Desktop, @shopify/dev-mcp on npm, Shopify changelog, April 22, 2026, Shopify changelog, June 24, 2026. Checked November 13, 2026.
How this guide was tested
Two kinds of checks stand behind this guide: the connector's sign-in answer and Shopify calls through the connector, both on November 13, 2026. Each row names what was run and what came back.
| What was run | What came back |
|---|---|
| The connector address, without signing in | A request to https://connector.get-ryze.ai/mcp came back as HTTP 401 with a WWW-Authenticate header that points to the sign-in details. Cognition's reference says Devin reports such a 401 as a sign-in request instead of falling back to SSE. |
| The sign-in details | Both discovery files on the connector's host loaded. They name the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and two scopes: mcp:read and mcp:write. |
| The tool list in a signed-in MCP client | Five Shopify tools, under the names in the tools table above. |
| shopify__read on a Shopify development store | One call returned all 17 products with their SEO title and description: 15 had both fields empty. It cost 7 points, with 16 requested. |
| Nine more reads through the default connection | Seven worked and two were refused, as listed in the table of tested calls above. |
| shopify__search_content on one product description | One match, on line 1. |
| Access scopes of the connection | The app Ryze AI with 13 scopes, listed above. |
| Calls made to fail on purpose | Three: a query that was too large, a field that does not exist and a change sent to the read tool. Their messages are in the errors table below. |
Not run for this guide: any step inside Windsurf. Neither Devin Desktop nor Devin CLI was opened, so the mcp_config.json entry, the Authenticate button, devin mcp add, devin mcp login and the approval card are described from Cognition's documentation as it read on November 14, 2026. The signed-in client for the tool list and the reads was Claude Code, which reaches the same server and the same five tools. The write and delete tools were not run, because they change the store.
Windsurf and Shopify errors and fixes
Exact error messages from the test
These are the exact messages Shopify and the connector returned in the test on November 13, 2026. If the Devin Local agent shows one of them, the row says what went wrong and what to ask next.
| Message | What it means | What to do in Windsurf |
|---|---|---|
| Access denied for customers field. | The default connection does not ask Shopify for customer data. | Connect the store with your own custom app that has the read_customers scope. |
| Access denied for discountNodes field. Required access: Apps must have `read_discounts` access scope. | Discounts are outside the 13 scopes of the default connection. | Use a custom app with the read_discounts scope. |
| Query cost is 1729, which exceeds the single query max cost limit (1000). | One query asked for too much at once. In the test it asked for 250 products, 250 variants of each and 250 metafields of each variant. Shopify's code for this is MAX_COST_EXCEEDED. | Ask the agent to fetch fewer items per page, or to split the question in two. |
| Field 'seoTitle' doesn't exist on type 'Product' | The assistant guessed a field name that Shopify does not have. The SEO fields sit under seo, as title and description. | Nothing was read or changed. Ask again, or tell the agent to use the seo field. |
| This is a write operation | A change was sent to the read tool. It refuses the call and names the write tool. | Let the agent repeat the call with shopify__write and approve it when Windsurf asks. |
Other problems
- The server shows Needs authentication
- Click Authenticate in the MCPs list to run the browser authorization again. In Devin CLI, run devin mcp logout ryze and then devin mcp login ryze, and click Allow connection.
- Nothing happens after adding the server
- Refresh the MCP list in Customize, MCPs. Check that the entry sits under mcpServers and the JSON is valid. Running devin mcp list shows what the CLI reads.
- The server works in one project only
- A .devin/mcp_config.json entry applies to that repository. Put the server in ~/.config/devin/mcp_config.json for every project.
- The server stays disconnected on a team account
- When an admin keeps an MCP allowlist, every server outside it fails to connect and its tools are missing. Ask the admin to add the Ryze AI server to the allowlist.
- The agent is off in this folder
- A workspace opened in Restricted Mode has Devin Local and every ACP agent disabled, so the Ryze AI tools cannot run there.
- The Shopify tools do not appear
- If Shopify was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new session so the tool list refreshes.
- Shopify does not accept the store domain
- Use the .myshopify.com domain, not your custom domain, on the Shopify app tab in Ryze AI.
- A theme file or redirect edit fails
- Theme file edits such as robots.txt or theme.liquid and URL redirects are not available on the default connection. Connect with your own custom app on the Custom app tab.
- Customer data or old orders are missing
- Customer records are not requested by the default connection, and orders older than 60 days stay hidden unless the custom app has the read_all_orders scope.
- The agent reports a missing scope
- Missing Admin API scopes are not worked around. Add the scope to your custom app, release and reinstall it, then retry.
- 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.
- The agent reports that a subscription is required
- The Shopify tools run only on an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
Terms on this page
- Devin Local
- The agent inside Windsurf (Devin Desktop) that calls MCP tools. It took over from Cascade.
- mcp_config.json
- Devin's MCP file. Each server is a named entry under mcpServers; this guide names the entry ryze.
- Access scope
- A named permission in Shopify, such as read_products. An app can do only what its scopes allow.
- Admin GraphQL API
- The Shopify interface the read and write tools send queries and mutations to.
- Cost points
- Shopify's unit for how heavy a request is. A store gives each app a budget of points that refills every second.
- Development store
- A Shopify store made for testing. The results on this page come from one that holds Shopify's sample products.
- Custom app
- A Shopify app you create yourself in the Shopify Dev Dashboard, for access the default Ryze AI app does not request.
Sources: Devin Local overview, Shopify access scopes, Shopify GraphQL Admin API rate limits, Model Context Protocol. Checked November 14, 2026.
Frequently asked questions
How do I connect Windsurf to Shopify?
Connect your store in Ryze AI under Integrations by entering the .myshopify.com domain and approving the prompt in Shopify admin. Then add a ryze entry with the url https://connector.get-ryze.ai/mcp to mcp_config.json (or run devin mcp add -s user ryze with the address in Devin CLI), click Authenticate and sign in on the Ryze AI page.
Is there a Shopify MCP server for Windsurf?
Yes. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 5 Shopify tools that work on your connected store. Shopify's own Dev MCP server has developer docs and API schemas but no store data, and Shopify's pages name no Windsurf steps for it. Composio, Zapier and an open-source server are further options.
What is the Shopify MCP server URL for Windsurf?
For the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user. Shopify's Dev MCP server has no address: it runs on your computer with npx -y @shopify/dev-mcp@latest. Shopify's shopping servers use https://{shop}/api/ucp/mcp, with your store domain in place of {shop}.
Is there a Windsurf Shopify connector?
The Ryze AI connector is the one built for it: a single hosted MCP address with 5 Shopify tools, added to Windsurf as a url entry. Shopify's own merchant connectors list ChatGPT, Claude, Gemini, Grok, Perplexity, Muse and Microsoft Copilot, and Windsurf is not among them.
Is Windsurf the same as Devin Desktop?
Yes. Windsurf became Devin Desktop on June 2, 2026, and its MCP documentation now lives on docs.devin.ai. Devin Local replaced Cascade as the agent that calls MCP tools. The steps on this page use the current Devin menus and file paths.
Does Shopify have an official MCP server?
Yes, several, for different jobs. The Dev MCP server gives coding tools Shopify's developer docs and API schemas. The UCP servers serve catalog, cart and checkout to shopping agents. For store management Shopify offers connectors for ChatGPT, Claude, Gemini, Grok, Perplexity, Muse and Microsoft Copilot, and a CLI connector for developers that supports Claude Code, Codex, Cursor and Visual Studio Code.
Can Windsurf edit my Shopify products?
Yes. Through Ryze AI, the Windsurf agent can create and update product, collection, page and blog content and SEO fields with the write tool, and edit part of a long text field with the edit tool. It cannot edit theme files or redirects on the default connection.
Can Windsurf delete Shopify resources?
Only through the separate shopify__delete tool. The write tool rejects delete, remove, cancel and deactivate mutations. Devin Local asks before calling MCP tools by default, and you can add a Deny rule for the delete tool.
Which Windsurf plan do I need?
Cognition's MCP documentation names no plan. On Teams and Enterprise, admins manage MCP registries and the MCP allowlist under MCP & ACP in team settings, which can block a server for everyone.
Do I need a Shopify custom app?
Not for the default connection, which uses the Ryze AI Shopify app and an approval in Shopify admin. You need your own custom app for theme file edits, URL redirects, customer records or orders older than 60 days.
Can I connect more than one Shopify store?
Yes. Several stores can be connected to one workspace, and the agent uses the primary store unless you name another one. A single store can be live in only one Ryze AI workspace at a time.
Why do the Shopify tools not show up in Windsurf?
If you connected Shopify in Ryze AI after adding the server, remove the ryze entry from Windsurf, add it again and start a new session so the tool list refreshes. If the list shows Needs authentication, click Authenticate.
How much does it cost to connect Windsurf to Shopify?
Adding the connector costs nothing, but the Shopify tools need an active Ryze AI 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, 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 Windsurf?
Turn the ryze server off under Customize, MCPs, delete its entry from mcp_config.json or run devin mcp remove ryze. To end Shopify access as well, disconnect the store from the Shopify card in Ryze AI.
Sources
- Devin Desktop: MCP and customizations
- Devin CLI: MCP configuration
- Devin CLI: MCP overview
- Devin CLI: config file
- Devin CLI: read config from other tools
- Devin Local permissions
- Devin Local modes
- Devin Desktop admin controls
- Devin Desktop usage and plans
- Devin Desktop FAQ
- Windsurf Plugins MCP page
- Devin Desktop changelog
- Shopify AI Toolkit
- Shopify CLI connector
- Shopify help center on AI tools
- Shopify Storefront MCP migration
- Shopify access scopes
- Shopify GraphQL Admin API rate limits
- Shopify API limits
- Composio Shopify toolkit
- Composio pricing
- Zapier MCP quickstart
- GeLi2001/shopify-mcp
- Ryze AI help center: Shopify
Shopify pages checked November 13, 2026; Windsurf and Devin pages checked November 14, 2026.