# MCP Server Once you have completed the connection steps below your agent will have access to your account in order to allow you to ask questions about the state of your line items and to diagnose orders (more features coming soon). The token 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 #### 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: {% embed url="" %} Or the CLI which you can get from here: {% embed url="" %} #### 2. 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: {% embed url="" %} * 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): {% embed url="" %} For either method, name the server what you like, and for the Remote MCP server URL use: ``` https://api.adnuntius.com/api/mcp ``` 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. #### 2. 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: ``` claude mcp add --transport http adnuntius https://api.adnuntius.com/api/mcp ``` #### 2. 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`](https://api.adnuntius.com/api/mcp) #### 2. 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. ### 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: {% embed url="" %} 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 `codex`to start the CLI and start asking questions. #### 4. (Optional) Use the desktop app This can be installed from here: {% embed url="" %} 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`](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 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 **3a Windows Setup** In the start menu, search for Powershell and open it. Run the following command in it: ``` $j='{"mcpServers":{"adnuntius":{"serverUrl":"https://api.adnuntius.com/api/mcp"}}}'; foreach($d in 'antigravity','config'){ $p="$env:USERPROFILE\.gemini\$d\mcp_config.json"; New-Item -ItemType Directory -Force -Path (Split-Path $p) | Out-Null; [System.IO.File]::WriteAllText($p,$j) } ``` **3b Mac Setup** In Launchpad, search for Terminal and open it. Run the following command in it: ``` python3 -c "import os,json;d={'mcpServers':{'adnuntius':{'serverUrl':'https://api.adnuntius.com/api/mcp'}}};[(os.makedirs(os.path.dirname(p),exist_ok=True) or json.dump(d,open(p,'w'),indent=2)) for p in [os.path.expanduser('~/.gemini/antigravity/mcp_config.json'),os.path.expanduser('~/.gemini/config/mcp_config.json')]]" ``` **3c Linux Setup** Open a terminal and run the following command in it ``` python3 -c "import os,json;d={'mcpServers':{'adnuntius':{'serverUrl':'https://api.adnuntius.com/api/mcp'}}};[(os.makedirs(os.path.dirname(p),exist_ok=True) or json.dump(d,open(p,'w'),indent=2)) for p in [os.path.expanduser('~/.gemini/antigravity/mcp_config.json'),os.path.expanduser('~/.gemini/config/mcp_config.json')]]" ``` ## Troubleshooting #### Claude Code authentication or tool access issues * Go to 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.adnuntius.com/other-useful-information/mcp-server.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.