How to connect Windsurf to Shopify

Connect your Shopify store once in Ryze AI, add one MCP URL to the Windsurf (Devin Desktop) MCP config, sign in, then ask the editor agent about products, collections, pages and blog articles.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the URL. Use it in Customize, MCPs, or with devin mcp add. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, find Shopify and click Connect, then enter your .myshopify.com domain
  2. Approve the access prompt in your Shopify admin
  3. In Windsurf open Customize, then MCPs, and add the ryze server with the connector URL
  4. 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

FactDetail
Main way to connectThe 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 addresshttps://connector.get-ryze.ai/mcp. The same entry also carries the other platforms connected in the Ryze AI workspace
Windsurf in November 2026Shipped as Devin Desktop since June 2, 2026. Devin Local is the agent that calls MCP tools; Cascade was removed on September 8, 2026
Sign-inShopify 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 tools5 in total: 2 read, 2 write, 1 delete
Can it change the storeYes. 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 chatGoogle Ads, Meta Ads, GA4 and Search Console tools, when those platforms are connected in the same Ryze AI workspace
Windsurf plan neededCognition'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 pricePaid Ads at $89 per month after a 7-day free trial. Adding the connector costs nothing
Shopify's own option for WindsurfNone 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 connection13 access scopes on the default app. Customer records, discounts and orders older than 60 days are not among them
Last testedShopify 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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 ryze

The 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

TopicWhat Cognition's documentation says
Where you add a serverThe 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 filesUser: ~/.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 entryurl is the one required field. transport, headers, oauthClientId, oauthClientSecret, oauthResource, oauthScopes, disabled and disabledTools are optional
Transportsstdio, 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-inOAuth 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 keysA token for a remote server goes in headers. ${env:VAR} and ${file:/path} keep the secret itself out of the file
Tool namesmcp__<server>__<tool>. By that pattern the Shopify read tool would be mcp__ryze__shopify__read; this guide did not see the name in Windsurf
ApprovalDevin Local asks before every MCP tool call. A grant covers one tool or the whole server, for the session or for good
Rules and modesAllow, 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 managedThe 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 controlsAllow MCP, MCP allowlist, MCP registry and MCP registry URLs, labeled Teams & Enterprise. A single allowlisted server shuts out every other one
PlanPlans are Free, Pro, Max, Teams and Enterprise. None is named for adding an MCP server
JetBrains pluginWindsurf 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 AIShopify access
Read products, collections, pages, blogs, metaobjects and SEO fieldsDefault Shopify app connection
Read ordersDefault 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 fieldsDefault Shopify app connection
Edit theme files such as robots.txt or theme.liquid, and URL redirectsYour own custom app only
Customer recordsYour 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.

ScopeWhat Shopify says it coversWith Ryze AI
read_products, write_productsProducts, variants, collections and selling plansRead and edit
read_content, write_contentPages, blogs, articles and commentsRead and edit
read_metaobjects, write_metaobjectsMetaobjectsRead and edit
read_publications, write_publicationsPublishing products and collections to sales channelsRead and edit
read_themes, write_themesOnline store themes. Shopify asks for an exemption on top of write_themes before an app may change theme filesRead. Theme file edits go through your own custom app
read_ordersOrders, fulfilments and abandoned checkouts created in the last 60 daysRead only
read_reportsShopifyQL analytics queriesRead only
read_analyticsAnalytics data. Shopify's current scope list no longer describes this scopeRead 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.

ToolTypeWhat it does
shopify__readReadRuns a read-only Shopify Admin GraphQL query against the connected store. What it returns depends on the scopes of the store connection.
shopify__search_contentReadSearches 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__writeWriteRuns 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_contentWriteMakes 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__deleteDeleteRuns 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

