Ctrlk

MCP Server

This is an experimental feature. It may break or the interface may change.

Complete the connection steps below to give your agent of choice access to your Adnuntius account. Then ask it questions (for example about campaign performance, or fill rate) and it will suggest improvements based on data such as the latest traffic and reach forecasts available to your user. The agent has read only access to your account via a token which will refresh itself for 30 days, after which you will have to complete the authentication step again.

Register the Adnuntius MCP server with your agent

NOTE: If you are a user who has multiple networks, please select the network you wish to allow access to before pressing authorise in the steps below for your desired agent. Most users are in a single network and do not have to worry about this.

-> Anthropic Claude Code

Follow the 3 steps below to get setup with Claude Code.

1. Install a Client

You can skip this section if you already have a Claude Code client installed. The Adnuntius MCP is supported in both the App which you can get it from here:

LogoDownload Claude | Claude by AnthropicClaude

Or the Command Line Interface (CLI) which you can get from here:

LogoQuickstart - Claude Code DocsClaude Code Docs

2. Install the Connector

Choose one of the 4 options below to do this. Option A is recommended.

Option A - Register to Account

The recommended approach is to add the Adnuntius connector to your claude.ai account which makes it available to all your clients.

  • If you are on a personal account you do that here:

https://claude.ai/customize/connectors?modal=add-custom-connectorclaude.ai

  • Otherwise if you are an owner of a team account you do that here (if you are on a team account but not an owner, you must ask an owner to do this):

https://claude.ai/admin-settings/connectors?modal=add-custom-connectorclaude.ai

For either method, name the server what you like, and for the Remote MCP server URL use:

Once you press Add you (and everybody in your team if you have one) should see it in their list of connectors. You are now done with the setup and can use the MCP integration from the app or CLI. The following methods are only needed if you were not able to add the connector.

Option B - Register to CLI

The next step is only needed if you didn't follow the Register to Account instructions and wish to use the CLI. In that case you would add the Adnuntius MCP to the CLI client by running:

Option C - Register to Windows App

The following steps are only needed if you didn't follow the Register to Account instructions and you wish to use the app:

Go to the Connectors page in settings, and select Customize

Select + to add a new connector, and select ... Add custom connector

Name it whatever you like, and use the url https://api.adnuntius.com/api/mcp

Option D - Register to Mac App

There is currently no option to Add custom connector in the mac app, so the Adnuntius MCP can only be used in the Mac App via the Option A - Register to Account method.

3. Connect to Adnuntius

You connect the Claude Code App to Adnuntius by going to Settings -> Connectors -> Customise , selecting the Adnuntius connector (which is named depending on how you set it up in step 2), and clicking Connect:

If you are using the CLI, you connect to Adnuntius inside the CLI by typing /mcp and moving the selector down to adnuntius, pressing enter, and selecting 1. Authenticate

For either the app or CLI, you will then be taking to a page in your default browser which will ask you to authorise the agent to access your account (if you are not currently signed in to the Adnuntius Admin User Interface in that browser, you will be asked to sign in first). Once you click Authenticate, you should be connected in the app or CLI and can now ask questions from any session in it.

-> OpenAI Codex

1. Install the Codex Command Line Interface (CLI)

This is recommended even if you want to use the desktop app, because the app MCP has a number of bugs1 which make it unreliable to manage MCP servers in. The latest steps for installing the CLI can be found at:

LogoQuickstart – Codex | OpenAI DevelopersOpenAIDevs

  1. omits the RFC 8707 resource= parameter so tokens get the wrong audience (#13891), sends a malformed /token exchange that fails with "Required argument is missing" (#5045), silently does nothing when DCR isn't supported and prints "No authorization support detected" in the CLI (#11585), can't reach its own localhost:1455 callback in Windows+WSL or other multi-namespace setups (#12263), and even when login succeeds the Desktop app still reports auth_status: "unsupported" and never imports the server's tools into threads (#20009)

2. Add the Adnuntius MCP Server and Authorize it

In a terminal, run

codex mcp add adnuntius --url https://api.adnuntius.com/api/mcp

This will open a browser window for you to complete the authentication by pressing the Authorize button. If you are not already signed in to the Adnuntius platform you will be asked to do so first.

3. Use codex to ask questions about Adnuntius

Type codexto start the CLI and start asking questions.

4. (Optional) Use the desktop app

This can be installed from here:

LogoQuickstart – Codex | OpenAI DevelopersOpenAIDevs

If you completed steps 1 and 2 above, you should be able to ask questions about Adnuntius in the app. If you didn't you can try and add the integration in the app using the following steps:

  • Go to the MCP Server page in settings, and select +Add Server

  • Select Streamable HTTP and enter https://api.adnuntius.com/api/mcp as the URL. You can name the server anything you like.

  • Back on the MCP servers page, an Authorize button should appear after about 10 seconds (otherwise click on the gear icon). This Authorize button will open your browser to complete the login flow.

-> Google Antigravity

  1. If you haven't already, download the app from https://antigravity.google/download and install for your OS (Windows, Mac, or Linux are all fine)

  2. If you haven't already, open the app, and in the setup select sign in with Google and complete the Google login in your browser

  3. Exit the app and follow the OS specific setup instructions below

  4. After completing the setup instructions below, open Antigravity again and click Settings (gear icon) → Customizations.

  5. Scroll to Installed MCP Servers. You should see adnuntius with an "Unauthorized" warning.

  6. Click Authenticate next to adnuntius. A browser tab will open to the Adnuntius admin page.

  7. Sign in to Adnuntius if prompted, you should now be on a authorization page for token use.

  8. Once you click Authorize google should give you an authorization code in your browser. Copy it.

  9. Return to Antigravity. A dialog is waiting for the code, paste and click Submit.

  10. The adnuntius row should turn green, and you can now ask the agent questions about your Adnuntius account

Google Antigravity OS specific setup instructions:

3a Windows Setup

In the start menu, search for Powershell and open it. Run the following command in it:

3b Mac Setup

In Launchpad, search for Terminal and open it. Run the following command in it:

3c Linux Setup

Open a terminal and run the following command in it

Troubleshooting

Claude Code authentication or tool access issues

  • Go to https://claude.ai/customize/connectors and find the Adnuntius connector

  • Click the three dots in the top right and select Refresh tools list

  • If there is a connection issue you should see a screen giving you a Connect button to re-authenticate

  • Once you press that button, after a short pause an Adnuntius window will open and you need to click the Authorize button to grant access

  • The window should close and claude.ai will display a message about being connected

  • After this you MUST restart your claude clients to pick up the new MCP auth, you cannot fix MCP state without a restart.

Last updated