This guide connects Adverso MCP to your AI client. After it, you can ask about your Amazon advertising in plain words.
Before you start
- An Adverso MCP account with Amazon Ads connected.
- At least one marketplace switched on in the dashboard.
- An AI client that supports MCP. Claude, ChatGPT, Claude Code and Cursor all do.
Step 1: Create your API key
- Open the dashboard.
- Under MCP access, click Create API key.
- Copy the connector address shown under the key. For Claude Code, copy the command instead.
Step 2: Add Adverso MCP to your AI client
Pick your client.
The Claude apps take a server by its address. Your key is part of that address.
- Go to claude.ai or open the Claude desktop app.
- Open Customize → Connectors.
- Click Add, then Add custom connector.
- Set Name to
Adverso MCP. - In MCP server URL, paste your connector address (shown in the dashboard when you create the key).
- Click Continue. If Claude asks how to sign in, choose No sign-in: the key is already in the address.
- Click Add.
Team or Enterprise workspace. An Owner adds the connector once, under Organization settings → Connectors (Add → Custom → Web). It then appears for every member under Customize → Connectors. Everyone uses the key in that address.
One connector, every Claude app. Once added, it is there on the web, in the desktop app and on your phone.
https://pcaaxwkkddgzmgptngdb.supabase.co/functions/v1/mcp?key=YOUR_API_KEYStep 3: Test the connection
- Start a new chat.
- Make sure the Adverso MCP connector is switched on for the chat.
- Send this:
Which Amazon accounts can you see in Adverso MCP, and for which dates do you have data?
If your AI names your accounts and marketplaces, you are connected. Next: Example questions.
Two ways to send the key
| Way | Looks like | Use it when |
|---|---|---|
| Header | Authorization: Bearer YOUR_API_KEY | Your client lets you set a header: Claude Code, Cursor, agents, your own code. Prefer this one. |
| In the address | the server address followed by ?key=YOUR_API_KEY | Your client accepts only an address: custom connectors in the Claude and ChatGPT apps. |
One key works in several clients. You can use the same key in Claude, in Cursor and in your own script at the same time. Creating a new key replaces the old one everywhere, so update each client when you do.
Troubleshooting
I do not see Connectors or Add custom connector
- Custom connectors are available on every Claude plan. The Free plan allows one.
- In a Team or Enterprise workspace, only an Owner can add a custom connector. Ask your Owner to add Adverso MCP under Organization settings → Connectors.
The client cannot connect, or shows 401
- The key is missing or wrong. Check that the whole connector address was pasted, including everything after
?key=. - You created a newer key. The older one stopped working. Remove the connector and add it again with the new address.
My AI does not use Adverso MCP
- Switch the connector on for the chat. In Claude: the + button, then Connectors.
- Name it in your question once: "Use Adverso MCP to…".
My AI says it has no data for my dates
Ask for dates inside the range list_accounts reports. It returns the first and last day with data for each marketplace.
My AI says a marketplace is not part of my plan
Switch that marketplace on in the dashboard.
Every message the server can send is listed in Limits and errors.