Connect an AI client

Connect an AI client

ICU Visor has two ways to operate:

  • Local mode: install the icuvisor binary, run icuvisor setup, and connect a client to the local MCP server. Use this when the client can launch a local process or reach loopback HTTP.
  • Hosted mode: add https://connect.icuvisor.app/mcp as a remote HTTPS MCP connector and sign in with Intervals.icu OAuth. Use this when the client needs a public endpoint.

Choose your connection

ClientConnectionSetup
Claude DesktopLocal stdio, with a Desktop Extension or manual configurationClaude Desktop
Claude.aiHosted HTTPS with Intervals.icu OAuthClaude.ai
ChatGPT webHosted HTTPS through a custom MCP plugin, subject to account/workspace policyChatGPT
Claude Code, Codex CLI, and other coding clientsLocal stdio; loopback HTTP where supportedClaude Code, Codex CLI, other clients
Local model clientsLocal stdio or loopback HTTP where the client supports MCPOther clients

Switching assistants keeps the same Intervals.icu source data. Available tools depend on your toolset and write permissions; how Resources, Prompts, approvals, and metadata appear depends on the client. Start a fresh conversation after connecting or changing toolsets. Local software is free; your AI provider’s usage limits still apply.

Pick the path that matches your client. After the connection works, start with What can I ask icuvisor? for beginner-friendly prompts before reading the full tool reference.