Shop MCP

Get started

Quickstart

Five steps from a fresh signup to running your first tool call. Plan on five minutes total.

1. Create a workspace

Sign up at shop-mcp.app/sign-up with email or Google. We create a default workspace for you on first sign-in — no separate "create org" step.

2. Connect a module

Open Settings → Integrations and pick the module you want first. Each card explains what credentials it needs:

  • Shopify — paste your Admin API access token
  • Neto — log in with your Neto store credentials
  • GA4 — sign in with Google, pick a property
  • Search Console — same Google grant as GA4
You only need one module connected to take the next step. The dashboard surfaces what's available in real time, so you can add more later.

3. Choose OAuth or a scoped MCP URL

Current clients with OAuth support use ShopMCP's credential-free endpoint. The client opens a browser, you sign in to ShopMCP, and you approve one workspace:

endpoint
https://my.shop-mcp.app/api/mcp

If a client cannot complete MCP OAuth, go to Settings → Connections, click Create new, and create a narrowly scoped URL for that client.

Static credential URLs are shown once

A scoped URL contains a long-lived smcp_ credential. Copy it when it appears, keep it out of screenshots and source control, and revoke it if exposed. ShopMCP stores only a hash after the dialog closes.

4. Add your endpoint to a chat client

ShopMCP uses the Streamable HTTP transport. Pick your client below for its current OAuth, CLI, or fallback process:

  • Claude Desktop or Claude web — add the OAuth endpoint under Connectors
  • Codex — register the endpoint, then run codex mcp login
  • Claude Code — add the endpoint, then authenticate from /mcp
  • Cursor — settings → MCP servers
  • OpenClaw — add and probe an OAuth Streamable HTTP server
  • Hermes Agent — add with hermes mcp add, then run the live test
  • ChatGPT — Apps settings, developer mode, then Create app
  • Microsoft Copilot — Copilot Studio with OAuth dynamic discovery

5. Ask your first question

Refresh MCP or start a new chat as described in the client guide, then try a query that touches the module you just connected:

  • Shopify: What were yesterday's orders?
  • GA4: How much traffic did we get last week, by channel?
  • GSC: Which queries lost the most clicks last month?

The assistant will use ShopMCP's compact discovery tools to find the right target, call it, and answer in natural language. You can also run a curated cross-MCP workflow: run the morning ecommerce briefing — see playbooks.

Next steps