Raygun MCP Server

### 1. Basic Configuration This is the minimal configuration to register the **Raygun MCP Server** with Claude Code, assuming the `raygun-mcp-server` binary is on your `PATH`. ```json { "raygun-mcp-server": { "command": "raygun-mcp-server", "category": "DevTools" } } ``` **Explanation (not part of JSON):** - `"raygun-mcp-server"`: The key under `mcpServers` used by Claude to identify this MCP. - `"command"`: The executable name; Claude will run this to start the MCP server. - `"category"`: Shown in Claude’s UI to group tools; `DevTools` matches the requested category. --- ### 2. Advanced Configuration This example adds explicit arguments, environment variables, and a working directory. Adjust paths and values to match your system. ```json { "raygun-mcp-server": { "command": "raygun-mcp-server", "args": [ "--project", "my-service", "--environment", "staging", "--log-level", "info" ], "env": { "RAYGUN_API_KEY": "rg_XXXXXXXXXXXXXXXXXXXX", "RAYGUN_APP_NAME": "my-service", "RAYGUN_ENDPOINT": "https://api.raygun.com", "RAYGUN_TIMEOUT_MS": "8000" }, "cwd": "/Users/your-user/dev/my-service", "category": "DevTools", "disabled": false } } ``` **Explanation (not part of JSON):** - `"args"`: Extra CLI flags passed to the MCP server: - `--project my-service`: Default Raygun application/project to work with. - `--environment staging`: Default environment filter for errors/crashes. - `--log-level info`: Controls verbosity of the MCP server logging. - `"env"`: - `RAYGUN_API_KEY`: Your Raygun API key (keep secret; don’t commit to VCS). - `RAYGUN_APP_NAME`: Helpful default for tools that need an app name. - `RAYGUN_ENDPOINT`: Custom API endpoint if you use a regional Raygun deployment. - `RAYGUN_TIMEOUT_MS`: HTTP timeout for Raygun API calls, in milliseconds. - `"cwd"`: Directory from which the server will run (often your project root). - `"category"`: Kept as `DevTools` so it appears under development tools. - `"disabled"`: Explicitly `false` so the server is enabled. --- ### 3. Use Case Specific Configuration – Production Incident Triage This configuration is tailored for **production incident triage**: it focuses on the production Raygun app, uses stricter timeouts, and is labeled clearly in the UI so you know it’s pointing at production data. ```json { "raygun-mcp-server-prod": { "command": "/usr/local/bin/raygun-mcp-server", "args": [ "--project", "payments-service", "--environment", "production", "--log-level", "warn", "--default-time-range", "1h", "--max-events", "200" ], "env": { "RAYGUN_API_KEY": "rg_prod_XXXXXXXXXXXXXXXXXXXX", "RAYGUN_APP_NAME": "payments-service-prod", "RAYGUN_ENDPOINT": "https://api.raygun.com", "RAYGUN_TIMEOUT_MS": "5000", "RAYGUN_STRICT_SSL": "true" }, "cwd": "/srv/payments-service", "category": "DevTools", "disabled": false } } ``` **Explanation (not part of JSON):** - Key name `"raygun-mcp-server-prod"`: Distinguishes this from any staging/dev Raygun MCP configs. - `"command"`: Absolute path to the binary, suitable for production environments. - `"args"`: - `--project payments-service`: Targets the production payments app in Raygun. - `--environment production`: Ensures only production errors/incidents are queried. - `--log-level warn`: Reduces noise in logs while still surfacing issues. - `--default-time-range 1h`: Focuses tools on the last hour of incidents by default. - `--max-events 200`: Caps the number of events returned to keep responses manageable. - `"env"`: - `RAYGUN_API_KEY`: A production-only API key (use secrets management in practice). - `RAYGUN_APP_NAME`: Explicitly marks this as the production payments app. - `RAYGUN_TIMEOUT_MS`: Slightly lower timeout for responsiveness during incident triage. - `RAYGUN_STRICT_SSL`: Enforces TLS verification for production safety. - `"cwd"`: Points to the production service directory (adjust to your deployment layout). - `"category"`: Still `DevTools`, but the key name and env values make its purpose clear. - `"disabled"`: `false` so it is active; you can toggle to `true` if you want to temporarily prevent Claude from accessing production Raygun data.