Sentry MCP

Sentry-MCP

Dies ist ein Prototyp eines Remote-MCP-Servers, der als Middleware für den Upstream-Sentry-API-Anbieter fungiert.

Es basiert auf Cloudflares Arbeit an Remote-MCPs .

Erste Schritte

Alles, was Sie wissen müssen, finden Sie, indem Sie den bereitgestellten Dienst in der Produktion besuchen:

https://mcp.sentry.dev

Wenn Sie einen Beitrag leisten, erfahren möchten, wie es funktioniert, oder dies für selbst gehostetes Sentry ausführen möchten, fahren Sie unten fort.

Stdio vs. Remote

Obwohl dieses Repository hauptsächlich als MCP-Dienst fungiert, unterstützen wir auch einen stdio . Dies ist noch in Arbeit, stellt aber die einfachste Möglichkeit dar, MCP an eine selbstgehostete Sentry-Installation anzupassen.

Um den stdoio Transport zu nutzen, müssen Sie in Sentry einen Personal API Token (PAT) mit den erforderlichen Bereichen erstellen. Zum Zeitpunkt des Schreibens lautet dieser:

Starten Sie den Transport:

Hinweis: Sie können auch Umgebungsvariablen verwenden:

MCP-Inspektor

MCP enthält einen Inspector , um den Dienst einfach zu testen:

Geben Sie die MCP-Server-URL ( http://localhost:5173 ) ein und klicken Sie auf „Verbinden“. Dadurch wird der Authentifizierungsablauf ausgelöst.

Hinweis: Wenn beim Zugriff auf den Inspector unter 127.0.0.1 Probleme mit Ihrem OAuth-Flow auftreten, versuchen Sie es stattdessen mit der Verwendung localhost , indem Sie http://localhost:6274 aufrufen.

Lokale Entwicklung

Wenn Sie Ihren MCP-Server iterieren und testen möchten, können Sie dies in der lokalen Entwicklung tun. Dazu müssen Sie eine weitere OAuth-App in Sentry erstellen (Einstellungen => API => Anwendungen ):

• Geben Sie für die Homepage-URL http://localhost:8788
• Geben Sie für die autorisierten Umleitungs-URIs http://localhost:8788/callback
• Notieren Sie Ihre Client-ID und generieren Sie ein Client-Geheimnis.
• Erstellen Sie eine .dev.vars Datei in Ihrem Projektstamm mit:

Verifizieren

Führen Sie den Server lokal aus, um ihn unter http://localhost:8788 verfügbar zu machen

Um den lokalen Server zu testen, geben Sie http://localhost:8788/sse in den Inspector ein und klicken Sie auf „Verbinden“. Sobald Sie den Anweisungen folgen, können Sie die Tools auflisten.

Tests

Es sind zwei Test-Suiten enthalten: grundlegende Unit-Tests und einige Auswertungen.

Unit-Tests können mit folgenden Methoden ausgeführt werden:

Für die Evaluierungen ist eine .env Datei mit einigen Konfigurationseinstellungen erforderlich:

Sobald dies erledigt ist, können Sie sie mit folgendem Befehl ausführen:

Hinweise

Verwenden von Claude und anderen MCP-Clients

Wenn Sie Claude verwenden, um eine Verbindung zu Ihrem Remote-MCP-Server herzustellen, werden möglicherweise Fehlermeldungen angezeigt. Dies liegt daran, dass Claude Desktop Remote-MCP-Server noch nicht unterstützt und daher manchmal Verwirrung entsteht. Um zu überprüfen, ob der MCP-Server verbunden ist, bewegen Sie den Mauszeiger über das 🔨-Symbol in der unteren rechten Ecke von Claudes Benutzeroberfläche. Ihre Tools sollten dort verfügbar sein.

Verwenden von Cursor und anderen MCP-Clients

Um Cursor mit Ihrem MCP-Server zu verbinden, wählen Sie Type : „Befehl“ und kombinieren Sie im Feld Command die Felder „Befehl“ und „Argumente“ zu einem (z. B. npx mcp-remote@latest https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).

Beachten Sie, dass Cursor zwar HTTP+SSE-Server unterstützt, jedoch keine Authentifizierung. Sie müssen daher weiterhin mcp-remote verwenden (und einen STDIO-Server verwenden, keinen HTTP-Server).

Sie können Ihren MCP-Server mit anderen MCP-Clients wie Windsurf verbinden, indem Sie die Konfigurationsdatei des Clients öffnen, dasselbe JSON hinzufügen, das für das Claude-Setup verwendet wurde, und den MCP-Client neu starten.