Developer clients

Codex

Use Codex's remote MCP support with the ShopMCP URL. No local server, no JSON paste, and the same config is available to Codex sessions that read your Codex MCP settings.

1. Copy your ShopMCP URL

Use the full hosted ShopMCP MCP URL from Settings → Connections. It looks like this:

text
https://my.shop-mcp.app/api/mcp?token=smcp_xxxxxxxxxxxxxxxxxxxx

For a first test, choose All integrations. For production work, create a custom-scoped URL for only the modules Codex should reach.

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?token=smcp_xxxxxxxxxxxxxxxxxxxx'

The command registers shopmcp as a Streamable HTTP MCP server. The ShopMCP token is embedded in the URL, matching the value shown in Settings → Connections.

OpenAI's official Codex CLI supports remote MCP servers through codex mcp add --url. If the Codex app you are using exposes a graphical MCP settings screen, paste the same full URL there.

3. Confirm it is available

List configured MCP servers:

bash
codex mcp list

You should see shopmcp with the ShopMCP URL. Start a new Codex session after adding the server so the tool list is refreshed.

4. Try it from Codex

Ask Codex for a workflow that touches your connected ecommerce data:

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 rotating

To remove ShopMCP from Codex:

bash
codex mcp remove shopmcp

To rotate credentials, create a new ShopMCP MCP URL, run the add command again, and restart the Codex session.