Setting up Adverity MCP

Setting up Adverity MCP#

This guide explains how to connect Adverity to your AI tool using MCP.

For an overview of available tools and use cases, see Using Adverity MCP.

Prerequisites#

Before connecting, ensure you have all of the following:

Adverity account

An active Adverity account with Management API (MAPI) access enabled.

Adverity instance URL

Your dedicated environment address, such as https://yourcompany.adverity.com.

Adverity MAPI key

A valid API key generated from your Adverity instance. The key permissions determine what actions AI can perform. For more information, see Generating an API key in Adverity.

Compatible MCP client

An AI tool account that supports MCP connections:

Claude: Requires a Claude Pro or higher plan. On Team and Enterprise plans, a workspace administrator controls whether members can add custom connectors. If Add custom connector is not available to you, use Connecting with Claude Code instead.
ChatGPT: Requires a Business or Enterprise plan. Note that initial setup may require workspace administrator privileges to enable developer mode for custom connectors.

Connecting to Claude#

Claude offers two ways to connect to Adverity: the Connectors settings in Claude.ai, and the Claude Code command line. Use Claude Code if custom connectors are not available in your workspace, or if you want to connect more than one Adverity instance at the same time.

Connecting with the Claude.ai connector#

To connect Adverity to Claude with MCP, follow these steps:

Open Settings in Claude.ai and navigate to Connectors.
Click Add custom connector.
Configure the connection:

Name
Enter the name for your Adverity connection.

Remote MCP server URL
Enter the URL of the Adverity MCP server: https://mcp.eu.adverity.com/mcp.
Click Add. You will be redirected to the Adverity MCP server sign in page.
Enter your Instance URL and MAPI key to authenticate the connection.
Click Connect Adverity to MCP.

As a result, your Adverity instance is connected to Claude.

Connecting with Claude Code#

Claude Code connects to MCP servers from the terminal. This method does not use the Connectors settings, so it also works when your workspace administrator has restricted custom connectors.

To connect Adverity to Claude Code, follow these steps:

Add the Adverity MCP server:

claude mcp add --transport http adverity-mcp https://mcp.eu.adverity.com/mcp

Start the sign in:
```
claude mcp login adverity-mcp
```
On the Adverity sign in page, enter your Instance URL and MAPI key.
Click Connect Adverity to MCP.
Confirm the connection:
```
claude mcp list
```
The server is listed as adverity-mcp with the status Connected.

As a result, your Adverity instance is connected to Claude Code.

Note

A server you have just added does not appear in a Claude Code session that is already running. Restart the session to load its tools.

Connecting multiple Adverity instances#

Claude Code can connect to several Adverity instances at the same time, for example a test instance and a production instance. Add the MCP server once per instance, giving each one a distinct name.

The MCP server URL is the same for every instance. What connects an entry to a particular Adverity instance is the Instance URL you enter when you sign in, which is stored in that entry’s own credentials. Each entry keeps its own sign in, so connecting a second instance does not affect the first.

The name you choose keeps the two sets of tools apart, so that Claude does not confuse the tools of one instance with those of another. Choose names that make the instance obvious, such as adverity-mcp-test and adverity-mcp-production.

To connect an additional Adverity instance, follow these steps:

Add the MCP server under a name that identifies the instance:

claude mcp add --transport http adverity-mcp-test https://mcp.eu.adverity.com/mcp

Sign in to that entry:
```
claude mcp login adverity-mcp-test
```
On the Adverity sign in page, enter the Instance URL and MAPI key of the instance you want this entry to use.
Repeat these steps for each additional instance, using a different name each time.

As a result, Claude Code is connected to each Adverity instance separately, and claude mcp list shows every entry as Connected.

Warning

Every sign in page looks the same and does not show which entry you are authenticating. If you enter the wrong Instance URL, an entry named for a test instance connects to a production one, and actions such as deleting a datastream cannot be undone. After connecting each instance, ask Claude to list your datastreams and check that the results match the instance you expect.

Managing Claude tool permissions#

In Claude, you can control how the assistant executes specific MCP tools:

Always allow (recommended): Claude can use the tool without user confirmation, which allows it to work efficiently without interrupting for permission on every query.
Needs approval: Claude must ask for permission each time, providing more control but slower execution.
Blocked: Prevents Claude from using specific tools entirely.

Connecting to ChatGPT#

For ChatGPT, an administrator needs to create the connector first, then individual users can link their accounts.

Setting up the connector (administrator)#

To set up the Adverity MCP connector in your ChatGPT workspace, follow these steps:

In ChatGPT, click your workspace name in the bottom-left corner and select Workspace settings.
Go to the Connectors tab.
Click Create.
A pop-up will appear warning about developer mode. Click Enable developer mode.
Configure the connection:

Name
Enter the name for your Adverity connection.

MCP Server URL
Enter the URL of the Adverity MCP server: https://mcp.eu.adverity.com/mcp.

Authentication
Leave this setting empty.
Check the box I understand and want to continue.
Click Create. You will be redirected to Adverity to authenticate with your MAPI key.
After authenticating, you will be redirected back to the ChatGPT Connectors settings page.
Your new connector will be listed under Drafts. Click Publish.
Acknowledge the potential risks in the pop-up.
Click Publish again.

As a result, the Adverity MCP connection is active and available for all users in your workspace.

Connecting your personal account (user)#

Once your administrator has set up the connector, follow these steps to link your personal account:

In ChatGPT, click your name in the bottom-left corner and select Settings.
Go to the Apps & Connectors tab.
Click Adverity in the list of available connectors.
Click Connect.
A pop-up will appear. Click Continue to Adverity.
You will be redirected to the Adverity sign in page. Enter your Instance URL and MAPI key to authenticate the connection.
After a successful sign in, you will be redirected back to your ChatGPT settings. The button will now say Disconnect, confirming the connection is active.

As a result, your Adverity instance is connected to ChatGPT.

Connecting to other tools#

MCP is designed for broader agentic workflows beyond chat interfaces. You can integrate Adverity MCP with automation platforms and custom applications using the MCP server URL: https://mcp.eu.adverity.com/mcp.

n8n and Make: Build automated workflows where an AI agent checks if datastreams are successful before triggering the next step in a marketing report.
Custom clients: Build your own MCP clients to allow different internal AI agents to collaborate using Adverity’s harmonized data as a central hub.

Testing your connection#

After connecting, verify the setup with the following prompts. Each should return a meaningful response from your Adverity instance:

Show me all my datastreams — returns a list of datastreams from your instance.
Which authorizations are expiring soon? — returns authorization status with expiry information.
Download my latest Google Ads data — returns a CSV data extract from your most recent Google Ads datastream.

What’s next?#

Using Adverity MCP