Claude Desktop

Ask Causely questions in natural language from the Claude desktop app, no terminal, no code.

Prerequisites

• Active Causely account
• Claude Desktop installed
• Node.js on the PATH visible to the app (required for mcp-remote)

Configuration

Claude Desktop does not support native HTTP MCP, so Causely uses mcp-remote as a local stdio bridge. Node.js must be installed and npx must be on the PATH the app sees at launch.

Edit claude_desktop_config.json and merge the mcpServers object:

{
  "mcpServers": {
    "causely": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.causely.app/mcp"]
    }
  }
}

Config file location

Platform	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Restart

Quit and reopen Claude Desktop. On first connect, a browser window opens for Causely OAuth login. After you authorize, Claude Desktop stores the token and reconnects automatically on subsequent launches.

Try It Now

• "List my clusters."
• "Are there any active symptoms right now?"
• "What services are currently degraded?"

Known Gotcha

Claude Desktop launches as a GUI app and does not inherit your shell's PATH. If npx is not found at launch, install Node.js globally, not via nvm or a shell-managed version manager, so the binary is visible to the app process. On macOS, the official Node.js installer or brew install node is the most reliable approach.