Sentry MCP

Was ist Sentry MCP?

Sentry MCP ist ein Open-Source MCP-Server. Er ermöglicht sicheren, strukturierten Zugriff auf Ihre Sentry-Daten und -Aktionen über das standardisierte Model Context Protocol. Host-Anwendungen, wie Claude Desktop oder IDEs, können programmgesteuert mit Sentry über MCP-konforme Tools und Endpunkte interagieren. Es unterstützt sowohl Remote- als auch lokale (stdio) Transporte. Damit ist es flexibel für Cloud- und selbstgehostete Sentry-Installationen.

So konfigurieren Sie

1. Produktion:
   Greifen Sie einfach auf den bereitgestellten Dienst unter https://mcp.sentry.dev zu.

2. Selbstgehostetes Sentry (Stdio-Transport):

   • Erstellen Sie ein Sentry-Benutzerauthentifizierungstoken mit den entsprechenden Berechtigungen:

     org:read
     project:read
     project:write
     team:read
     team:write
     event:write
     

   • Starten Sie den MCP-Server:

     npx @sentry/mcp-server@latest --access-token=sentry-user-token --host=sentry.example.com
     

   • Alternativ können Sie mit Umgebungsvariablen konfigurieren:

     SENTRY_ACCESS_TOKEN=
     SENTRY_HOST=
     

3. Lokale Entwicklung:

   • Erstellen Sie eine OAuth-App in Sentry mit http://localhost:5173 als Homepage-URL und Weiterleitungs-URI.
   • Fügen Sie Ihre Anmeldedaten zu .dev.vars in packages/mcp-cloudflare/ hinzu:

     SENTRY_CLIENT_ID=your_client_id
     SENTRY_CLIENT_SECRET=your_client_secret
     COOKIE_SECRET=my-super-secret-cookie
     

   • Führen Sie den Server lokal aus:

     pnpm dev
     

So verwenden Sie es

1. Besuchen Sie https://mcp.sentry.dev für den gehosteten Server oder führen Sie Ihre lokale/stdio Instanz wie oben beschrieben aus.
2. Verwenden Sie den MCP Inspector:
   • Geben Sie Ihre Server-URL ein (z. B. http://localhost:5173) und verbinden Sie sich.
   • Authentifizieren Sie sich, wenn Sie dazu aufgefordert werden (OAuth oder Zugriffstoken).
   • Entdecken Sie verfügbare Tools über die Funktion „Tools auflisten“.
   • Rufen Sie gewünschte Tool-Endpunkte direkt vom Inspector oder über einen LLM-fähigen Client auf.
3. Für selbstgehostetes Sentry führen Sie es mit den entsprechenden Tokens aus und verbinden Sie im „stdio“-Modus.
4. Führen Sie Tests mit pnpm test und LLM-gestützte Auswertungen mit pnpm eval (nachdem Sie OPENAI_API_KEY festgelegt haben) aus.

Hauptmerkmale

• Integration mit Sentry über ein MCP-konformes Protokoll, das LLM/Agent-Zugriff auf Fehlerdaten und Operationen ermöglicht
• Unterstützt sowohl remote HTTP(S) als auch lokale stdio-Transporte für Flexibilität bei verschiedenen Bereitstellungstypen
• OAuth- und tokenbasierte Authentifizierung für sicheren Zugriff auf Sentry-Ressourcen
• Vorgefertigte Sammlung von entdeckbaren, ausführbaren Tools (Aktionen/Endpunkte) für Automatisierung und Datenabruf
• Erweiterbar und offen für lokale Entwicklung und Beiträge
• Beinhaltet ein integriertes Inspector-Tool zur interaktiven Erkundung und zum Testen

Anwendungsfälle

• Erlaubt LLM-basierte Agenten oder Co-Piloten, Sentry-Vorfälle in IDEs oder einheitlichen Desktop-Umgebungen zu überwachen, abzurufen oder zu priorisieren
• Automatisiert routinemäßige Sentry-Aktionen wie Problemazuweisungen, Statusänderungen oder Benachrichtigungen, ausgelöst durch KI-Workflows
• Integriert Sentry-Sichtbarkeitsdaten in benutzerdefinierte Dashboards oder Reporting-Tools, die von Sprachmodellen betrieben werden
• Ermöglicht eine Zero-Touch-Administration oder Priorisierung von Sentry über eine sichere, standardisierte API ohne manuelles Skripting

Häufig gestellte Fragen

Q1: Kann ich Sentry MCP mit selbstgehosteten Sentry-Instanzen verwenden?
Ja, Sentry MCP unterstützt selbstgehostete Instanzen im stdio-Transportmodus. Sie müssen ein Benutzerauthentifizierungstoken mit den erforderlichen Berechtigungen bereitstellen und den Host entsprechend konfigurieren.

Q2: Muss ich eine OAuth-Anwendung erstellen, um Sentry MCP lokal zu testen?
Für lokale Entwicklung und Tests müssen Sie eine OAuth-App in Ihrem Sentry-Konto registrieren und deren Anmeldedaten in den Konfigurationsdateien des Projekts bereitstellen.

Q3: Können LLMs meine Sentry-Daten über MCP-Tools ändern?
Ja, über MCP zugängliche Tools können sowohl Daten in Sentry lesen als auch ändern, je nach Tool und den Berechtigungen Ihres Tokens. Stellen Sie immer sicher, dass die bereitgestellten Tokens nur die erforderlichen Berechtigungen haben.

Q4: Wie kann ich meine MCP-Server-Integrationen testen?
Verwenden Sie das integrierte Inspector-Tool, indem Sie sich mit Ihrer MCP-Server-URL verbinden. So können Sie sich authentifizieren, Tools entdecken und interaktiv aufrufen, um eine einfache Überprüfung vorzunehmen.

Q5: Welche Authentifizierungsmethoden werden unterstützt?
Sentry MCP unterstützt sowohl OAuth (für den Remote-Server) als auch Token-basierte (für lokal/stdio) Authentifizierungsflüsse.