Connect your AI application to Adform MCP Server to access Adform data and capabilities directly from your AI conversations. You can then use natural-language prompts to explore and analyze your Adform data.
The Adform MCP Server supports AI applications that use remote MCP servers, OAuth 2.0 Authorization Code Flow with Proof Key for Code Exchange (PKCE), and refresh tokens. Adform MCP Server has been tested with ChatGPT, Claude, Microsoft Copilot, and Mistral. Other compatible AI applications might also work, but Adform can't guarantee compatibility with them.
Tip
For more information about authorization methods and credentials, see Client Credentials Authorization Method.
Important
Your use of Adform MCP Server is subject to your existing agreement with Adform and the MCP Access Notice. MCP provides read-only access and does not extend your existing Adform Platform access rights. You are responsible for ensuring that you are authorized to access and use Adform data through MCP and your chosen AI application, and for reviewing and validating AI-generated outputs before relying on them.
For terms, responsibilities, and restrictions, read the MCP Access Notice.
To be able to connect to Adform MCP Server, first make sure you have:
-
Adform MCP authentication credentials: a Client ID and Client Secret
-
An Adform FLOW user account with access to the business account you want to use
-
Access to an AI application that supports remote MCP servers
-
Permission to create or manage connections in your AI application
Your AI application must support:
-
OAuth 2.0 Authorization Code Flow with PKCE
-
Browser-based sign-in and consent
-
Redirect (callback) URLs
-
Access tokens
-
Refresh tokens
Important
Keep your Adform authentication credentials confidential. Never share your Client ID or Client Secret in public channels, repositories, or unencrypted messages. Treat them with the same level of security as a password.
To create the Adform MCP Server connection, review the requirements for your AI application.
Note
AI application providers might update their interfaces and MCP connection workflows. If the settings or options differ from what you see, refer to your AI provider’s official documentation for the latest MCP connection instructions.
The Adform MCP Server uses OAuth 2.0 Authorization Code Flow with PKCE to securely authenticate you and authorize access to Adform data. With OAuth, you sign in directly to Adform and choose whether to grant the requested permissions, so your AI application doesn't receive your Adform password.
After you approve access, Adform sends an authorization code to your AI application through its registered callback URL. The AI application exchanges the code for an access token and refresh token. The access token lets the AI application access Adform MCP. When it expires, the refresh token lets the application renew access without asking you to log in again.
The names and locations of settings differ between AI applications. In your AI application, find the option to add a remote MCP server, custom MCP connector, plugin, tool, or similar connection.
1. Enter the MCP Server Details
When prompted, enter the following information:
-
Server URL: When your AI application asks for an MCP server URL, remote server URL, connector URL, or similar connection endpoint, enter https://mcp.adform.com/mcp.
-
Connection name: Enter a clear, recognizable name, such as Adform-MCP.
-
Connection description: If required, briefly describe what the connection is for, such as Connection to Adform FLOW.
Note
Your AI application might use different field names, such as MCP server URL, Remote server URL, Connector URL, or Connection endpoint.
2. Configure OAuth Authentication
When your AI application asks for authentication method with Adform MCP, select OAuth 2.0.
MCP clients vary significantly in the amount of OAuth configuration they require. Some tools support OAuth Authorization Server Metadata and automatically retrieve all necessary settings from Adform MCP. Others might require only a subset of values, such as the scope or authorization server URL. Certain tools might require you to enter every OAuth setting manually.
Enter only the values that your AI application requests. If some fields aren't shown, skip them. The AI application will configure them automatically. If your AI application requests them, provide the following values:
|
Field |
Value |
|---|---|
|
Resource |
|
|
Auth Server URL |
|
|
Authorization URL |
|
|
Token URL or Refresh URL |
|
|
Scope |
NoteIf your AI application requests the scope separately, enter the value exactly as shown above, including the space between the two scopes. The connection to Adform MCP uses two OAuth scopes:
Both scopes are required for a standard Adform MCP setup. |
3. Register the Callback URL
This step might not be required, depending on the AI application you use. However, some AI applications might provide a redirect or callback URL during setup. Adform uses this URL during the authentication process.
If your AI application displays a URL, copy it and send it to your Adform representative. Adform might need to register the URL before you can complete the connection.
4. Enter MCP Authentication Credentials
When prompted, enter the Client ID and Client Secret provided with your Adform MCP Server authentication credentials. Your AI application might request them when you enter the server URL or when you configure OAuth.
Note
The connection uses two sets of credentials: MCP credentials and Adform account credentials. Your Client ID and Client Secret authenticate the MCP connection, while your Adform username and password are used to sign in to Adform. Make sure you enter each set in the correct fields to avoid authentication errors.
5. Log In and Approve Access
Once you save the MCP connection in your AI application, Adform sign-in page loads.
-
On the Adform sign-in page, enter your Adform FLOW user ID and password, and select Log in.
-
If necessary, select the business account you want to use with MCP. (If you can access only one business account, you might not see this step.)
Important
If your Adform user has access to multiple business accounts, select only a business account that your organization has approved for use with Adform MCP.
-
Review the requested MCP access permissions. Make sure that
Adform MCP Gateway accessandOffline Accessare selected, then select Allow.Important
Both scopes are required for a standard Adform MCP Server connection. Avoid approving additional permissions that you don't need. If you have any questions, contact Adform Support (technical@adform.com).
After you approve access, your AI application should complete the connection automatically.
6. Verify the Connection
After a successful connection, the Adform MCP Server should show as Connected, Authorized, or a similar status in your AI application.
To test the connection, try a simple prompt, for example:
-
Show me a list of advertisers on my account via Adform MCP.
If Adform MCP Server returns the requested data, the connection is ready to use.
Tip
When you work with Adform MCP Server, consider its capabilities, prompt best practices, and Adform MCP skills.
If you have trouble connecting your AI application to Adform MCP Server, use this troubleshooting guide to identify and resolve common connection issues.
MCP Connection Settings Aren't Available in Your AI Application
If your AI application doesn't provide an option to add or manage MCP servers, custom connectors, or external integrations:
-
Make sure your account has permission to configure MCP connections.
-
If you use an organization-managed account, contact your administrator or IT team. Ask them to confirm that MCP servers, custom connectors, or external integrations are available for your organization. After the feature becomes available, restart your AI application and try again.
Check the Connection Setup
If you can't connect, make sure that:
-
The MCP server URL is entered correctly:
https://mcp.adform.com/mcp. -
The connection uses OAuth 2.0 Authorization Code Flow with PKCE.
-
You entered your Client ID and Client Secret in the OAuth configuration fields, and your Adform account username and password in the Adform sign-in screens. See more in Resolve an "Unauthorized Client" Error.
-
Any OAuth URLs and scopes you entered manually match the values provided in this guide.
-
You approved both required scopes during sign-in.
-
Your AI application account has permission to create or manage MCP connections or, where necessary, the MCP connection is managed by an administrator with appropriate permissions.
-
Your redirect or callback URL is registered with Adform, if required.
Resolve a "404 Not Found" Error
A "404 Not Found" error during authentication might mean that one or more OAuth URLs are incorrect. This can happen because of a typo, missing path segment, or incorrect OAuth endpoint.
Compare the OAuth URLs you entered manually with the values provided for Adform MCP. Correct any differences, save your changes, and try to connect again.
Resolve an "Invalid Request" Error
If you set up the connection but get an "invalid request" error on the Adform sign-in page, this might mean that your AI application's redirect or callback URL hasn't been registered with Adform, has changed, or doesn't exactly match the registered URL. Some AI applications can use redirect URLs with varying ports, hostnames, or identifiers.
To resolve this issue:
-
Check whether your AI application displays a URL (redirect URL or callback URL).
-
If it does, copy the URL and send it to your Adform representative. They can add it to the allow list for Adform MCP.
-
If you can't find the URL, contact Adform Support (technical@adform.com) and provide the date and time of the failed connection attempt, your time zone, and the public IP address used for the connection.
Note
Provide the time as precisely as possible, for example, September 28, 2026, 14:35 CEST. This helps Adform find the corresponding authentication request in the server logs and investigate the issue.
To find your public IP address, stay on the same network you used for the failed connection. Search "What is my IP" in your browser. Send the IP address and the exact time of the failed attempt, including your time zone, to your Adform representative. If you change networks or disconnect from a VPN, repeat the connection attempt and provide the new IP address and timestamp.
-
After the URL is registered, start the authentication process again.
Resolve an "Unauthorized Client" Error
An "unauthorized client" error can occur when the MCP authentication credentials and Adform sign-in credentials are mixed up. Make sure that:
-
You entered your Client ID and Client Secret in the MCP OAuth configuration fields.
-
You entered your Adform user ID and password only on the Adform sign-in page.
-
You entered your Client ID and Client Secret correctly.
-
If needed, verify your Client ID and Client Secret with Adform Support (technical@adform.com).
Contact Adform Support
If you still can't connect or experience other issues, contact Adform Support (technical@adform.com) and provide as much of the following information as possible:
-
Which AI application you're using
-
Screenshots of any error messages
-
Screenshots of the MCP configuration
-
The exact date and time of the failed connection attempt, including your time zone
-
The redirect or callback URL
-
Your public IP address