MCP | Knowledge Center

HALO exposes a Model Context Protocol (MCP) server that allows external MCP clients — such as Claude, Cursor, or your own custom agents — to interact with your HALO environment. This enables you to trigger agents, query knowledge, and use HALO's capabilities as tools in any MCP-compatible workflow.

Server details

Property	Value
URL	`https://api.cm.com/halo/core/mcp`
Transport	HTTP
Authentication	Custom headers (see below)

Required headers

Header	Value	Where to find it
`X-CM-PRODUCTTOKEN`	Your MCP product token	Create an MCP type token under Settings > Product Tokens
`CM-ACCOUNT-ID`	Your CM.com account ID	Available in your CM.com platform account settings, or in the URL when navigating HALO Studio
`CM-PROFILE-ID`	The HALO profile ID to connect to	Found in the URL when navigating your HALO profile in HALO Studio

Creating an MCP token

In HALO Studio, go to Settings > Product Tokens.
Click + and give the token a descriptive name (e.g. Claude Desktop MCP).
Select type MCP and save.
Copy the generated token immediately — it is only shown once. Use it as the value for X-CM-PRODUCTTOKEN.

Treat your product token like a password. Do not share it publicly or commit it to source control. If a token is compromised, delete it from Product Tokens immediately and create a new one.

Connecting from Claude Code

Use the claude mcp add command to register the HALO server. Run this in your terminal, outside a Claude session:

claude mcp add --transport http halo https://api.cm.com/halo/core/mcp \
  --header "X-CM-PRODUCTTOKEN: <your-mcp-token>" \
  --header "CM-ACCOUNT-ID: <your-account-id>" \
  --header "CM-PROFILE-ID: <your-profile-id>"

To share the configuration with your team, add it to .mcp.json in your project root. Store credentials as environment variables rather than hardcoding them:

JSON

{
  "mcpServers": {
    "halo": {
      "type": "http",
      "url": "https://api.cm.com/halo/core/mcp",
      "headers": {
        "X-CM-PRODUCTTOKEN": "${HALO_MCP_TOKEN}",
        "CM-ACCOUNT-ID": "${HALO_ACCOUNT_ID}",
        "CM-PROFILE-ID": "${HALO_PROFILE_ID}"
      }
    }
  }
}

Verify the connection by running claude mcp list — the server should show ✓ Connected. For full Claude Code MCP documentation, see code.claude.com/docs/en/mcp.

Connecting from Claude.ai

Go to claude.ai/customize/connectors.
Click Add connector.
Set the URL to https://api.cm.com/halo/core/mcp.
Select Headers as the authentication type.
Add the three required headers: X-CM-PRODUCTTOKEN, CM-ACCOUNT-ID, and CM-PROFILE-ID.
Save the connector.

Once added, the connector is available in all your Claude.ai conversations and loads automatically when you sign into Claude Code with the same account.

Connecting from ChatGPT

Developer Mode required. MCP server connections in ChatGPT are available for Plus, Pro, Team, Enterprise, and Edu subscribers with Developer Mode enabled.

In ChatGPT, go to Settings > Connectors.
Under Advanced, enable Developer Mode.
Click Create and enter a name (e.g. HALO) and the URL https://api.cm.com/halo/core/mcp.
Configure authentication and add the three required headers: X-CM-PRODUCTTOKEN, CM-ACCOUNT-ID, and CM-PROFILE-ID.
Check I trust this provider and click Create.

To use the connector in a conversation, click + → More → Developer Mode and enable the HALO connector for that chat.