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 (Beta).

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 that supports custom connectors.

  • 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#

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

  1. Open Settings in Claude.ai and navigate to Connectors.

  2. Click Add custom connector.

  3. 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.

  4. Click Add. You will be redirected to the Adverity MCP server sign in page.

  5. Enter your Instance URL and MAPI key to authenticate the connection.

  6. Click Connect Adverity to MCP.

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

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:

  1. In ChatGPT, click your workspace name in the bottom-left corner and select Workspace settings.

  2. Go to the Connectors tab.

  3. Click Create.

  4. A pop-up will appear warning about developer mode. Click Enable developer mode.

  5. 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.

  6. Check the box I understand and want to continue.

  7. Click Create. You will be redirected to Adverity to authenticate with your MAPI key.

  8. After authenticating, you will be redirected back to the ChatGPT Connectors settings page.

  9. Your new connector will be listed under Drafts. Click Publish.

  10. Acknowledge the potential risks in the pop-up.

  11. 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:

  1. In ChatGPT, click your name in the bottom-left corner and select Settings.

  2. Go to the Apps & Connectors tab.

  3. Click Adverity in the list of available connectors.

  4. Click Connect.

  5. A pop-up will appear. Click Continue to Adverity.

  6. You will be redirected to the Adverity sign in page. Enter your Instance URL and MAPI key to authenticate the connection.

  7. 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?#

Contents