MCP set up
This page walks you through connecting an AI client to the MCP server for UsageCloud, enrolling your UsageCloud access key, and verifying your connection. If connecting an additional client, repeat only the connection steps below; your access key enrollment carries over automatically.
Before you connect an AI client, see MCP server for UsageCloud for what the client receives.
Note!
Two different server URLs and enrollment page links apply depending on your location. These instructions contain examples using both URLs. Please ensure you use the relevant URL and enrollment page for your location.
Connecting to the UsageCloud MCP server (high-level steps)
Ensure you have a UsageCloud account with admin access
Grant stream management scope access in Application Access; seehttps://infozone.atlassian.net/wiki/x/AQCAMg.
Copy and save the Client ID + Secret in a secure location.
Set up the connector in the AI client of your choice using the relevant server URL for your location:
Environment | Server URL | Enrollment page |
|---|---|---|
EU Production | ||
US Production |
Note!
See the Connector setup guide below for steps for the AI Clients we have tested. The MCP server should work with other clients too.
You may need to authorize the client you are using to connect to the MCP. For example, when connecting with Claude Desktop, an authorization prompt appears when you click Connect.
Enrol your UsageCloud key by clicking the relevant enrollment page link (see step 4). Enter your UsageCloud account Client ID and Secret. This is a one-time setup only, and you will see: "✓ Enrolled. You can close this tab and use your AI client." when successfully enrolled.
Test that it works - ask your assistant: "Run whoami and confirm my key is set up." It should report that you are enrolled. Then try: "List my streams."
Note!
Your key is stored securely and only works for you. If you ever get a new key, just enroll again - it replaces the old one. To remove it, ask your assistant to run forget_my_ce_key.
Connector setup guide for tested AI clients
These guides are written for users connecting the UsageCloud MCP to an AI client for the first time. If you have already enrolled successfully, then you can skip the 'Enrol your access key' step.
Claude (Claude and Claude Desktop)
Requirement: A paid Claude plan.
Open Settings, then Connectors.
Click Add custom connector.
In the Name field, enter
MCP server for UsageCloud.In the URL field, enter the relevant MCP server URL for your location (see the table in the High-level steps). Do not add any Advanced settings.
Click Add.
Click Connect and authorize the connection between the UsageCloud MCP and Claude by clicking Accept.
Check the connector's tool permissions. These are set to 'needs approval' by default, and you can update them as needed.
Note!
To check if the UsageCloud MCP is connected, go to Settings > Connectors. You will see a tick next to the connector.
Enrol your access key at the relevant enrolment page (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you also need to supply your login details.
Test that it works - ask your assistant: "Run whoami and confirm my key is set up." It should report that you are enrolled. Then try: "List my streams."
Claude Code (terminal)
Requirement: A terminal with the Claude Code CLI installed.
From a terminal, run the following command to register the MCP server:
EU
claude mcp add --transport http usagecloud https://mcp.digitalroute.io/US
claude mcp add --transport http usagecloud https://mcp.us.digitalroute.io/Start Claude Code:
claudeRun the
/mcpcommand, select http://Claude.ai UsageCloud MCP, and select Authenticate. A browser window opens. Click Continue connecting on the Claude confirmation screen. If not already signed in to your UsageCloud account, you will be asked to sign in next. Either way, you will see an Authorize App screen. Click Accept to finish (this appears every time, even if you were already signed in).Enrol your access key at the relevant enrolment page for your location (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you also need to supply your login details.
To test that it works, run:
whoami and confirm my key is set upThen try:
List my streamsAlternative 1
If you prefer adding the server directly by editing the config file (~/.claude.json or your project's .mcp.json):
EU
{
"mcpServers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.digitalroute.io/"
}
}
}US
{
"mcpServers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.us.digitalroute.io/"
}
}
}Restart Claude Code afterwards, then authenticate with /mcp as in step 3.
Verifying the connection
claude mcp list- lists all configured MCP serversclaude mcp get usagecloud- shows the details for this server
ChatGPT
Requirement: a paid plan with developer mode turned on:
Open Settings, then Apps and Connectors, then Advanced settings, and turn on Developer mode. On a Business or Enterprise workspace, an administrator might need to allow Developer mode first.
Open Settings, then Apps and Connectors, and click Create.
In the Name field, enter
MCP server for UsageCloud.In the MCP server URL field, enter the relevant MCP server URL for your location (see the table in the High-level steps)
Set Authentication to OAuth.
Click Create, then complete the sign-in in the window that opens.
In a chat, open the + menu, select Developer mode, and turn on MCP server for UsageCloud.
Enrol your access key at the relevant enrolment page (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you also need to supply your login details.
Test that it works - ask your assistant: "Run whoami and confirm my key is set up." It should report that you are enrolled. Then try: "List my streams."
Note!
ChatGPT shows a confirmation before each tool call.
ChatGPT Codex (terminal)
Requirement: A terminal with the Codex CLI installed and a ChatGPT account.
From a terminal, run the following command to register the MCP server:
EU
codex mcp add usagecloud --url https://mcp.digitalroute.io/US
codex mcp add usagecloud --url https://mcp.us.digitalroute.io/Authenticate with the server:
codex mcp login usagecloudNote! Step 1 (codex mcp add) automatically completes the OAuth login for servers that support it, so you usually see "Successfully logged in" right after step 1, without needing step 2. Step 2 (codex mcp login) is still useful if you need to re-authenticate later, for example, after an expired or revoked session.
Complete the sign-in in the browser window that opens.
Enrol your access key at the relevant enrolment page for your location (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you will also need to supply your login details.
Start Codex:
codexTo test that it works, run:
Using the usagecloud MCP tools, run whoami and confirm my key is set upThen try:
List my streamsAlternative 1
If you prefer adding the server directly by editing the config file (~/.codex/config.toml):
EU
[mcp_servers.usagecloud]
url = "https://mcp.digitalroute.io/"US
[mcp_servers.usagecloud]
url = "https://mcp.us.digitalroute.io/"Restart codex afterwards, then authenticate with codex mcp login usagecloud as in step 2.
Verifying the connection
codex mcp list- lists all configured MCP serverscodex mcp get usagecloud- shows the details for this server
Visual Studio Code with GitHub Copilot
Requirement: VS Code 1.102 or newer.
Open the Command Palette and run MCP: Add Server....
Select HTTP as the server type.
Enter the relevant MCP server URL (see the table in the High-level steps)
Enter
usagecloudas the server name.Choose Global or Workspace scope.
Complete the sign-in when Visual Studio Code prompts you.
In the Chat view, switch to Agent mode, open the tools picker, and turn on usagecloud.
Alternative 1
If you prefer adding the server directly by editing the config file (mcp.json):
EU
{
"servers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.digitalroute.io/"
}
}
}US
{
"servers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.us.digitalroute.io/"
}
}
}Restart VS Code afterwards, then authenticate with /mcp as in step 3.
Enrol your access key at the relevant enrolment page for your location (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you also need to supply your login details.
Test that it works - ask your assistant: "Run whoami and confirm my key is set up." It should report that you are enrolled. Then try: "List my streams."
Copilot CLI (terminal)
Requirement: A terminal with the GitHub Copilot CLI installed (npm install -g @github/copilot) and an active Copilot subscription.
From a terminal, run the following command to register the MCP server:
EU
copilot mcp add --transport http usagecloud https://mcp.digitalroute.io/US
copilot mcp add --transport http usagecloud https://mcp.us.digitalroute.io/Start Copilot CLI:
copilotRun the
/mcpcommand, select usagecloud, and select Authenticate. Complete the sign-in in the browser window that opens.Enrol your access key at the relevant enrolment page for your location (see the table in the High-level steps). If you are already logged into your account, you only need to enter your client ID and Secret. If not logged in, you also need to supply your login details.
To test that it works, run:
whoami and confirm my key is set upThen try:
List my streamsAlternative 1
Instead of step 1, you can start copilot and run /mcp add, then:
Server Name:
usagecloudServer Type:
HTTPServer URL (EU):
https://mcp.digitalroute.io/Server URL (US):
https://mcp.us.digitalroute.io/Tools:
*
Press Ctrl+S to save.
Alternative 2
If you prefer adding the server directly by editing the config file (mcp.json):
EU
{
"mcpServers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.digitalroute.io/",
"tools": ["*"]
}
}
} US
{
"mcpServers": {
"usagecloud": {
"type": "http",
"url": "https://mcp.us.digitalroute.io/",
"tools": ["*"]
}
}
} Restart copilot afterwards, then authenticate with /mcp as in step 3.
Verifying the connection
copilot mcp list- lists all configured MCP serverscopilot mcp get usagecloud- shows the details for this server/mcp(inside a session) - shows connection status and lets you re-authenticate