Connecting clients¶

The Kelvin MCP server endpoint is your instance URL with /mcp appended:

https://<your-instance>.kelvin.ai/mcp

When you connect for the first time, your client opens a browser window to sign in through Keycloak. After signing in, the client stays authenticated and manages token refresh automatically.

The sections below show how to configure each supported client.

Claude Code (CLI)¶

claude mcp add --transport http kelvin https://<your-instance>.kelvin.ai/mcp

Claude Desktop¶

Go to Settings > Connectors and select Add custom connector, then enter:

Name:  Kelvin
URL:   https://<your-instance>.kelvin.ai/mcp

Cursor¶

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kelvin": {
      "url": "https://<your-instance>.kelvin.ai/mcp"
    }
  }
}

VS Code¶

Add to .vscode/mcp.json or your user settings:

{
  "servers": {
    "kelvin": {
      "type": "http",
      "url": "https://<your-instance>.kelvin.ai/mcp"
    }
  }
}

Clients that only support stdio or local servers¶

Some clients do not support remote HTTP MCP servers directly. Use mcp-remote to bridge the connection:

{
  "mcpServers": {
    "kelvin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://<your-instance>.kelvin.ai/mcp"]
    }
  }
}

mcp-remote handles the OAuth flow and proxies the stdio protocol to the remote Streamable HTTP endpoint.