/ Verzeichnis / Playground / Sentry
● Offiziell getsentry 🔑 Eigener Schlüssel nötig

Sentry

von getsentry · getsentry/sentry-mcp

Lassen Sie Ihren KI-Agent die ersten 5 Minuten jeder Sentry-Untersuchung durchführen — finden Sie das Problem, rufen Sie den Stack-Trace ab, identifizieren Sie das fehlerhafte Release.

Sentry's offizieller MCP-Server. Rufen Sie Probleme nach Aktualität/Release/Umgebung ab, erhalten Sie vollständige Stack-Traces und Breadcrumbs, erstellen Sie Querverweise mit Releases. Wandelt einen 'etwas ist kaputt'-Slack-Ping in unter einer Minute in einen triaged Incident um.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

sentry.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": {
      "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": {
      "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": {
      "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": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "sentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

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

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

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

Anwendungsfälle

Praxisnahe Nutzung: Sentry

Triage eines frischen Production-Incidents in 5 Minuten

👤 Bereitschaftsingenieure ⏱ ~5 min intermediate

Wann einsetzen: PagerDuty hat Sie gerade geweckt. Sentry meldet ansteigende Fehler. Sie müssen schnell wissen, was, warum und ob Sie einen Revert durchführen müssen.

Voraussetzungen
  • Sentry-Organisations-Slug + Projekt-Slug — Schauen Sie sich eine beliebige Sentry-URL an: sentry.io/organizations/<ORG>/issues/?project=<ID>
  • Sentry-Benutzer-Auth-Token mit event:read und project:read — sentry.io/settings/account/api/auth-tokens/
Ablauf
  1. Finden Sie das oberste NEUE Problem in der letzten Stunde
    Was ist das oberste neue Problem in unserem web-prod-Projekt in der letzten Stunde, geordnet nach Event-Anzahl?✓ Kopiert
    → Einzelnes Problem mit Titel, Event-Anzahl, betroffene Benutzer, erstmals gesehener Zeitstempel
  2. Rufen Sie das neueste Event mit vollständigem Stack-Trace + Breadcrumbs ab
    Rufen Sie das neueste Event für dieses Problem ab. Zeigen Sie mir den Stack-Trace, das Release und die letzten 5 Breadcrumbs vor dem Crash.✓ Kopiert
    → Datei:Zeile der fehlgeschlagenen Funktion + Abfolge von Benutzeraktionen vor dem Fehler
  3. Identifizieren Sie das einführende Release
    Wurde dieses Problem zum ersten Mal in demselben Release sichtbar oder ist es übertragen worden? Vergleichen Sie das Release-Tag.✓ Kopiert
    → Ja/Nein mit Sicherheit — bestimmt die Revert-Entscheidung

Ergebnis: Eine 3-zeilige Incident-Zusammenfassung, die Sie in Slack einfügen können: was ist kaputt, wer ist betroffen, welches Release hat es verursacht, empfohlene Aktion.

Fallstricke
  • Wenn Ihre Release-Tags nicht verbunden sind, können Sie nicht sagen, welche Bereitstellung den Fehler eingeführt hat — Richten Sie sentry-cli releases in Ihrer CI ein, bevor Sie sich darauf verlassen — ohne dies ist es eine Vermutung
  • Stack-Trace ist in minimiertem JS und unleserlich — Vergewissern Sie sich, dass Quellkarten hochgeladen sind — sentry-cli sourcemaps upload sollte in Ihrer Build-Pipeline vorhanden sein
Kombinieren mit: github · linear

Querverweise von Sentry-Fehlern mit den GitHub-Commits, die sie verursacht haben

👤 Erfahrene Ingenieure, die wiederkehrende Probleme debuggen ⏱ ~30 min advanced

Wann einsetzen: Ein Fehler taucht nach jedem Release immer wieder auf. Sie vermuten einen bestimmten Code-Pfad, möchten aber bestätigen.

Voraussetzungen
  • Sowohl Sentry MCP als auch GitHub MCP installiert — Weitere Informationen finden Sie im GitHub-Handbuch zur Einrichtung
  • Releases mit git SHA in Sentry gekennzeichnet — Verwenden Sie sentry-cli releases new $SHA in CI
Ablauf
  1. Listen Sie die Verlaufsangaben des Problems über Releases auf
    Für Sentry-Problem WEB-3a91 listen Sie jedes Release auf, in dem es sichtbar war, und die Event-Anzahl pro Release.✓ Kopiert
    → Tabelle, die zeigt, dass das Problem nach bestimmten Bereitstellungen ansteigt
  2. Rufen Sie für jeden Spike den Diff ab
    Verwenden Sie für die 3 Releases mit der höchsten Event-Anzahl das GitHub MCP, um den Commit-Diff zu erhalten. Welche Dateien hat jedes Release geändert?✓ Kopiert
    → Gemeinsame Dateien über die Spikes hinweg — der Smoking Gun
  3. Bilden Sie eine Hypothese zur Ursachenanalyse
    Was ist auf Grundlage dieser Diffs die wahrscheinlichste Ursache? Seien Sie spezifisch — zeigen Sie auf die Zeile(n).✓ Kopiert
    → Zeilenlevel-Theorie, die Sie durch Überprüfung des Codes validieren können

Ergebnis: Eine spezifische Code-Level-Hypothese mit Belegen aus den Events von Sentry und den Diffs von GitHub.

Fallstricke
  • Mehrere Commits in einem Release — schwer zu isolieren, welcher verantwortlich ist — Verwenden Sie git bisect-Stil: stellen Sie einen Build mit nur der Hälfte der Commits bereit und überprüfen Sie, ob die Fehlerquote sinkt
Kombinieren mit: github

Generieren Sie einen wöchentlichen Ingenieur-Qualitätsbericht aus Sentry-Daten

👤 Ingenieur-Manager ⏱ ~20 min intermediate

Wann einsetzen: Freitagmittag, vor der Planung der nächsten Woche. Sie möchten wissen, ob die Qualität nach oben oder unten tendiert.

Voraussetzungen
  • Lesezugriff auf alle Ihre Projekte in Sentry — Token begrenzt auf org:read + project:read + event:read
Ablauf
  1. Rufen Sie Fehler- und fehlerfreie Sitzungszählungen für die Woche ab
    Geben Sie mir für unsere Organisation fehlerfreie Sitzungen in % pro Projekt für diese Woche im Vergleich zu letzter Woche. Markieren Sie alle Projekte, bei denen es gesunken ist.✓ Kopiert
    → Pro-Projekt-Vergleich mit Deltas
  2. Identifizieren Sie die Top-Mitwirkenden zum Fehlervolumen
    Welche 5 Probleme sind diese Woche über alle Projekte hinweg für die meisten Events verantwortlich?✓ Kopiert
    → Konkrete Problemliste mit Event-Anzahl und Links
  3. Schlagen Sie einen Fokus für nächste Woche vor
    Basierend auf diesen Daten, was sollte das Team nächste Woche priorisieren zu beheben? Berücksichtigen Sie sowohl Volumen als auch Benutzerauswirkung.✓ Kopiert
    → 3 priorisierte Empfehlungen mit Begründung

Ergebnis: Ein 1-seitiger Bericht, den Sie in Ihrer wöchentlichen Ingenieur-Überprüfung mit konkreten Prioritäten teilen können.

Fallstricke
  • Volumenmetriken werden von einem lauten Problem dominiert, das alles andere maskiert — Filtern Sie dieses Problem aus und ordnen Sie neu — manchmal ist das lauteste nicht das wichtigste
Kombinieren mit: linear · notion

Quantifizieren Sie die Auswirkungen eines bekannten Fehlers auf Benutzer, bevor Sie sich entscheiden, ihn zu beheben

👤 Produktmanager, Tech-Leads triage des Bug-Backlogs ⏱ ~15 min beginner

Wann einsetzen: Es gibt einen bekannten Fehler und das Team debattiert die Priorität. Sie benötigen Daten, keine Meinungen.

Ablauf
  1. Rufen Sie die Benutzerauswirkungsstatistiken des Problems ab
    Für Sentry-Problem WEB-3a91, wie viele eindeutige Benutzer haben es in den letzten 30 Tagen getroffen, und welcher % der Gesamtzahl aktiver Benutzer ist das?✓ Kopiert
    → Absolute Anzahl + Prozentsatz
  2. Segmentieren Sie die betroffenen Benutzer
    Wie sieht die Verteilung der betroffenen Benutzer nach Browser, OS und Kontotyp (bezahlt vs. kostenlos) aus?✓ Kopiert
    → Aufschlüsselung, die zeigt, ob es sich um ein Edge-Case oder Core-Flow-Problem handelt
  3. Vergleichen Sie mit anderen offenen Problemen
    Ordnen Sie unsere Top 10 offenen Fehler nach betroffenen Benutzern in diesem Monat ein. Wo sitzt dieser?✓ Kopiert
    → Kontext für die Priorisierung

Ergebnis: Eine datengesteuerte Prioritätsempfehlung: jetzt beheben, diesen Sprint beheben oder verschieben.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

sentry + github

Sentry → identifizieren Sie das fehlerhafte Release → GitHub → finden Sie den Commit, der es eingeführt hat → entwerfen Sie Revert PR

Problem WEB-3a91 ist nach Release [email protected] angestiegen. Finden Sie die Commits in diesem Release auf GitHub, identifizieren Sie den wahrscheinlichsten Schuldigen und entwerfen Sie einen Revert-PR.✓ Kopiert
sentry + linear

Erstellen Sie automatisch Linear-Probleme aus neuen Sentry-Problemen, die einen Event-Schwellenwert überschreiten

Suchen Sie nach neuen Sentry-Problemen der letzten 24 Stunden mit >100 Events. Erstellen Sie für jede ein Linear-Bug-Ticket, das dem Bereitschaftsingenieur zugewiesen ist.✓ Kopiert
sentry + notion

Wöchentlicher Ingenieur-Qualitätsbericht auf Notion veröffentlicht

Rufen Sie die Sentry-Statistiken dieser Woche ab und erstellen Sie eine Notion-Seite in der Engineering / Weekly Reports-Datenbank.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
list_issues organization, project, query?, sort?, limit? Durchsuchen Sie den Problem-Stream nach Status/Release/Umgebung/Alter 1 API-Aufruf
get_issue issue_id Rufen Sie vollständige Metadaten für ein bestimmtes Problem einschließlich des Release-Bereichs ab 1 API-Aufruf
get_event issue_id, event_id? Rufen Sie den tatsächlichen Stack-Trace und Breadcrumbs zum Debuggen ab 1 API-Aufruf
list_releases organization, project Sehen Sie die Bereitstellungs-Zeitleiste und welches Release was eingeführt hat 1 API-Aufruf
list_projects organization Entdecken Sie, welche Projekte in Ihrer Organisation vorhanden sind 1 API-Aufruf

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Sentry: 40 req/sec pro Token (sehr großzügig). Keine tägliche Obergrenze für die API selbst.
Tokens pro Aufruf
200–1000 Tokens pro Problem/Event-Antwort; große Stack-Traces können 5k erreichen
Kosten in €
Kostenlos: 5k Fehler/Monat. Bezahlte Pläne werden nach Event-Volumen abgerechnet, nicht nach API-Nutzung.
Tipp
API ist kostenlos; wofür Sie wirklich bezahlen, ist die Event-Erfassung. Verwenden Sie Sampling-Regeln in Sentry selbst, um die Erfassungskosten vorhersehbar zu halten.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: org:read project:read event:read
Credential-Speicherung: Sentry-Benutzer-Auth-Token in Umgebungsvariable SENTRY_AUTH_TOKEN
Datenabfluss: Alle Aufrufe an Ihre Sentry-Instanz (sentry.io oder selbstgehostet)
Niemals gewähren: org:write project:admin member:write

Fehlerbehebung

Häufige Fehler und Lösungen

401 Invalid token

Token ist abgelaufen oder hat nicht die angeforderten Scopes. Erstellen Sie neu unter sentry.io/settings/account/api/auth-tokens/

Prüfen: curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" https://sentry.io/api/0/organizations/
404 Project not found

Der Projekt-Slug ist case-sensitiv und muss genau mit der URL übereinstimmen. Überprüfen Sie sentry.io/settings/projects/

Empty stacktrace

Quellkarten nicht hochgeladen. Führen Sie sentry-cli sourcemaps upload als Teil Ihrer Build-Pipeline aus.

Alternativen

Sentry vs. andere

AlternativeWann stattdessenKompromiss
Datadog APM MCPSie sind bereits auf Datadog und möchten einheitliche APM + FehlerTeurer, weniger spezifisch auf Fehler konzentriert
Rollbar / Bugsnag MCPSie zahlen bereits dafürKleineres von der Community erstelltes MCP-Ökosystem

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen