Sentry MCP — Anwendungsfälle, Installieren & Live-Demo

Name: Sentry MCP MCP Server
Author: getsentry

Warum nutzen

Hauptfunktionen

Issues mit Sentrys Abfragesyntax durchsuchen
Vollständigen Event-Payload abrufen: Stack Trace, Breadcrumbs, Request, Tags
Release-Health: Regressionserkennnung, Adoption, Absturzfreiheitsrate
Performance-Traces mit Span-Aufschlüsselung
Projekt- und Team-Metadaten für projektübergreifende Abfragen

Live-Demo

In der Praxis

sentry-mcp-getsentry.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add sentry-mcp-getsentry -- npx -y @sentry/mcp-server

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Sentry MCP

Produktionsfehler end-to-end debuggen ohne Claude zu verlassen

👤 Entwickler beim Triagieren von On-Call-Alerts ⏱ ~20 min intermediate

Wann einsetzen: Sentry-Alert ausgelöst; Root Cause jetzt gebraucht.

Voraussetzungen

Sentry Auth-Token — User Settings → Auth Tokens → mit 'project:read', 'event:read', 'org:read' erstellen
Token in Umgebungsvariable — SENTRY_AUTH_TOKEN und SENTRY_HOST setzen (sentry.io oder self-hosted)

Ablauf

Issue finden

Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ Kopiert

→ Issue-ID + Anzahl + erste/letzte Sichtung
Vollständigen Kontext abrufen

Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ Kopiert

→ Vollständiger Event-Payload mit Frames + Trail von Benutzeraktionen
Mit Deploy korrelieren

What release was running when this first appeared? List the commits in that release.✓ Kopiert

→ Release-Tag + Commit-Liste
Fix vorschlagen

Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ Kopiert

→ Spezifische Datei + Zeile referenziert; konkreter Patch

Ergebnis: Vom Alert zum Kandidaten-Fix in Minuten, mit vollständiger Beweiskette.

Fallstricke

Source Maps fehlen — Stack-Frames nutzlos — Source-Map-Upload in Sentry-Releases prüfen; ohne Maps hat Claude nichts zum Analysieren

Kombinieren mit: github

Pre-Flight-Check vor der Release-Promotion

👤 Release-Engineers, Deploy-Gatekeeper ⏱ ~15 min intermediate

Wann einsetzen: Kurz vor der Promotion eines Canary-Releases auf 100%.

Ablauf

Release-Health vergleichen

Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ Kopiert

→ Pro-Release Absturzfreiheits-%, Adoption, Regressionsanzahl
Neue Fehler prüfen

List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ Kopiert

→ Liste neuer Issues mit Anzahlen
Empfehlen

Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ Kopiert

→ Klare Empfehlung mit genannten Schwellenwerten

Ergebnis: Datengestützte Promote/Halt-Entscheidung, kein Bauchgefühl.

Fallstricke

Adoption zu niedrig für statistische Aussagekraft — Claude sollte niedrige Adoptionsfenster als nicht schlüssig markieren — nicht so tun als wüsste man es

Performance-Regression mit Transaction-Traces untersuchen

👤 Backend-Entwickler auf Latenz-Jagd ⏱ ~25 min advanced

Wann einsetzen: P95-Latenz auf /checkout ist nach dem letzten Deploy gestiegen.

Ablauf

Aktuellen langsamen Trace abrufen

Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ Kopiert

→ Trace mit Span-Aufschlüsselung
Neuen Span finden

Compare span list to a similar trace from last week. Which spans are new or longer?✓ Kopiert

→ Diff: neuer DB-Query 'SELECT cart_items', durchschnittlich 1,4s
Code-Bezug herstellen

What commit added that query? Suggest an index or a query rewrite.✓ Kopiert

→ Commit + konkreter Fix-Vorschlag

Ergebnis: Root Cause einer Performance-Regression mit codebasiertem Fix-Vorschlag.

Fallstricke

Trace-Sampling-Rate zu niedrig — kein langsamer Trace erfasst — Sample-Rate vorübergehend erhöhen, oder Claude bitten stattdessen Stats-Endpoints zu verwenden

Kombinieren mit: github

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

sentry-mcp-getsentry + github

Vom Sentry-Stack-Frame direkt zu einem PR-Entwurf

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ Kopiert

sentry-mcp-getsentry + linear

Engineering-Tickets automatisch aus Regressionen anlegen

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
search_issues	project, query, statsPeriod?	Issues nach Sentry-Abfrage filtern	1 Sentry API call
get_issue	issue_id	Überblick über ein einzelnes Issue	1 API call
get_event	event_id or 'latest'	Bestimmtes Vorkommen mit vollständigem Kontext abrufen	1 API call
list_releases	project, version?	Release-übergreifender Vergleich	1 API call
get_trace	trace_id	Performance-Untersuchung	1 API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Standard-Sentry-API-Rate-Limits — Bursts können 429 auslösen
Tokens pro Aufruf: Event-Payload kann 5–20k Tokens sein — selektiv abrufen
Kosten in €: Kostenlos für Sentry Developer Plan; kostenpflichtige Pläne haben höhere Rate-Limits
Tipp: Zuerst search_issues einengen; get_event nur für Kandidaten — nicht für gesamte Ergebnislisten

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: project:read event:read org:read

Credential-Speicherung: SENTRY_AUTH_TOKEN-Umgebungsvariable (scopedbegrenzten, projektgebundenen Token verwenden)

Datenabfluss: Alle Aufrufe an deinen Sentry-Host (sentry.io oder self-hosted)

Niemals gewähren: project:write oder org:write an einen chat-gesteuerten Agenten

Event-Daten können PII enthalten (Request-Bodies, User-IDs) — Sentrys Datenscrubbing-Regeln vorgelagert anwenden

Fehlerbehebung

Häufige Fehler und Lösungen

401 Unauthorized

Token abgelaufen oder Scope falsch — mit den aufgelisteten Read-Scopes neu generieren

Prüfen: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

Stack Trace zeigt nur minifizierte Frames

Source-Map-Upload in der Release-Pipeline prüfen; ohne Maps kann Claude keine Frames analysieren

Prüfen: Sentry UI → Release → Artifacts

404 auf ein bekanntes Issue

Issue ist in einem Projekt, das der Token nicht abdeckt — Token auf das Projekt neu begrenzen

Self-hosted Sentry — Verbindung verweigert

SENTRY_HOST explizit auf deine Instanz-URL mit Protokoll setzen

Prüfen: curl $SENTRY_HOST/api/0/

Alternativen

Sentry MCP vs. andere

Alternative	Wann stattdessen	Kompromiss
Datadog MCP	Das Team nutzt Datadog APM/Error Tracking	Andere Abdeckung; APM-first, weniger issue-fokussiert
Honeycomb MCP	Observability-first Shop der Events statt Stack Traces nutzt	Kein erstklassiges Issue-Grouping; trace-zentriert

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen