Developer clients

Codex

Register ShopMCP once, authenticate with ShopMCP OAuth, and use the same local MCP configuration from Codex sessions that read your Codex settings.

1. Use the ShopMCP OAuth endpoint

ShopMCP exposes this hosted Streamable HTTP endpoint for Codex:

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

Do not add a token to the URL. Codex authenticates the server with ShopMCP OAuth after registration.

2. Add it to Codex

Run this once from a terminal on the machine where you use Codex:

bash
codex mcp add shopmcp \
  --url 'https://my.shop-mcp.app/api/mcp'

The command registers shopmcp as a Streamable HTTP MCP server in your Codex configuration.

The Codex CLI's current remote-server syntax is codex mcp add NAME --url URL. The Codex app and IDE extension use the same local MCP settings when they run on that machine.

3. Sign in to ShopMCP

Start the MCP OAuth flow:

bash
codex mcp login shopmcp

Codex opens a browser. Sign in to ShopMCP, check the workspace name on the consent screen, and approve access. Codex stores the bearer credential separately instead of putting it in the server URL.

4. Confirm it is available

Inspect the saved server and authentication state:

bash
codex mcp get shopmcp
codex mcp list

Start a new Codex session after login so it loads the authenticated ShopMCP tool list.

5. Try it from Codex

Use ShopMCP to pull yesterday's Shopify orders and save a summary in this repo.
Run an ecommerce health check across Shopify, GA4, and Search Console.

Removing or reconnecting

To remove the stored OAuth credential and server entry:

bash
codex mcp logout shopmcp
codex mcp remove shopmcp

To switch workspaces or recover from an OAuth error, keep the server entry and run codex mcp logout shopmcp, then codex mcp login shopmcp. Verify the workspace name before approving.