Chat clients

Cursor

Cursor supports remote MCP servers over Streamable HTTP with OAuth. Add the base endpoint, sign in to ShopMCP, and verify the tool list.

1. Open MCP settings

In Cursor, open Settings → Cursor Settings → MCP. You'll see a list of currently connected servers and a button to add a new one.

2. Add ShopMCP

Click Add new MCP server. Cursor opens a JSON editor. Paste this block:

json
{
  "mcpServers": {
    "shopmcp": {
      "url": "https://my.shop-mcp.app/api/mcp"
    }
  }
}

If Cursor's editor already has an mcpServers object with other servers, add shopmcp as a sibling key — don't replace the whole object.

Use the base URL exactly as shown. Do not put a ShopMCP API key in mcp.json or commit a credential-bearing URL to a project.

3. Authenticate and verify

Save the file, return to Cursor's MCP settings, and choose Connect or Log in for shopmcp. Complete the ShopMCP browser flow and verify the workspace before approving. Cursor shows the server as connected and lists its tools after OAuth and tools/list succeed.

Cursor Agent CLI users can run cursor-agent mcp login shopmcp, then cursor-agent mcp list-tools shopmcp for the same authentication and verification flow.

4. Use it from chat

Open the Cursor chat sidebar (Cmd/Ctrl + L), make sure you're in Agent mode, and ask a question. Cursor auto-routes tool calls to ShopMCP based on the tool name namespaces.

Pull yesterday's orders and dump them as JSON in this file
Generate a markdown report from this week's GA4 traffic

Troubleshooting

OAuth does not start — confirm the URL has no ?token= query string, remove the server, and add it again so Cursor performs fresh OAuth discovery.
No tools appear — run cursor-agent mcp list-tools shopmcp or inspect the server in MCP settings, then confirm the approved ShopMCP workspace has at least one connected integration.