The MCP Servers tab in HALO Settings lets you connect external MCP (Model Context Protocol) servers to your profile. Once connected, the tools exposed by those servers become available to your agents inside HALO Studio.
Adding an MCP server
Click the + button to open the Add MCP Server dialog. You will need to provide:
-
Name — a label for this connection within HALO.
-
URL — the endpoint of the MCP server.
-
Type — the transport protocol: HTTP or SSE.
-
Authentication — how HALO authenticates to the server (see below).
Tool call timeout is set to 10 seconds by default.
Transport types
|
Type |
When to use |
|---|---|
|
HTTP |
Standard request/response MCP servers. Most common for self-hosted or API-based servers. |
|
SSE |
Server-Sent Events — for MCP servers that maintain a persistent connection and stream results. |
Authentication options
|
Option |
Description |
|---|---|
|
Open |
No authentication. The server must be publicly accessible or rely on custom headers for security. Use with caution. |
|
Headers |
Pass one or more custom HTTP headers with each request (e.g. API keys or bearer tokens). |
|
OAuth |
OAuth 2.0 authentication. Supports two grant types: Authorization code (browser) — for user-delegated access via browser redirect; Client credentials — for server-to-server authentication using a client ID and secret. |
Viewing available tools
Once a server is connected, its status will show as Connected. Click the ... menu and select Tools List to inspect which tools the server exposes. Each tool shows its name, description, and parameters (including name, type, whether it is required, and a description).
Attaching an MCP server to an agent
Connecting an MCP server to your profile makes it available, but does not automatically give every agent access to it. To use an MCP server's tools within a specific agent, you need to attach it in the agent's settings.
In the Agent Editor, open Agent Settings and navigate to the MCP Servers section. Click + to attach a server from the list of connected servers. You can also browse the tools the server exposes directly from that view.
MCP servers are attached at the server level — all tools from the server become available to the agent. It is not possible to attach individual tools from an MCP server selectively.
Connecting to CM.com's HALO MCP server
CM.com provides its own MCP server that exposes your HALO environment as a set of tools. For setup instructions, see MCP.