Install a client
The app generates the exact snippet for you in Settings → AOV MCP. Pick your client below and paste what it gives you — you never type the endpoint by hand.
Pick your client
| Client | How it connects | Needs Node.js |
|---|---|---|
| Claude Code | One terminal command | No |
| Claude Desktop | Settings → Connectors → Add custom connector | No |
Claude on the web connects the same way as Desktop — the same Add custom connector flow, the same URL.
Cursor, VS Code and ChatGPT cannot connect. This is not a missing guide. The server only accepts
a sign-in callback from claude.ai, claude.com, or a loopback address on your own machine. Any
other client is refused while registering, so it fails during setup rather than connecting and
then answering nothing.
Before you start
One thing, from the app: a connect code, from Settings → AOV MCP. It is shown once, lives six hours, and works for as many clients as you connect in that window — see Authentication.
There is no key to paste into a config file and no header to set. You approve the connection in a browser tab on your own Shopify admin, and the client receives its own token from that approval.
Rename the server if you have more than one store
Every snippet names the server aov-ppu.
AI clients key their server list by name. Connect two stores with the snippet unchanged and the
second silently replaces the first — you end up with one connection, and no way to tell from an
answer which store it came from. Rename each one before you paste, for example aov-ppu-northwind.
The name is yours to choose; only the address has to be the one the app gave you.
After you connect
Do not treat "no error" as proof. Check both halves:
-
The client sees the server.
/mcpin Claude Code, the connectors list in Claude Desktop. It should be listed with 11 tools. -
The connection is authorised. Ask something only this store can answer:
How many active offers do I have?
A real count means the whole chain works. A refusal means the server was reached and the connection was not — see Troubleshooting.
The app itself is the other half of the check: Settings → AOV MCP lists what is connected right now, so you can confirm from the store side without asking Claude anything.
Reconnecting
Remove the server and add it again rather than editing the entry in place. Clients cache what they learned when a server was first registered, and editing a URL does not always clear it.
Reconnecting needs a fresh connect code — a used code is not reusable after its six hours are up, and Disconnect in the app invalidates the token immediately.