sentry-self-hosted-mcp

MCP (Model Context Protocol) server for integrating self-hosted Sentry with AI assistants — Cursor, Claude Desktop, and any other MCP-compatible clients.

Tools

Related MCP server: Sentry MCP Server

Requirements

• Node.js 18+

• Self-hosted Sentry instance with API access

• Auth token with org:read, project:read, event:read scopes

Installation

npm install
npm run build

Configuration

The server reads three environment variables:

Tokens are created in Settings → Auth Tokens in Sentry.

Connecting to Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sentry-selfhosted": {
      "command": "npx",
      "args": ["@vitaliypanait/sentry-self-hosted-mcp"],
      "env": {
        "SENTRY_HOST": "https://sentry.example.com",
        "SENTRY_TOKEN": "sntrys_...",
        "SENTRY_ORG_SLUG": "my-org"
      }
    }
  }
}

Local development alternative (if running from a cloned repo):

{
  "mcpServers": {
    "sentry-selfhosted": {
      "command": "node",
      "args": ["/absolute/path/to/sentry-mcp/dist/index.js"],
      "env": {
        "SENTRY_HOST": "https://sentry.example.com",
        "SENTRY_TOKEN": "sntrys_...",
        "SENTRY_ORG_SLUG": "my-org"
      }
    }
  }
}

Connecting to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sentry-selfhosted": {
      "command": "npx",
      "args": ["@vitaliypanait/sentry-self-hosted-mcp"],
      "env": {
        "SENTRY_HOST": "https://sentry.example.com",
        "SENTRY_TOKEN": "sntrys_...",
        "SENTRY_ORG_SLUG": "my-org"
      }
    }
  }
}

Cursor Rule

To make Cursor automatically fetch Sentry context when you mention an issue or ask about a bug, add a rule to your project.

Copy examples/cursor-rule.mdc into your project as .cursor/rules/sentry.mdc.

With alwaysApply: false the rule activates only when relevant (recommended). Change to alwaysApply: true to apply it to every request in the project.

Development

# Run the compiler in watch mode
npm run dev

# Type check
npx tsc --noEmit

Stack

• MCP SDK — AI interaction protocol

• Axios — HTTP client for the Sentry API

• Zod — input validation for tools