Install a client
Any tool that speaks MCP over HTTP can connect — either by signing in, or by sending a key in a request header. The clients below are documented because the app generates a ready-made setup for each one.
Pick your client
| Client | How it connects | Needs Node.js |
|---|---|---|
| ChatGPT | Sign-in, with a one-time code | No |
| Claude | Sign-in, with a one-time code | No |
| Claude Code | One terminal command | No |
| Codex | One terminal command, key in an env var | No |
| Cursor | A .cursor/mcp.json file | No |
| Claude Desktop | Config file, through a bridge | Yes |
| ChatGPT Desktop | ~/.codex/config.toml | No |
| Other clients | Manually, if it supports headers | Depends |
ChatGPT and Claude on the web can connect now. They have no field for a key, so they use the sign-in route instead: the app shows a one-time code, you approve it in Settings → MCP connectors, and the client finishes by itself.
Before you start
You need one thing, and it comes from the app: the address for the route your client uses.
| Route | Address | Clients |
|---|---|---|
| Sign-in | https://upsell.avada.io/oauth/mcp | ChatGPT, Claude |
| Key | https://upsell.avada.io/mcp | Everything else |
Key-based clients also need a key, created in Settings → MCP connectors and shown once. See Authentication.
Your store also has to be on a paid plan. The MCP connectors section is not shown otherwise.
Choose the access level while you connect
Both routes ask for it. Read only is the default and is the right choice for anything you are still evaluating. Raise it later from the connections list — you do not have to reconnect, only restart the client so it picks up the new tools.
Your server name is per-store
Key-based snippets name the server aov-upsell-your-store, taken from your .myshopify.com
domain. For northwind-supply.myshopify.com that is aov-upsell-northwind-supply.
If you run more than one store, do not shorten these to aov-upsell. AI clients key their server
list by name: the second config would silently replace the first, and nothing in the answers would
tell you which store you were looking at.
After you connect
Do not trust "no error" as proof. Check both halves — that the client sees the server, and that the connection is accepted:
-
The client sees the server. Each page below says where to look —
/mcpin Claude Code and Codex, Settings → MCP in Cursor, the tools icon in Claude Desktop, the connector list in ChatGPT and Claude. The tool count tells you the access level it was given:Tools listed Access level 18 Read only 25 Read and write 27 Read, write, and delete -
The connection is accepted. Ask a question only this store can answer:
What free gift campaigns am I running?
A real answer means the whole chain works. A refusal means the server was reached but the connection was not accepted — go to Troubleshooting, which tells the two apart.
Changing the address or the key
Remove the server and add it again rather than editing the entry in place. Clients cache what they learned when the server was first registered — the tool list, and in some cases the credential — and editing a URL does not always clear it. Removing and re-adding always does.