Shopify MCP connection to AI Agent

Technical Q&A

Topic summary

A user is encountering a persistent 404 error when attempting to connect Shopify’s MCP (Model Context Protocol) endpoint to an ElevenLabs AI agent, despite trying various configuration approaches.

Key troubleshooting suggestions provided:

  • Verify API permissions: Ensure read/write_customer_engagement scopes are active in the app settings
  • Check MCP availability: Shopify MCP is still in staged rollout—not all store tiers have full access yet
  • Test the endpoint directly: Use Postman, cURL, or browser console to POST a minimal JSON-RPC request (e.g., tools/list) to /api/mcp and examine the response
  • Investigate routing issues: Custom theme/app code might be shadowing the /api/mcp route
  • Consider middleware: For ElevenLabs integration, proxying requests through custom middleware may be necessary

Diagnostic steps:

One responder provided a JavaScript fetch snippet to test the endpoint directly in Chrome DevTools, which should return a JSON-RPC response with available tools if properly configured.

The issue remains unresolved, with the original poster awaiting further testing or potential assistance from community members.

Summarized with AI on October 24. AI used: claude-sonnet-4-5-20250929.
1

Has anybody else had issues trying to connect Shopify MCP to their AI agent (specifically ElevenLabs)?

Doesn’t matter how I set it up, I keep getting a 404 error:

Server URL: '[https://mydomain.com]/api/mcp'
Headers: 'Content-Type': 'application/json'

Is this still in beta and needs enabling for a specific store? The official documentation says: some stores may restrict access.

Any help would be greatly appreciated

2

This usually happens when the MCP endpoint isn’t enabled for your store tier or the route /api/mcp isn’t properly exposed in your app.

You can check your app permissions — make sure you have read/write_customer_engagement scopes active, and test via Postman or cURL.

Also note that Shopify MCP is still rolling out in stages, so not all stores have full API access yet. If you’re integrating with ElevenLabs, you might need to proxy the request through your own middleware first.

3

Hello @edddddie

Take this steps

  • From your browser or Postman, POST https://your-store.com/api/mcp with minimal JSON-RPC body (e.g. call tools/list) and see if you get any response or error payload.

  • Verify whether Shopify returns a login or redirect page when visiting /api/mcp in browser that can hint whether it’s routed at all.

  • Check in Shopify admin or with support whether MCP is enabled or if there are settings restricting API access.

  • Review theme or app code for custom API routing that might shadow /api/mcp.

  • Look at logs / network traces (with verbose mode) to confirm what server responds (Shopify or your proxy).

  • Try on another store (if possible) to see if the problem is store-specific.

If you like, I can take a quick peek (just the public setup) for you and tell you exactly what’s going wrong

4

Quick test guide:

  1. Use Chrome open your store
  2. F12, exec JavaScript Code:
fetch("https://[your store].myshopify.com/api/mcp", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": ""
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        method: "tools/list",
        id: 1,
        params: {}
      }),
    })

3. Response content like:

{"jsonrpc":"2.0","id":1,"result":{"tools":[{"name":"search_shop_catalog","description":"...}