- XCOR MCP server: Connects to your tenant and requires authentication.
- Documentation MCP server: Serves public XCOR documentation and doesn’t require authentication.
- Generate an XCOR API token, either through a personal access token or a service account.
-
Use OAuth. To use the XCOR MCP server with OAuth,
your MCP client must support OAuth.
OAuth authentication with the XCOR MCP server has been tested with the following MCP clients only.
Prerequisites
If you’re authenticating your MCP client with an XCOR API token, use one of the following options to generate one:- Personal access: Create a personal access token to authenticate your user account with XCOR. When you authenticate with a personal access token, XCOR associates the actions you take with your identity and respects the permissions granted to your user account’s team.
- Programmatic access: Create an unrestricted service account to create a persistent identity for a service or agent that you want to authenticate with your MCP client. You must have administrative access to create a service account.
Authenticating using Claude Code
To authenticate with the XCOR MCP server from Claude Code, add the MCP server as a remote HTTP server.-
From within Claude Code, run the following commands to add the XCOR MCP server
and the public documentation MCP server:
Replace the following for the XCOR MCP server:
-
Replace
TENANTwith the name of your Cortex XCOR tenant. -
Replace
API_TOKENwith the API token generated from your service account. Cortex XCOR recommends storing your API token in a separate file or Kubernetes Secret and calling it using an environment variable, such as$API_TOKEN.
To authenticate using OAuth instead of an XCOR API token, omit the--headerflag. You can also use the/mcpcommand to authenticate with OAuth authentication. -
Replace
-
Test your connection with the XCOR MCP server:
Authenticating using Codex command line interface
To authenticate with the XCOR MCP server from the Codex command line interface, add the MCP server as a streamable HTTP server.-
Store your XCOR API token in the
CHRONOSPHERE_API_TOKENenvironment variable. The Codex command line interface reads the token from this variable when it connects to the XCOR MCP server:Replace the following:-
Replace
API_TOKENwith the API token generated from your service account. Cortex XCOR recommends storing your API token in a separate file or Kubernetes Secret and calling it using an environment variable, such as$API_TOKEN.
-
Replace
-
Run the following commands to add the XCOR MCP server and the public
documentation MCP server:
Replace the following for the XCOR MCP server:
-
Replace
TENANTwith the name of your Cortex XCOR tenant.
To authenticate using OAuth instead of an XCOR API token, skip the previous step and omit the--bearer-token-env-varflag. When the Codex command line interface detects OAuth support, it starts the OAuth flow after adding the server. Otherwise, runcodex mcp login chronosphereto authenticate with OAuth. -
Replace
-
Test your connection with the XCOR MCP server:
Authenticating using Cursor
To authenticate with the XCOR MCP server from Cursor, modify themcp.json
file to include the XCOR MCP server remote endpoint.
-
From within Cursor,
access the
mcp.jsonfile. -
Add the following configuration to the
mcp.jsonfile to add the XCOR MCP server and the public documentation MCP server:Replace the following for the XCOR MCP server:-
Replace
TENANTwith the name of your Cortex XCOR tenant. -
Replace
API_TOKENwith the API token generated from your service account. Cortex XCOR recommends storing your API token in a separate file or Kubernetes Secret and calling it using an environment variable, such as$API_TOKEN.
To authenticate using OAuth instead of an XCOR API token, omit theheaderssection from the configuration. -
Replace
-
Save and close the
mcp.jsonfile. - Refresh the MCP server settings in Cursor.
Authenticating using Gemini command line interface
To authenticate with the XCOR MCP server from the Gemini command line interface, add the MCP server as an HTTP server.-
Run the following commands to add the XCOR MCP server and the public
documentation MCP server:
Replace the following for the XCOR MCP server:
-
Replace
TENANTwith the name of your Cortex XCOR tenant. -
Replace
API_TOKENwith the API token generated from your service account. Cortex XCOR recommends storing your API token in a separate file or Kubernetes Secret and calling it using an environment variable, such as$API_TOKEN.
--scope userflag saves the configuration in your user settings instead of the current project, so your API token isn’t stored in project files.To authenticate using OAuth instead of an XCOR API token, omit the--headerflag. The Gemini command line interface detects that the server requires OAuth and starts the OAuth flow. You can also use the/mcp auth chronospherecommand to authenticate with OAuth. -
Replace
-
Test your connection with the XCOR MCP server:
Authenticating using Visual Studio Code
To authenticate with the XCOR MCP server from Visual Studio Code, add the MCP server to the GitHub Copilot MCP configuration file.-
Store your XCOR API token in the
CHRONOSPHERE_API_TOKENenvironment variable on the host where Visual Studio Code runs. Visual Studio Code reads the token from this variable when it connects to the XCOR MCP server:Replace the following:-
Replace
API_TOKENwith the API token generated from your service account. Cortex XCOR recommends storing your API token in a separate file or Kubernetes Secret and calling it using an environment variable, such as$API_TOKEN.
-
Replace
-
Open the
~/.copilot/mcp-config.jsonfile. If the file doesn’t exist, create it. -
Add the following configuration to the
mcp-config.jsonfile to add the XCOR MCP server and the public documentation MCP server:Replace the following for the XCOR MCP server:-
Replace
TENANTwith the name of your Cortex XCOR tenant.
To authenticate using OAuth instead of an XCOR API token, skip the first step and omit theheaderssection from the configuration. When Visual Studio Code prompts you, complete the OAuth flow. -
Replace
-
Save and close the
mcp-config.jsonfile. - In Visual Studio Code, run Chat: Open Customizations and select MCP Servers.