By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Hermes Agent to Shopify is the Ryze AI connector. Connect your .myshopify.com store in Ryze AI, add a ryze entry with the URL https://connector.get-ryze.ai/mcp and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login ryze and click Allow connection. Start a new session and ask about your store.
- In Ryze AI open Integrations, click Connect on Shopify, enter your .myshopify.com domain and approve the access prompt
- Add the ryze entry to mcp_servers in ~/.hermes/config.yaml
- Run hermes mcp login ryze and click Allow connection
- Start a new session or run /reload-mcp, then ask your first Shopify question
Hermes Agent to Shopify at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a remote HTTP MCP server that Hermes Agent reads from one ryze entry under mcp_servers in ~/.hermes/config.yaml |
| Connector address | https://connector.get-ryze.ai/mcp, identical for every user |
| How Hermes Agent signs in | OAuth with auth: oauth, completed once with hermes mcp login ryze. A Ryze AI API key sent as a bearer header from ~/.hermes/.env is the alternative |
| What Shopify needs | The store's .myshopify.com domain and an approval in Shopify admin for the Ryze AI app. No API keys on the default route |
| Shopify tools | 5 in total: 2 that read, 2 that write and 1 that deletes |
| Changes to the store | Yes, through the write and edit tools, within the scopes of the Ryze AI app. Setting trust: untrusted on the ryze entry makes Hermes Agent ask before write-capable calls |
| Other data in the same chat | Google Ads, Meta Ads, GA4 and Search Console tools from the same URL, when those platforms are connected in the same workspace |
| Hermes Agent plan | None. Hermes Agent is open source under the MIT license per its GitHub repository and runs on your own machine or server |
| Ryze AI price | Paid Ads costs $89 per month after a 7-day free trial. Adding the connector costs nothing |
| Shopify's own option | The Shopify AI Toolkit page lists Hermes with an install script that adds a plugin, and a local Dev MCP server that holds developer docs and no store data |
| Last tested | Calls through the connector were run on November 13, 2026 from Claude Code on a development store. The steps inside Hermes Agent were not run |
Before you start
- Hermes Agent installed. It is open source from Nous Research, licensed MIT per its GitHub repository, and self-hosted, so there is no plan tier to buy. The configuration lives in ~/.hermes/config.yaml.
- A Shopify store you can approve an app on. You need the .myshopify.com domain, not your custom domain, and a login that can approve the Ryze AI app in Shopify admin. Theme file edits, URL redirects and customer records need your own custom app instead of the default one.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; SEO Starter ($129 per month, 3-day free trial) adds publishing Content Plan articles to a Shopify blog, and Agency is $279 per month. Connecting the connector is free, but the Shopify tools need an active plan or trial.
How to connect Hermes Agent to Shopify with OAuth
The first step happens in Shopify and Ryze AI, the rest in Hermes Agent. 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, then approve the access prompt in Shopify admin. You return to Ryze AI with the store connected.
Add the ryze entry to config.yaml
Open ~/.hermes/config.yaml and add a ryze server under mcp_servers. Editing the file inside a running session starts an automatic MCP reload with a 30-second timeout, which is too short for a browser sign-in, so add the entry and then run the login in the next step.
mcp_servers: ryze: url: "https://connector.get-ryze.ai/mcp" auth: oauthSign in to the connector
Run hermes mcp login ryze. Hermes Agent prints an authorize URL and opens your browser when it can. Sign in on the Ryze AI page, choose the workspace and click Allow connection. Hermes Agent caches the tokens at ~/.hermes/mcp-tokens/ryze.json and reuses them until a refresh fails.
Load the tools
Start a new session, or run /reload-mcp inside a running one. Hermes Agent registers each tool under the name mcp_<server>_<tool>, so the Shopify tools start with mcp_ryze_. To see what the server answers, run hermes mcp test ryze.
Ask your first question
Ask: List my products with their SEO title and description, and tell me which ones have both empty.
The Ryze AI help center page for Shopify covers the Shopify side of the connection, and the Ryze AI help article on API keys and the MCP endpoint covers the connector URL. The Ryze AI developers page lists the same URL.
Source for the Hermes Agent steps: Hermes Agent MCP documentation, opened November 20, 2026.
API key, tool filters and headless hosts
Hermes Agent keeps every MCP server in one file, ~/.hermes/config.yaml. These are the variations that matter for this connector.
A Ryze AI API key instead of OAuth
Create a key in Ryze AI under Workspace Settings > Profile > API keys > Create key and copy it, because it is shown once. Put RYZE_API_KEY with the rk_live_ key in ~/.hermes/.env and reference it in the header, since Hermes Agent resolves ${VAR} placeholders in headers from environment variables. Run /reload-mcp afterwards. The Shopify store stays connected inside Ryze AI, so no Shopify key is involved.
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
headers:
Authorization: "Bearer ${RYZE_API_KEY}"Show Hermes Agent only the read tools
Each server entry accepts tools.include and tools.exclude. This entry registers the two Shopify read tools and nothing else from the connector, which also hides the tools of every other platform in the workspace. It hides tools from Hermes Agent only. The Shopify app scopes are unchanged.
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauth
tools:
include:
- shopify__read
- shopify__search_contentA remote or headless host
When Hermes Agent runs on a server and your browser is on another machine, the local callback cannot reach the browser. The Hermes Agent documentation lists these ways around it: paste the redirect URL back at the prompt, forward the callback port with ssh -N -L, or complete the sign-in from the Desktop app or dashboard. A Ryze AI API key avoids the browser entirely.
hermes mcp login ryzeThe messaging gateway and unattended runs
A running gateway never opens a browser, so sign in with hermes mcp login ryze first. The documentation says the gateway watches config.yaml and connects a newly added entry within about a minute. A server whose first connect failed because no token was cached waits for a login.
Reloading and timeouts
The Hermes Agent pages read for this guide give no default for the length of a tool call. Hermes Agent waits for the browser sign-in for 5 minutes, and oauth.timeout on the entry makes it wait longer. connect_timeout on the entry bounds the first connection. Shopify prices each GraphQL query in points, so a wide catalog request can come back as an error and need a smaller page size.
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauth
oauth:
timeout: 600
connect_timeout: 60Hermes Agent and MCP: the facts in one table
| Topic | What the Hermes Agent documentation says |
|---|---|
| Where servers are added | ~/.hermes/config.yaml under mcp_servers, or with hermes mcp install for the catalog of Nous-approved servers |
| Transports | Local stdio servers (command and args) and remote HTTP servers (url) |
| Sign-in | auth: oauth does the browser sign-in. Hermes Agent identifies itself with a Client ID Metadata Document on servers that support one and falls back to dynamic client registration on those that do not. Static bearer headers also work |
| Token storage | ~/.hermes/mcp-tokens/<server>.json, written with 0600 permissions and reused until refresh fails |
| Tool names | mcp_<server_name>_<tool_name>, so a server named ryze registers its tools under names that start with mcp_ryze_ |
| Approval | A server entry can set trust: untrusted so that write-capable calls ask first. Tools annotated readOnlyHint stay unprompted. /yolo, --yolo and approvals.mode: off skip that prompt |
| Filtering | tools.include and tools.exclude per server, with glob patterns. enabled: false skips a server. hermes mcp configure opens a checklist of the tools |
| Reload | /reload-mcp, or a new session. Editing config.yaml inside a running CLI session reloads MCP with a 30-second timeout |
| Proxies | HTTP and SSE servers honor HTTPS_PROXY, HTTP_PROXY, ALL_PROXY and NO_PROXY |
| Plan | None. Open source, self-hosted |
Sources: Hermes Agent MCP documentation, NousResearch/hermes-agent on GitHub. Opened November 20, 2026.
Other clients
The same URL works in other MCP clients. The store 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, then sign in from /mcp. The store is connected once in Ryze AI, so the Shopify side does not change from client to client.
Claude and ChatGPT
In Claude open Customize > Connectors, choose Add custom connector and enter https://connector.get-ryze.ai/mcp. In ChatGPT the full custom MCP flow is for Business and Enterprise/Edu plans, and Pro users get read and fetch permissions only. If the connector was added before Shopify was connected, remove and re-add it, then start a new chat.
Codex and Cursor
Codex takes codex mcp add ryze --url https://connector.get-ryze.ai/mcp. Cursor reads the same URL from its mcp.json file. The Ryze AI developers page has the matching config for each.
Shopify scopes and Hermes settings
Two sign-ins are involved: an approval in Shopify admin for the Ryze AI app, and Ryze AI for the connector. Three things decide what Hermes Agent can reach.
- Which store
- The primary store, unless you name another. A workspace can hold several stores, and the tools accept an optional connection_id. A store can be live in only one Ryze AI workspace at a time.
- What Hermes Agent can change
- The scopes of the Shopify app behind the connection. The default Ryze AI app holds write scopes for products, content, metaobjects, themes and publications, and read scopes for orders, analytics and reports.
- What Hermes Agent asks first
- The trust, tools.include and tools.exclude settings on the ryze entry decide which tools Hermes Agent sees and when it asks first. They are client-side settings and do not change what the Shopify app may do.
The Shopify app and its scopes
On November 13, 2026 the Ryze AI app on a development store listed these 13 scopes through currentAppInstallation. The middle column follows Shopify's description of each scope.
| Scope | What Shopify says it covers | What Hermes Agent gets |
|---|---|---|
| read_products, write_products | Product, ProductVariant, Collection, ResourceFeedback, SellingPlan | Read and edit products, variants and collections, including their SEO fields |
| read_content, write_content | Article, Blog, Comment, Page | Read and edit pages, blogs and articles |
| read_metaobjects, write_metaobjects | Metaobject | Read and edit metaobjects |
| read_publications, write_publications | Publication fields and publishing mutations | Read and change where items are published |
| read_themes, write_themes | OnlineStoreTheme. Changing theme files needs an exemption in addition to write_themes | Read the list of themes. Ryze AI's help center says theme file edits need your own custom app, so do not expect them here |
| read_orders | AbandonedCheckout, Fulfillment, Order, OrderTransaction, for orders created within the last 60 days | Read recent orders |
| read_reports | shopifyqlQuery | Run ShopifyQL report queries |
| read_analytics | Not described in Shopify's current scope list | Granted to the app. Shopify's list gives no description |
Not part of the default connection: read_customers, read_discounts, read_all_orders and write_orders. A request for customers or discounts is refused, and orders older than 60 days stay hidden. Customer records, URL redirects and theme file edits need a custom app that you create in the Shopify Dev Dashboard and connect on the Custom app tab in Ryze AI.
Ryze AI says tokens refresh automatically, so there is no key to rotate on the default route. On the custom app route you enter the store domain, Client ID and Client secret of an app you own, and you choose its Admin API scopes.
Sources: Shopify access scopes. Checked November 13, 2026. The scope list comes from a read of the Ryze AI app on a development store, and what each scope allows comes from Shopify.
Removing access
To remove access, click View on the Shopify card in Ryze AI and disconnect the store, or uninstall the app in Shopify admin. In Hermes Agent, set enabled: false on the ryze entry or delete it from config.yaml, and delete ~/.hermes/mcp-tokens/ryze.json to drop the cached tokens.
What Hermes Agent can do in Shopify
The Ryze AI connector exposes 5 Shopify tools: 2 read, 2 write and 1 delete. In Hermes Agent the names appear with the mcp_ryze_ prefix.
| Tool | Type | What it does |
|---|---|---|
| shopify__read | Read | Runs a read-only Shopify Admin GraphQL query against the connected store. What comes back 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 Hermes Agent
In Hermes Agent, approval for MCP tools is set per server. Adding trust: untrusted to the ryze entry makes every write-capable call on that server ask first, and tools annotated readOnlyHint stay unprompted. The documentation names no default for an entry without a trust key, so set it explicitly if you want the prompt. /yolo, --yolo and approvals.mode: off skip the prompt. Whether the Ryze AI tools carry the readOnlyHint annotation was not checked, so expect prompts on some reads as well. Separately, the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals, and scheduled tasks run without an approval step.
mcp_servers:
ryze:
url: "https://connector.get-ryze.ai/mcp"
auth: oauth
trust: untrustedShopify limits in numbers
Shopify's figures in Shopify's own units. None was measured for this guide except the last two rows, which come from the connector test on November 13, 2026.
| Limit | Number |
|---|---|
| Request budget | GraphQL Admin API, per app and per store: Standard 100 points per second, Advanced Shopify 200, Shopify Plus 1,000, Shopify for enterprise 2,000 |
| One query | A single query may not exceed a cost of 1,000 points, regardless of plan |
| Costs | Objects 1 point, mutations 10, connections sized by first and last arguments, scalars 0 |
| Lists | Input arrays have a maximum size of 250. Pagination of arrays of objects caps at 25,000 objects |
| Backoff | Shopify's recommended backoff time is one second |
| Tool input | shopify__read accepts a query of up to 50,000 characters, from the tool definition seen on November 13, 2026 |
| Orders | read_orders covers orders created within the last 60 days. read_all_orders is needed for older ones |
| Budget seen on a development store | maximumAvailable 2,000 points with a restore rate of 100 per second. A Shopify Plus store showed 20,000 and 1,000 per second |
Sources: GraphQL Admin API rate limits, API usage limits, access scopes. Checked November 13, 2026.
Tested calls
Hermes Agent did not send these. On November 13, 2026 the same Ryze AI connector was called from Claude Code on a Shopify development store with Shopify's sample snowboard catalog, using the default Ryze AI app. The cost column is the points Shopify charged.
| What the query asked for | What the store returned | Points charged |
|---|---|---|
| All products with SEO title and description (shopify__read) | 17 products. 15 had both SEO fields empty and 2 had both: The Complete Snowboard and The Hidden Snowboard | 7 |
| All collections with SEO fields | 3 collections, all with both SEO fields empty | 4 |
| Pages, blogs and articles | 2 pages, 1 blog, 0 articles | 15 |
| All products with every variant | 17 products and 26 variants. 156 points were estimated | 5 |
| Orders count | 0, precision EXACT | 10 |
| Themes | 3 themes, one with the role MAIN | 4 |
| The app and its scopes (currentAppInstallation) | The app Ryze AI with 13 scopes | 3 |
| customers(first: 1) | Refused | 2 |
| discountNodes(first: 1) | Refused | 2 |
| shopify__search_content on the description of the-complete-snowboard for snowboard | 1 match, on line 1 | not listed |
The write and delete tools were not run, because they change the store.
First 3 prompts to run
Each answer comes from your own store, so this page describes what comes back instead of showing sample numbers. Hermes Agent picks the tool itself; the names are listed so you can check which one ran.
1. Find products with empty SEO fields
List every product with its title, handle, status, SEO title and SEO description, and mark the ones where either SEO field is empty.
Tools used: shopify__read
What comes back: A list of products from your own store as plain text in Hermes Agent. Nothing in Shopify is changed.
2. Check what a collection page says
Show each collection with its handle, the number of products in it and its SEO title and description.
Tools used: shopify__read
What comes back: One row per collection from your own store. It is a read, so nothing changes.
3. Rewrite one SEO description
Update the SEO description of the product with the handle I name here to a 150-character version that mentions what it is made of, and show me the old and new text.
Tools used: shopify__read, shopify__write
What comes back: A changed SEO description on one product, because the default app has write_products. With trust: untrusted on the ryze entry, Hermes Agent asks before the write runs.
When you want a change, describe it in plain words. Replace the names in the prompts with ones from your store.
10 jobs to hand to Hermes Agent
Ten jobs you can give Hermes Agent, each beside the tool that does the work. The last column is based on the default Ryze AI app and the scopes listed above.
| Job | Ask Hermes Agent | Tool | On the default connection |
|---|---|---|---|
| Product SEO audit | List every product whose SEO title or description is empty. | shopify__read | Yes |
| Collection SEO audit | Show the SEO title and description of every collection. | shopify__read | Yes |
| Content inventory | List the pages, blogs and articles in the store. | shopify__read | Yes |
| Variant overview | Give each product with the number of its variants. | shopify__read | Yes |
| Find a phrase in a long description | Search the description of one product for a word and show the matching lines. | shopify__search_content | Yes |
| Fix a phrase in place | Replace one phrase in a product description and leave the rest alone. | shopify__edit_content | Yes, with write_products |
| Update SEO fields | Set the SEO title and description on the products I list. | shopify__write | Yes, with write_products |
| Recent orders | Count the orders from the last 60 days. | shopify__read | Yes, within the 60-day window |
| Customer records | List my customers. | shopify__read | No. It needs a custom app with read_customers |
| Remove a product | Delete the test product I name here. I know this cannot be undone. | shopify__delete | Yes, and trust: untrusted makes Hermes Agent ask before the call |
6 ways to connect Hermes Agent to Shopify
Six ways to connect Hermes Agent to Shopify. This guide treats the Ryze AI connector as the main way: the store stays connected in Ryze AI, and Hermes Agent holds one address and a browser sign-in. Hermes Agent accepts any remote HTTP MCP server by url and any local server by command, and none of these routes was run in Hermes Agent.
| Way | Runs where | Setup in Hermes Agent | What it reaches in Shopify | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user | A ryze entry with url and auth: oauth, then hermes mcp login ryze. Or a bearer header with a Ryze AI API key read from ~/.hermes/.env | 5 tools on the connected store: Admin GraphQL reads, writes, in-place content edits and deletes, within the app scopes | Paid Ads is $89 per month with a 7-day free trial |
| Shopify AI Toolkit for Hermes | On your computer | Shopify's AI Toolkit page lists Hermes and gives an install script that adds a plugin. The page shows no MCP entry for Hermes and this guide did not run the script | The Toolkit holds developer docs and API schemas. What the Hermes plugin adds beyond that was not checked | No price stated on the page |
| Dev MCP server on its own | On your computer, started with npx | A command entry named shopify-dev-mcp with npx -y @shopify/dev-mcp@latest. Needs Node.js 18 or higher | Developer docs and API schemas. No store data and no authentication | Free to run |
| Composio | Hosted | A url entry for https://connect.composio.dev/mcp, then a browser authorization. Whether Composio's page names Hermes Agent was not checked | 376 tools and 45 triggers listed for Shopify | The free plan stops at 10,000 app tool calls a month. Standard is $18 per seat per month |
| Zapier MCP | Hosted | Add Zapier's MCP URL as a remote HTTP server and sign in. Hermes Agent is not named in the Zapier pages read for this guide | The Shopify actions of your Zapier account. Zapier's Shopify page lists 20 triggers and 38 actions | Each successful tool call uses two tasks from your Zapier plan |
| GeLi2001/shopify-mcp (open source) | A Node process you run | A command entry that runs npx shopify-mcp with your Client ID, Client secret and domain as arguments. Needs Node.js 18 or higher and a Shopify custom app | 31 tools: products 8, customers 8, orders 10, metafields 3, inventory 1, tags 1 | Free, MIT license. 239 GitHub stars, last push April 5, 2026 |
Ryze AI's older post, How to connect Google and Meta Ads with Hermes Agent, sets up Composio for ad platforms. It is a different route, and several servers can share config.yaml under different names. A ryze entry and a shopify-dev-mcp entry can sit side by side. With the Ryze AI connector your store data passes through Ryze AI.
Shopify options that do not fit Hermes Agent
- Shopify CLI connector. Shopify describes it for developers who work on a store from their own computer and names Claude Code, Codex, Cursor and Visual Studio Code. It does not name Hermes Agent.
- Shopify connectors for merchants. Shopify's help center lists a plugin for ChatGPT, a connector for Claude, Gemini, Grok, Muse and Perplexity, and a plugin for Microsoft Copilot. Hermes Agent is not on that list.
- UCP MCP servers. Shopify's servers at https://{shop}/api/ucp/mcp serve catalog, cart and checkout for shopping agents, need an agent profile on every request and do not edit a store. 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 Hermes Agent to Shopify when you want product, collection, page and SEO edits next to your ad and search tools behind a single address, with one caveat: it has 5 Shopify tools on the default app, with no customer, discount or theme file access unless you bring a custom app, and it needs a Ryze AI plan or trial. If you only need Shopify's developer docs while you build an app, the Dev MCP server is free and needs no sign-in. The open source shopify-mcp server reaches customers and orders but runs on your machine with your own app credentials. Composio and Zapier make sense if your team already runs them.
Sources: Shopify AI Toolkit and Dev MCP, Storefront and UCP MCP, Shopify CLI connector, connecting AI tools, Composio Shopify toolkit, Composio pricing, Zapier MCP for Shopify, shopify-mcp on GitHub, Hermes Agent MCP documentation. Checked November 13, 2026; Hermes Agent and Shopify AI Toolkit pages November 20, 2026.
Hermes Agent, Shopify and MCP: dates that matter
| Date | What happened |
|---|---|
| March 20, 2025 | @shopify/dev-mcp 1.0.0 was first published on npm. |
| April 22, 2026 | Shopify's Storefront Catalog MCP began to implement UCP, with search_catalog, lookup_catalog and get_product. The previous search and lookup tools were kept until June 15, 2026. |
| June 24, 2026 | Shopify deprecated the Storefront MCP cart tools in favor of UCP Cart MCP tools, kept until August 31, 2026. |
| October 27, 2026 | @shopify/dev-mcp 1.18.0 was published, the newest on November 13, 2026. |
| November 20, 2026 | Shopify's AI Toolkit page listed Hermes among its install targets, with an install script. The Hermes Agent MCP documentation can change between builds, so run hermes mcp test ryze after an update. |
Sources: @shopify/dev-mcp on npm, Storefront MCP, Shopify AI Toolkit. Checked November 13, 2026.
How this guide was tested
Two kinds of checks stand behind this guide: calls to the Ryze AI connector on November 13, 2026, and documentation read on November 13 and 20, 2026.
| What was run | What came back |
|---|---|
| Ten calls through the Ryze AI connector from Claude Code on a Shopify development store, November 13, 2026 | Reads of products, collections, pages, variants, orders count, themes and app scopes succeeded. customers and discountNodes were refused. The results are in the tested calls table. |
| The Hermes Agent MCP documentation, read on November 20, 2026 | It describes remote HTTP servers with auth: oauth, hermes mcp login, the token cache path, /reload-mcp, tool filters and the trust setting. Those pages are the source of every Hermes Agent step on this page. |
| Shopify's AI Toolkit page, read on November 20, 2026 | It lists Hermes with an install script and says the Dev MCP server runs locally and needs no authentication. |
Not run for this guide: every step inside Hermes Agent, and the write and delete tools, because they change a store. Hermes Agent was not installed, so hermes mcp login ryze and the config.yaml entries follow its documentation. On paper the sign-in fits: Hermes Agent falls back to dynamic client registration, which is the only registration method the Ryze AI connector supports. The Ryze AI help center has no page for Hermes Agent, and Ryze AI was not tested there.
Hermes Agent and Shopify errors and fixes
The first table holds messages returned during the November 13, 2026 connector test. The fixes follow Ryze AI's, Shopify's and Hermes Agent's documentation.
Messages returned in the test
These messages came back word for word from Shopify or the connector.
| Exact message | What caused it | Next step in Hermes Agent |
|---|---|---|
| Access denied for customers field. (ACCESS_DENIED) | The default connection has no read_customers scope. | Connect your own custom app with read_customers on the Custom app tab in Ryze AI. |
| Access denied for discountNodes field. Required access: Apps must have `read_discounts` access scope. (ACCESS_DENIED) | The default connection has no read_discounts scope. | Use a custom app with read_discounts. |
| Query cost is 1729, which exceeds the single query max cost limit (1000). (MAX_COST_EXCEEDED) | The query asked for 250 products with 250 variants and 250 metafields each. | Ask for fewer items per page or split the request. |
| Field 'seoTitle' doesn't exist on type 'Product' (undefinedField) | The field name does not exist. SEO fields sit under seo { title description }. | Ask again and name the seo object. |
| This is a write operation (invalid_arguments from the read tool) | A mutation was sent to shopify__read, which refuses and names the write tool. | Repeat the request through shopify__write and approve it. |
Other problems
- The tools do not show up in Hermes Agent
- Start a new session or run /reload-mcp. Then run hermes mcp test ryze, which reports what the server answered. Check that no tools.include or tools.exclude filter hides them and that the entry is not set to enabled: false. If Shopify was connected in Ryze AI after the login, run the login again and start a new session.
- The browser sign-in times out
- Editing config.yaml inside a running session triggers an automatic MCP reload with a 30-second timeout, too short for OAuth. Add the entry, then run hermes mcp login ryze from a fresh terminal. If you need longer than 5 minutes to approve, set oauth.timeout on the entry.
- Hermes Agent cannot reach the callback on a server
- Paste the redirect URL back at the prompt, forward the callback port over SSH, or sign in from the Desktop app or dashboard.
- A 401 or 403 from the connector
- Run hermes mcp login ryze again. With an API key, check that RYZE_API_KEY is set in ~/.hermes/.env and that the header reads Bearer followed by the rk_live_ key.
- Shopify does not accept the store domain
- Enter the .myshopify.com domain, not your custom domain, on the Shopify app tab.
- Orders from before the last 60 days are missing
- Without read_all_orders, Shopify returns only orders created within the last 60 days. The documented custom-app scope list in Ryze AI does not include read_all_orders.
- Theme files or redirects cannot be changed
- They are not available on the default Shopify app connection. Connect your own custom app instead.
- The store is already live in another workspace
- A store can be live in only one Ryze AI workspace at a time. Disconnect it there first.
- The tools reply that a subscription is required
- The Shopify tools need an active Ryze AI plan or free trial. Start the trial, then retry.
- Requests fail behind a proxy
- HTTP servers honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY, so set them in the environment Hermes Agent starts from.
Terms on this page
- Hermes Agent
- An open source AI agent from Nous Research that you run on your own machine or server. Its MCP servers are listed in ~/.hermes/config.yaml under mcp_servers.
- MCP
- The Model Context Protocol, an open standard that lets large language models call tools on outside servers. The Ryze AI connector is a remote MCP server.
- Admin GraphQL API
- Shopify's API for reading and changing store data. The Ryze AI read and write tools send queries and mutations to it.
- Access scope
- A permission an app holds on a store, such as read_products or write_content.
- Custom app
- An app you create in the Shopify Dev Dashboard and connect to Ryze AI when the default app lacks a scope.
- Query cost
- The points Shopify charges for a GraphQL query. One query may not exceed 1,000 points.
- Metafield
- A custom field attached to a product, collection or other Shopify resource.
Sources: access scopes, rate limits, Hermes Agent MCP documentation. Checked November 13, 2026.
Frequently asked questions
How do I connect Hermes Agent to Shopify?
Connect your .myshopify.com store in Ryze AI under Integrations, then add a ryze entry with the URL https://connector.get-ryze.ai/mcp and auth: oauth under mcp_servers in ~/.hermes/config.yaml. Run hermes mcp login ryze, click Allow connection, then start a new session or run /reload-mcp.
Is there a Shopify MCP connector for Hermes Agent?
Yes, the Ryze AI connector at https://connector.get-ryze.ai/mcp. It is a remote MCP server with 5 Shopify tools, and Hermes Agent supports remote HTTP servers with OAuth. Shopify also lists Hermes on its AI Toolkit page with an install script that adds a plugin.
Does Shopify have its own MCP server for Hermes Agent?
Shopify's Dev MCP server runs locally with npx -y @shopify/dev-mcp@latest and holds developer docs and API schemas, with no store data and no authentication. Its AI Toolkit page lists Hermes with an install script. Neither is a hosted server for editing your store.
Does Hermes Agent have a Shopify MCP server built in?
The Hermes Agent documentation page read for this guide names no Shopify entry. Add Shopify through a url entry in config.yaml, such as the Ryze AI connector.
What access does Hermes Agent get on my store?
The scopes of the Ryze AI Shopify app: read and write for products, content, metaobjects, themes and publications, and read for orders, analytics and reports. Customers, discounts and orders older than 60 days are not included.
Can Hermes Agent change my Shopify store?
Yes, within the app scopes. Through Ryze AI it can create and update products, collections, pages and blog content and their SEO fields, edit text in place, and delete resources when you ask. To have Hermes Agent ask first, set trust: untrusted on the ryze entry.
How do I make it read-only?
In Hermes Agent, list shopify__read and shopify__search_content under tools.include on the ryze entry, which hides the write and delete tools from the agent. That is a client-side filter and Shopify does not enforce it.
Does Hermes Agent need a paid plan for MCP?
No. Hermes Agent is open source under the MIT license per its GitHub repository and self-hosted. The Ryze AI side needs a plan or trial for the Shopify tools: Paid Ads at $89 per month with a 7-day free trial.
Should I use OAuth or an API key?
Use OAuth when you can open a browser, because hermes mcp login ryze handles the sign-in and Hermes Agent refreshes the tokens. Use a Ryze AI API key in a bearer header for servers and scripts where nobody can click Allow connection.
Does it work on a headless server or a VPS?
Yes, with an extra step for the sign-in. Paste the redirect URL back at the prompt, forward the callback port over SSH, or use the Desktop app or dashboard. An API key avoids the browser entirely.
Can I connect more than one Shopify store?
Yes. A workspace can hold several stores, added with View > Add one more account on the Shopify card. The agent uses the primary store unless you name another. One store cannot be live in two Ryze AI workspaces.
Can Hermes Agent edit my theme or read customers?
Not on the default connection. Theme file edits, URL redirects and customer records need your own custom app, connected on the Custom app tab in Ryze AI.
Why do the Shopify tools not show up in Hermes Agent?
Start a new session or run /reload-mcp, then run hermes mcp test ryze. Check that no tools.include or tools.exclude filter hides them and that the entry is not set to enabled: false. Also confirm that Shopify is connected in Ryze AI before the login.
How much does it cost?
Adding the connector is free. The Shopify tools need a 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 annual billing takes 30% off the first year. Hermes Agent itself is free software.
How do I disconnect Shopify from Hermes Agent?
Set enabled: false on the ryze entry or delete it from config.yaml, and delete ~/.hermes/mcp-tokens/ryze.json. To remove the store connection itself, disconnect Shopify on its card in Ryze AI or uninstall the app in Shopify admin.
Sources
- Hermes Agent MCP documentation
- NousResearch/hermes-agent on GitHub
- Shopify AI Toolkit and Dev MCP
- Shopify access scopes
- Shopify GraphQL Admin API rate limits
- Shopify API usage limits
- Shopify Storefront and UCP MCP servers
- Shopify CLI connector
- Shopify connectors for AI tools
- @shopify/dev-mcp on npm
- Composio Shopify toolkit
- Composio pricing
- Zapier MCP quickstart
- Zapier MCP for Shopify
- GeLi2001/shopify-mcp
- Ryze AI help center: Shopify
Checked November 13, 2026.