Sentry MCP Server
Offizieller MCP-Server von Sentry, mit dem KI-Coding-Agenten Fehler, Traces und Performance-Daten aus Sentry abrufen und einzelne Issues verwalten.
- Skill Road
- Sentry MCP Server
Kategorien
Beschreibung
Der Sentry MCP Server implementiert das Model Context Protocol und gibt KI-Coding-Agenten Zugriff auf ein Sentry-Konto: Fehler und Issues suchen und im Detail samt Stacktrace ansehen, Events und verteilte Traces abfragen, Performance-Auffälligkeiten eingrenzen, Releases und Projekte einsehen sowie die Sentry-Dokumentation durchsuchen. Dazu kommt ein kleiner Satz schreibender Aktionen – etwa ein Issue auflösen, erneut öffnen, zuweisen oder stummschalten sowie Projekte, Teams und DSNs anlegen. Insgesamt stellt der Server rund zwei Dutzend Werkzeuge bereit; der Schwerpunkt liegt ausdrücklich auf Entwickler- und Debugging-Abläufen, nicht auf vollständiger Sentry-Verwaltung.
Gehostete Variante (empfohlen)
Sentry betreibt den Server als gehosteten Remote-Dienst unter https://mcp.sentry.dev/mcp (HTTP-Transport). Der Pfad lässt sich optional auf eine Organisation (/mcp/{organisation}) oder ein Projekt (/mcp/{organisation}/{projekt}) eingrenzen. Alle Verbindungen laufen über OAuth: Beim ersten Aufruf öffnet der Client ein Browserfenster zur Anmeldung am Sentry-Konto und speichert die Freigabe für weitere Sitzungen. Die natürlichsprachlichen Suchwerkzeuge (search_events, search_issues) funktionieren hier ohne eigenen Schlüssel, weil der Dienst das dafür nötige Sprachmodell selbst bereitstellt.
Lokale Variante
Alternativ lässt sich das quelloffen einsehbare Paket @sentry/mcp-server (zum Prüfzeitpunkt Version 0.39.0) lokal über stdio betreiben:
npx @sentry/mcp-server@latest --access-token=<sentry-user-token>
Der Token stammt aus den Sentry-Kontoeinstellungen und braucht die Rechte org:read, project:read, project:write, team:read, team:write und event:write. Für die natürlichsprachlichen Suchwerkzeuge ist lokal zusätzlich ein eigener Zugang zu einem Sprachmodell-Anbieter nötig (OpenAI, Azure OpenAI, Anthropic oder OpenRouter). Selbst gehostete Sentry-Installationen werden über --host=sentry.example.com (und bei Bedarf --insecure-http) angebunden; einzelne Funktionen wie Seer stehen dort nicht zur Verfügung und lassen sich mit --disable-skills=seer abschalten.
Für Claude Code gibt es zusätzlich ein Plugin-Marketplace:
claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp
Warum die gehostete Variante bevorzugt wird
Sentry hat die gehostete Variante bewusst so gestaltet, dass sie auch die natürlichsprachlichen Suchwerkzeuge ohne eigenen Sprachmodell-Zugang bereitstellt: Der Dienst betreibt das dafür nötige Modell selbst, sodass Nutzer keinen separaten OpenAI- oder Anthropic-Schlüssel konfigurieren müssen. Die lokale Variante bleibt vor allem für Teams relevant, die eine selbst gehostete Sentry-Installation anbinden oder aus Compliance-Gründen keinen Datenverkehr über einen zusätzlichen Drittanbieter-Dienst leiten wollen.
Anbindung, Suche und Selbsthosting
Der gehostete Server liegt unter https://mcp.sentry.dev und meldet per OAuth an. Alternativ lässt sich ein Sentry-Token als Header übergeben. Lokal startet man ihn über stdio mit npx @sentry/mcp-server@latest und einem Zugriffstoken in der Variable SENTRY_ACCESS_TOKEN. Die Suchwerkzeuge search_errors, search_traces, search_logs und search_issues übersetzen Fragen in die Abfragesprache von Sentry. Dafür brauchen sie einen LLM-Anbieter, nämlich OpenAI, Azure OpenAI, Anthropic oder OpenRouter. Ohne diese Konfiguration entfallen nur die Suchwerkzeuge, alles andere funktioniert weiter. Selbst gehostete Sentry-Instanzen bindet man mit der Option --host an. Die Fähigkeit seer ist dann standardmäßig ausgeschlossen.
Typische Einsatzszenarien
Der Server eignet sich besonders für Debugging-Workflows, bei denen ein Coding-Agent direkt nach einem Fehlerbericht fragen und dessen Stacktrace samt Kontext auswerten soll, ohne dass jemand manuell zwischen IDE und Sentry-Oberfläche wechselt. Ebenso hilfreich ist er beim Nachverfolgen von Performance-Regressionen nach einem Deployment oder beim automatisierten Zusammenfassen aller offenen kritischen Issues eines Projekts vor einem Release. Wegen der begrenzten Schreibrechte eignet sich der Server weniger für die vollständige Verwaltung eines Sentry-Kontos, etwa das Anlegen komplexer Alarmregeln.
Voraussetzungen
Ein Sentry-Konto mit Zugriff auf die gewünschte Organisation bzw. das Projekt. Für die gehostete Variante genügt ein MCP-Client mit Unterstützung für Remote-Server über HTTP und OAuth. Für die lokale Variante zusätzlich Node.js (npx), ein Sentry-User-Token mit den passenden Rechten und – für die natürlichsprachliche Suche – ein eigener Zugang zu einem Sprachmodell-Anbieter.
Installationsanleitung
Der Sentry MCP Server lässt sich auf zwei Wegen anbinden: als von Sentry gehosteter Remote-Dienst mit OAuth-Anmeldung oder als lokal über stdio betriebener Server mit einem Sentry-User-Token. Sentry empfiehlt die gehostete Variante.
Schnellstart
Für die gehostete Variante den Remote-Server im MCP-Client eintragen, etwa in Claude Code mit claude mcp add --transport http sentry https://mcp.sentry.dev/mcp, in Cursor über einen mcpServers-Eintrag mit "url": "https://mcp.sentry.dev/mcp" oder in VS Code über einen servers-Eintrag mit "type": "http". Beim ersten Aufruf öffnet der Client den OAuth-Dialog; dort am Sentry-Konto anmelden und den Zugriff bestätigen. Optional lässt sich die URL auf eine Organisation oder ein Projekt eingrenzen.
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Für die lokale Variante in den Sentry-Kontoeinstellungen unter „User Auth Tokens" einen Token mit den Rechten org:read, project:read, project:write, team:read, team:write und event:write erzeugen und den Server per npx @sentry/mcp-server@latest --access-token=<token> starten. Für die natürlichsprachliche Suche zusätzlich die Zugangsdaten eines Sprachmodell-Anbieters als Umgebungsvariablen setzen. Selbst gehostete Sentry-Instanzen über --host= anbinden.
npx @sentry/mcp-server@latest --access-token=<token>
Welche Variante passt
Die gehostete Variante ist am schnellsten eingerichtet, braucht keinen lokalen Prozess und bringt die natürlichsprachliche Fehlersuche ohne eigenen Sprachmodell-Schlüssel mit. Die lokale Variante ist sinnvoll, wenn eine selbst gehostete Sentry-Installation angebunden werden soll oder der MCP-Verkehr das eigene Netz nicht verlassen darf – dann wird für die natürlichsprachliche Suche allerdings ein eigener Zugang zu OpenAI, Azure OpenAI, Anthropic oder OpenRouter benötigt.
Schritt 1: Gehostete Variante anbinden
Den Remote-Server im MCP-Client eintragen. In Claude Code:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
In Cursor oder VS Code stattdessen einen Server-Eintrag mit der URL https://mcp.sentry.dev/mcp anlegen (in VS Code mit "type": "http"). Beim ersten Aufruf öffnet der Client ein Browserfenster für die OAuth-Anmeldung am Sentry-Konto. Wer den Zugriff von vornherein eng halten will, hängt die Organisation oder das Projekt an die URL an: https://mcp.sentry.dev/mcp/meine-orga bzw. https://mcp.sentry.dev/mcp/meine-orga/mein-projekt.
Schritt 2: Lokale Variante anbinden
In den Sentry-Kontoeinstellungen unter „User Auth Tokens" einen Token mit den Rechten org:read, project:read, project:write, team:read, team:write und event:write erzeugen. Den Server dann per npx starten:
npx @sentry/mcp-server@latest --access-token=<token>
Für die natürlichsprachlichen Suchwerkzeuge zusätzlich die Zugangsdaten eines Sprachmodell-Anbieters als Umgebungsvariablen setzen. Eine selbst gehostete Sentry-Installation über --host=sentry.example.com anbinden, bei reinem HTTP zusätzlich --insecure-http; nicht verfügbare Funktionen wie Seer mit --disable-skills=seer abschalten.
Zugriff eng halten
Der Agent sieht alles, was das angemeldete Konto bzw. das Token in Sentry sieht. Für automatisierte Abläufe ein eigenes Token mit möglichst wenigen Rechten verwenden, es wie ein Passwort behandeln und den Pfad auf die benötigte Organisation oder das Projekt eingrenzen. Stacktraces und Events können Geheimnisse oder personenbezogene Daten enthalten – im Zweifel vorab prüfen, welche Projekte der Agent erreichen kann.
Schritt 3: Einrichtung prüfen
Nach dem Verbinden mit einer harmlosen Aufgabe testen, etwa „Zeig mir die zuletzt aufgetretenen ungelösten Fehler in Projekt X". Prüfen, ob nur die erwartete Organisation und die erwarteten Projekte auftauchen, und im Zweifel den Zugriff nachschärfen.
Häufige Verbindungsprobleme
Öffnet sich beim ersten Aufruf kein Browserfenster für die OAuth-Anmeldung, kann das an einer blockierten Pop-up-Funktion im Client liegen oder daran, dass die Umgebung keine grafische Oberfläche bereitstellt – in solchen Fällen zeigt der Client meist eine URL an, die manuell im Browser geöffnet werden kann. Bei der lokalen Variante führt ein abgelaufener oder falsch kopierter Token zu Authentifizierungsfehlern; ein neu erzeugter Token aus den Kontoeinstellungen behebt das üblicherweise.
Wechsel zwischen gehosteter und lokaler Variante
Wer zunächst mit der gehosteten Variante startet und später auf die lokale Variante wechseln möchte, etwa wegen Netzwerkrichtlinien, sollte den bestehenden Client-Eintrag vollständig ersetzen statt beide parallel zu betreiben. Zwei gleichzeitig konfigurierte Sentry-Server unter unterschiedlichen Namen können sonst zu widersprüchlichen Ergebnissen führen, wenn der Agent nicht klar weiß, welchen er ansprechen soll.
Quelle: der gehostete Dienst mcp.sentry.dev und das Repository github.com/getsentry/sentry-mcp (README.md, LICENSE.md) sowie das npm-Paket @sentry/mcp-server, geprüft am 06.09.2026.
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Authentifizierung
Gehostete Variante: OAuth-Anmeldung am Sentry-Konto, im Client ausgelöst; die Freigabe wird für weitere Sitzungen gespeichert. Lokale Variante: Sentry-User-Token (--access-token) mit den Rechten org:read, project:read, project:write, team:read, team:write, event:write; beim HTTP-Transport alternativ als Header Authorization: Sentry-Bearer <token>.
Benötigte Zugriffsrechte
Der effektive Zugriff entspricht dem angemeldeten Sentry-Konto bzw. den Token-Rechten und der optionalen Pfad-Eingrenzung auf Organisation oder Projekt. Innerhalb dieses Rahmens sind vor allem lesende Aktionen möglich (Fehler, Issues, Events, Traces, Releases, Projekte, Dokumentation). Schreibend sind nur wenige Aktionen vorgesehen: Issue-Status und -Zuweisung ändern sowie Projekte, Teams und DSNs anlegen.
Übertragene oder gespeicherte Daten
Anfragen und Werkzeugparameter gehen an die Sentry-API. Antworten enthalten Monitoring-Daten des Kontos – darunter Stacktraces, Event-Details und Trace-Daten, die je nach Anwendung personenbezogene Daten oder Geheimnisse enthalten können – und werden an den MCP-Client sowie dessen Sprachmodell weitergegeben. Bei der gehosteten Variante läuft die Verbindung über den von Sentry betriebenen Dienst unter mcp.sentry.dev, der für die natürlichsprachliche Suche ein eigenes Sprachmodell einsetzt. Bei der lokalen Variante läuft der Server auf dem eigenen Rechner, spricht aber weiterhin die Sentry-API an und schickt Suchanfragen an den konfigurierten Sprachmodell-Anbieter.
Sicherheitsrisiken
Stacktraces und Event-Daten in Sentry können Klartext-Geheimnisse, Tokens oder personenbezogene Daten enthalten; über den Server gelangen diese in den Kontext des Agenten und seines Sprachmodells. Ein zu weit gefasstes Token oder eine Anmeldung mit einem Konto, das viele Organisationen sieht, vergrößert diesen Radius. Den Zugriff über die Pfad-Eingrenzung auf die benötigte Organisation oder das Projekt begrenzen, für automatisierte Abläufe ein eigenes Token mit minimalen Rechten verwenden, dieses wie ein Passwort behandeln und die schreibenden Werkzeuge (Issue-Status, Projekt-/Team-/DSN-Anlage) nur bewusst freigeben.
Lizenz und Kosten
- Lizenz
- FSL-1.1-Apache-2.0
- Kosten
- kostenlos
Der MCP-Server selbst ist kostenlos; der Quellcode ist quelloffen einsehbar (FSL-1.1-Apache-2.0) und wird nach zwei Jahren je Version zu Apache-2.0. Vorausgesetzt wird ein Sentry-Konto – Sentry bietet einen kostenlosen Entwickler-Tarif sowie kostenpflichtige Pläne, die unabhängig vom MCP-Server abgerechnet werden. Bei der lokalen Variante entstehen zusätzlich Kosten beim selbst gewählten Sprachmodell-Anbieter, wenn die natürlichsprachliche Suche genutzt wird.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- Sentry
- Status
- Offizieller Server
- Betriebsart
- Lokal und Remote
- Aktuelle Version
- 0.39.0
- GitHub-Sterne
- 963
- Zuletzt geprüft
- 07.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.