# Sentry MCP Server

Connects AI assistants to Sentry for searching errors, analyzing performance, triaging issues, reading documentation, and managing projects — all via the Model Context Protocol.

All connections use OAuth. The first connection will trigger an authentication flow to connect to your Sentry account.

## Connecting

The base MCP server address is: `https://sentry-mcp.controlink.pt/mcp`

You can optionally scope the connection to an organization or project:

- `https://sentry-mcp.controlink.pt/mcp/{organizationSlug}` — scoped to one organization
- `https://sentry-mcp.controlink.pt/mcp/{organizationSlug}/{projectSlug}` — scoped to one project

When scoped, tools automatically default to the constrained org/project and unnecessary discovery tools are hidden. Scoping to a project is recommended when possible.

### Query Parameters

- `?experimental=1` — Enable forward-looking tool variants and experimental features

Parameters can be combined: `https://sentry-mcp.controlink.pt/mcp/my-org/my-project?experimental=1`

## Setup Instructions

### Claude Code

```bash
claude mcp add --transport http sentry https://sentry-mcp.controlink.pt/mcp/{organizationSlug}/{projectSlug}
```

### Cursor

Use the "Install MCP Server" button, or manually add to MCP settings:

```json
{
  "mcpServers": {
    "sentry": {
      "url": "https://sentry-mcp.controlink.pt/mcp/{organizationSlug}/{projectSlug}"
    }
  }
}
```

### VSCode

Command Palette → "MCP: Add Server" → HTTP → enter the endpoint:

```
https://sentry-mcp.controlink.pt/mcp/{organizationSlug}/{projectSlug}
```

### Other Clients

Any MCP-compatible client can connect using the HTTP transport at the endpoint URL above.

## Local Server via the Sentry CLI

Install the Sentry CLI and log in, then register `sentry mcp` as a stdio MCP server. It uses the CLI login, so the MCP config needs no token.

```bash
curl https://cli.sentry.dev/install -fsS | bash
sentry auth login
claude mcp add sentry -- sentry mcp
```

Other clients take the same command:

```json
{
  "mcpServers": {
    "sentry": {
      "command": "sentry",
      "args": ["mcp"]
    }
  }
}
```

The CLI also installs with `brew install getsentry/tools/sentry`, `npm install -g sentry`, or `irm https://cli.sentry.dev/install.ps1 | iex` on Windows. See https://cli.sentry.dev/getting-started/.

Pass a target after the command to limit it:

- `sentry mcp my-org/` — Limit to one organization
- `sentry mcp my-org/my-project` — Limit to a specific project

For self-hosted Sentry, log in with `sentry auth login --url https://sentry.example.com`, then set `SENTRY_HOST` in the MCP server's environment. See https://cli.sentry.dev/self-hosted/.

Run `sentry mcp --help` for every flag and environment variable. To run the server without installing the CLI, use the legacy `npx @sentry/mcp-server` package.