Get Started with Horizon3.ai-Hosted MCP Server
Set up the MCP Server hosted by Horizon3.ai in your IDE or other AI client.
Prerequisites
- An IDE or AI client that supports streamable HTTP and OAuth 2.1 (e.g. VS Code, Cursor, Windsurf)
- A modern browser for completing the OAuth login
Setting Up Visual Studio Code
To set up the Horizon3-hosted MCP Server in Visual Studio Code:
- Open the command palette in VS Code.
- Click Show and Run Commands.
- Run the command
MCP: Add Server
. - Select
HTTP (HTTP or Server-Sent Events)
as the type. - Enter the server URL:
- US:
https://mcp.horizon3ai.com/mcp
- EU:
https://mcp.horizon3ai.eu/mcp
- US:
- Provide a name for the server (for example,
horizon3-mcp-server
).
# Visual Studio Code creates an `mcp.json` file (or adds to it if it already exists) with the information you just entered
{
"servers": {
"horizon3-mcp-server": {
"url": "https://mcp.horizon3ai.com/mcp",
"type": "http"
}
},
"inputs": []
}
proxy.horizon3ai.com
- After clicking
Allow
, login to your Horizon3 Portal Account following the redirect. Once you successfully login, close the browser and you're ready to get started!
Client Compatibility
The Horizon3 MCP Server works with MCP-compliant clients that support both OAuth 2.1 authentication and HTTP streamable transport. This includes:
- VS Code with MCP extensions - Fully compatible
- Claude Code - Fully compatible
- Claude Desktop - Currently has some known compatibility issues
- Gemini CLI - Full compatible
- Windsurf - Fully compatible
Set Up Other IDEs or Clients
- In your client of choice, enter the server URL:
- US:
https://mcp.horizon3ai.com/mcp
- EU:
https://mcp.horizon3ai.eu/mcp
- US:
- Use streamable HTTP as the transport mode
- Begin the OAuth login process when prompted and complete using your NodeZero credentials after being redirected
Manual Set Up
To set up the Horizon3-hosted MCP Server for other IDEs or clients manually, create an mcp.json
file in your workspace or home directory with an entry for the MCP Server:
{
"servers": {
"horizon3-mcp-server": {
"url": "https://mcp.horizon3ai.com/mcp",
"type": "http"
}
},
"inputs": []
}
Troubleshoot Common Issues
Issue | What You'll See | Solution |
---|---|---|
General connection problems | Authentication fails or MCP server won't connect | Restart your MCP client (VS Code, Claude Code, etc.) - this fixes most issues |
Network/firewall blocking | Can't reach authentication or MCP endpoints | Ensure you can access portal.horizon3ai.com , oauth-proxy.horizon3ai.com , and mcp.horizon3ai.com |
Redirect URI not whitelisted | Error about redirect URI during OAuth flow | Contact support to whitelist your client's specific callback URL if it's not localhost/127.0.0.1 |
Browser doesn't redirect back | Stuck on "redirecting" or success page | Close the browser tab and restart your MCP client connection |
Session expired | MCP server stops responding after ~1 hour | Reconnect to get a fresh authentication token |