Adverso
Browse all topics

Connect your AI client

Three steps for Claude, ChatGPT, Claude Code, Cursor and any other MCP client.

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

  1. Open the dashboard.
  2. Under MCP access, click Create API key.
  3. 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.

  1. Go to claude.ai or open the Claude desktop app.
  2. Open Customize → Connectors.
  3. Click Add, then Add custom connector.
  4. Set Name to Adverso MCP.
  5. In MCP server URL, paste your connector address (shown in the dashboard when you create the key).
  6. Click Continue. If Claude asks how to sign in, choose No sign-in: the key is already in the address.
  7. 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.

Connector address
https://pcaaxwkkddgzmgptngdb.supabase.co/functions/v1/mcp?key=YOUR_API_KEY

Step 3: Test the connection

  1. Start a new chat.
  2. Make sure the Adverso MCP connector is switched on for the chat.
  3. Send this:
Example
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

WayLooks likeUse it when
HeaderAuthorization: Bearer YOUR_API_KEYYour client lets you set a header: Claude Code, Cursor, agents, your own code. Prefer this one.
In the addressthe server address followed by ?key=YOUR_API_KEYYour 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.