Skip to content
ShopiAgents

Connect other AI tools

Use your wholesale desk from Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, n8n and other tools, by signing in or with a connection key.

Claude and ChatGPT aren't the only places you can work with your wholesale desk. Coding tools, terminal assistants and automation tools can use it too, with the same rules: your team role, your plan, and nothing sent or approved without a yes.

Plan: Starter and up (reading). Actions need Growth and up. Who can do it: anyone on your team for a signed-in tool. Making a connection key needs an Approver or Admin.

Before you start

Copy your store's address from Integrations → Claude & ChatGPT. In the examples below, replace YOUR_ADDRESS with it. The app shows the same steps with your address already filled in: pick the tool under Your assistant.

Sign in, or use a key

HowUse it for
Sign in with ShopifyThe tool opens your Shopify admin, you choose Read only or Read and act and click AllowClaude Code, Cursor, VS Code, Gemini CLI, Codex
Connection keyA key made in the app, sent with every requestWindsurf, n8n, Zapier, Make, your own scripts

If a tool asks how it should identify itself (an "OAuth client"), choose Register automatically.

Make a connection key

  1. Go to Integrations → Claude & ChatGPT → Connection keys.
  2. Give it a name, for example "n8n reorders".
  3. Choose Read only or Read and act (Growth and up).
  4. Click Make a key, copy it, then click I've copied it. It isn't shown again.

Keep keys out of shared files. Rotate key in Connected assistants makes a new one and stops the old one at once.

Claude Code

claude mcp add --transport http --scope user wholesale-orders YOUR_ADDRESS

Start Claude Code, type /mcp, choose wholesale-orders and sign in (click Allow in your Shopify admin). With a key instead, add --header "Authorization: Bearer YOUR_KEY". Check it with claude mcp list.

Cursor

Add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "wholesale-orders": { "url": "YOUR_ADDRESS" }
  }
}

Save. Cursor asks you to sign in. Use the tools in Cursor's Agent chat. With a key instead, add "headers": { "Authorization": "Bearer ${env:SHOPIAGENTS_MCP_KEY}" } and set SHOPIAGENTS_MCP_KEY to your key.

VS Code (GitHub Copilot)

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose HTTP (HTTP or Server-Sent Events), paste your address and name it wholesale-orders.
  3. When VS Code asks, sign in in your browser and click Allow.
  4. Use the tools in Copilot Chat's Agent mode.

With a key instead, use an inputs entry with "password": true, so the key never sits in a shared file.

Windsurf

  1. Make a connection key and save it on your computer as the environment variable SHOPIAGENTS_MCP_KEY.
  2. Open ~/.codeium/windsurf/mcp_config.json and add:
{
  "mcpServers": {
    "wholesale-orders": {
      "serverUrl": "YOUR_ADDRESS",
      "headers": { "Authorization": "Bearer ${env:SHOPIAGENTS_MCP_KEY}" }
    }
  }
}
  1. Save, restart Windsurf, and refresh the MCP servers in Cascade.

Gemini CLI

gemini mcp add --transport http -s user wholesale-orders YOUR_ADDRESS

In Gemini CLI, type /mcp auth wholesale-orders and sign in. With a key instead, add --header "Authorization: Bearer YOUR_KEY". Check it with gemini mcp list.

OpenAI Codex

codex mcp add wholesale-orders --url YOUR_ADDRESS
codex mcp login wholesale-orders

In the Codex IDE extension: gear menu → MCP servers → Add server → Streamable HTTP, paste your address, save, then Restart extension. With a key instead, put bearer_token_env_var = "SHOPIAGENTS_MCP_KEY" under [mcp_servers.wholesale-orders] in ~/.codex/config.toml.

n8n

  1. Make a connection key. Use Read only unless the workflow needs to act.
  2. In your workflow, add an AI Agent node and connect the MCP Client Tool node to it as a tool.
  3. In MCP Client Tool, choose HTTP Streamable and paste your address as the endpoint.
  4. Set Authentication to Bearer Auth and create a credential with your key.

Zapier, Make and your own scripts

Point the tool's MCP connection at your address (Streamable HTTP) and send the key with every request as the header Authorization: Bearer YOUR_KEY.

What isn't supported yet

The consumer apps of Google Gemini (gemini.google.com), Microsoft Copilot, Perplexity and Grok don't let you add your own servers today. That's their limit. When they do, the same address will work.

What your buyers see

Nothing new. Anything sent to a buyer goes out from your store, in your store's name.

Good to know

  • Each tool can make 60 requests a minute, and your store 2,000 a day.
  • A key works with the rights it was made with. A signed-in tool works with the role of the person who signed in.
  • These tools rename menus and settings often. If a step doesn't match, the app's own steps are kept current.

If something goes wrong

  • A key stopped working: it was rotated or disconnected. Make a new one.
  • "Too many requests": wait the seconds it says. Limits reset every minute and every day.

More in Claude and ChatGPT problems.

Still stuck? Email support@shopiagents.com and a person will help.