Skip to main content

Claude Desktop

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

Prerequisites​

Configuration​

There are a few ways to connect depending on how you use Claude: browser or desktop, and UI or config file.

Claude.ai (browser)​

Pro / Max

  1. Go to claude.ai → Customize → Connectors
  2. Click + then Add custom connector
  3. Enter a name (for example Causely) and the server URL: https://api.causely.app/mcp
  4. Click Add
  5. Sign in to Causely and grant access
  6. Return to Claude.ai, the connector is now active

Team / Enterprise

  1. Go to Organization settings → Connectors
  2. Click Add → Custom → Web
  3. Enter a name (for example Causely) and the server URL: https://api.causely.app/mcp
  4. Click Add
  5. Team members authenticate individually at Customize → Connectors

Claude Desktop​

Desktop UI

  1. Go to Settings → Connectors
  2. Click Customize
  3. Click + sign and select Add custom connector
  4. Enter a name (for example Causely) and the server URL: https://api.causely.app/mcp
  5. Click Add
  6. Sign in to Causely and grant access
  7. Return to Claude desktop, the connector is now active

Developer desktop app

  1. Go to Settings → Developer
  2. Edit Config
  3. Edit claude_desktop_config.json and merge the mcpServers object:
{
  "mcpServers": {
    "causely": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.causely.app/mcp"]
    }
  }
}

Or you can edit the config file directly, Config file location:

PlatformPath
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.

Adding Skills​

Seven skills activate automatically once installed: one master router (causely-mcp) plus six specialists. See the Skills page for the full list, trigger phrases, and override options.

Install

Ensure that Skills are enabled for your Enterprise or Team plan.

  1. Clone the Causely client repo
git clone https://github.com/Causely/development-environment
cd development-environment/skills
  1. Create a .zip file for each sub folder in the skills folder

macOS

for dir in causely-mcp causely-postmortem causely-k8s-investigation causely-health-reporting causely-correlated-incidents causely-change-impact causely-alert-triage; do
  zip -r "${dir}.zip" "$dir" \
    --exclude "*/.DS_Store" \
    --exclude "__MACOSX/*" \
    --exclude "*/.git/*" \
    --exclude "*/Thumbs.db"
done

Windows

foreach ($dir in @(
  "causely-postmortem",
  "causely-mcp",
  "causely-k8s-investigation",
  "causely-health-reporting",
  "causely-correlated-incidents",
  "causely-change-impact",
  "causely-alert-triage"
)) {
  $tmp = New-Item -ItemType Directory -Path "$env:TEMP\$dir"
  Copy-Item -Path $dir\* -Destination $tmp -Recurse -Exclude @('.DS_Store','Thumbs.db')
  Compress-Archive -Path $tmp -DestinationPath "$dir.zip" -Force
  Remove-Item $tmp -Recurse -Force
}
  1. Go to Customize → Skills
  2. Click + sign and select Create skill → Upload a skill
  3. For each of the 7 .zip files: click + → Create skill → Upload a skill, select the file, and save. Repeat until all 7 are uploaded. Each upload creates one skill.

Restart

Quit and reopen Claude Desktop after installing.

Verify

Try: "What's broken right now?" The causely-health-reporting skill should activate.

Try It Now​

  • "List my clusters."
  • "Are there any active symptoms right now?"
  • "What services are currently degraded?"
  • "Draft a postmortem for the most recent incident."

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.