LimitNumber
Shopify request budgetCounted 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 queryAt most 1,000 points, on every plan.
What things costAn object costs 1 point and a change costs 10. A list costs more the more items you ask for.
ListsAn input list takes up to 250 items. Paging through a list stops at 25,000 objects.
After a throttleShopify recommends waiting one second before the next request.
Seen in the testA 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 callThe read tool accepts a query of up to 50,000 characters.
OrdersThe 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 askedWhat came backCost in points
All products with SEO title and description17 products. 15 had both SEO fields empty7
All collections with SEO title and description3 collections. All 3 had both SEO fields empty4
Pages, blogs and blog articles2 pages, 1 blog and 0 articles15
All products with every variant17 products with 26 variants. Shopify estimated 156 points and charged 55
Number of orders0, as an exact count. The test store has no orders10
The first inventory itemReturned3
Themes3 themes, one of them live4
The installed app and its access scopesThe app Ryze AI with 13 scopes3
CustomersRefused with "Access denied for customers field."2
DiscountsRefused. The app needs the read_discounts scope2

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.

JobAsk the agentToolWorks on the default connection
SEO audit of productsList every product whose SEO title or SEO description is empty.shopify__readYes
SEO audit of collectionsList every collection with its SEO title and description, and mark the empty ones.shopify__readYes
Content inventoryList my pages, blogs and blog articles with their handles, and say which are published.shopify__readYes
Variant checkList every product with its variants and flag the products that have only a default variant.shopify__readYes
Order countHow many orders does the store show?shopify__readYes, for the last 60 days
Access checkWhich Shopify access scopes does this connection have?shopify__readYes
Find a phraseSearch the description of the product with handle my-product-handle for a phrase and show the matching lines.shopify__search_contentYes
Fix a phraseReplace that phrase in the description and show me the line before and after.shopify__edit_contentYes, after you approve the call in Windsurf
Fill SEO fieldsSet the SEO title and description of these products to the text I give you, then read them back.shopify__writeYes, after you approve the call in Windsurf
Discount listList my active discount codes.shopify__readNo. 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.

WayRuns whereSetup in WindsurfWhat it reaches in the storePrice
Ryze AI connector (the main way)Hosted by Ryze AI at one addressOne 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 CLIProducts, 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 toolPaid Ads is $89 per month with a 7-day free trial
Shopify AI Toolkit and Dev MCP serverOn your computerShopify'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 higherShopify'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 CodeShopify's pages state no price
ComposioHostedComposio'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 formComposio lists 376 Shopify tools and 45 triggersThe free plan stops at 10,000 tool calls a month. Standard is $18 per seat per month
Zapier MCPHostedWindsurf 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 accountThe 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 sourceA Node process you runA 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 higher31 tools: products 8, customers 8, orders 10, metafields 3, inventory 1, tags 1Free, 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

DateWhat happened
February 13, 2025Windsurf Wave 3 brought MCP servers to Cascade, on individual plans first (Cognition launch post).
March 20, 2025Shopify published the first version of its Dev MCP server, @shopify/dev-mcp 1.0.0.
July 17, 2025Windsurf 1.11.0 added the Streamable HTTP transport and MCP authentication in place of access tokens or API keys in the config.
April 22, 2026Shopify'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, 2026Windsurf became Devin Desktop (v3.0.12).
June 24, 2026Shopify 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, 2026Devin Desktop 3.6.22 gave servers that need authorization an Authenticate button.
September 8, 2026Devin 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, 2026Devin 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 runWhat came back
The connector address, without signing inA 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 detailsBoth 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 clientFive Shopify tools, under the names in the tools table above.
shopify__read on a Shopify development storeOne 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 connectionSeven worked and two were refused, as listed in the table of tested calls above.
shopify__search_content on one product descriptionOne match, on line 1.
Access scopes of the connectionThe app Ryze AI with 13 scopes, listed above.
Calls made to fail on purposeThree: 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.

MessageWhat it meansWhat 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 operationA 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

Shopify pages checked November 13, 2026; Windsurf and Devin pages checked November 14, 2026.

Connect Shopify to Windsurf

Your store connects once in Ryze AI, then Windsurf reads and edits product, collection, page and blog content through 5 Shopify tools. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Shopify MCP server

Need help? Read the Ryze AI Shopify guide or email Ryze AI support.