Shop MCP

Chat clients

Claude Code

Claude Code supports remote MCP servers natively. Register the endpoint from the CLI, then complete ShopMCP OAuth from /mcp.

1. Run the add command

From any terminal where you have Claude Code installed, register ShopMCP's OAuth-enabled Streamable HTTP endpoint:

bash
claude mcp add --transport http --scope user \ shopmcp 'https://my.shop-mcp.app/api/mcp'

--scope user stores the server in your user-level config so it becomes available across projects. To scope it to a single project instead, change the scope to project and run the command from inside the project directory.

2. Authenticate with ShopMCP

Start Claude Code, run /mcp, choose shopmcp, and follow the browser authentication prompt. Sign in to ShopMCP, verify the workspace name on the consent screen, and approve access.

ShopMCP uses OAuth, so do not add an API key to the server URL or pass an authorization header.

3. Confirm it loaded

Run claude mcp list. You should see:

bash
shopmcp http https://my.shop-mcp.app/api/mcp

Open /mcp again if the server still shows that authentication is required.

4. Use it from a session

Start Claude Code in any directory and ask a question that touches your connected modules:

  • What were yesterday's orders? Save them to orders.json
  • Run the morning ecommerce briefing and turn the output into a markdown file

Removing or reconnecting

To remove the server entirely:

bash
claude mcp remove shopmcp

To change workspaces or recover from an OAuth error, use /mcp to clear authentication and reconnect. Check the workspace name before approving the new session.