Claude Code
Connect Causely to Claude Code to run incident triage, service health checks, and reliability reports without leaving the terminal.
Prerequisites
- Active Causely account
- Claude Code installed
Configuration
Create or update .mcp.json at the root of your repository:
{
"mcpServers": {
"causely": {
"type": "http",
"url": "https://api.causely.app/mcp"
}
}
}
Config file location
| Scope | Path |
|---|---|
| Project (repo-level) | .mcp.json at the repository root |
| User (all projects) | ~/.claude/mcp.json |
To register Causely at user scope without editing JSON directly, run:
claude mcp add --scope user --transport http causely https://api.causely.app/mcp
Restart
Claude Code reads .mcp.json at session start. After saving the file, begin a new Claude Code session (claude). Run /mcp inside Claude Code to confirm causely appears as a connected server.
Try It Now
- "List my clusters."
- "Are there any active symptoms right now?"
- "What services are currently degraded?"
Known Gotcha
Project .mcp.json is committed to source control and visible to all contributors. If you add static credentials via headers, use user-scope config (~/.claude/mcp.json) or the --scope user flag so secrets never land in the repository. See Advanced Authentication for credential setup.