Sentry MCP — Cas d'usage, Installer & Démo en direct

Name: Sentry MCP MCP Server
Author: getsentry

Pourquoi l'utiliser

Fonctionnalités clés

Recherche d'issues avec la syntaxe de requête Sentry
Récupération du payload d'événement complet : stack trace, breadcrumbs, requête, tags
Santé des releases : détection de régressions, adoption, taux sans crash
Traces de performance avec décomposition des spans
Métadonnées de projet + d'équipe pour les requêtes inter-projets

Démo en direct

Aperçu en pratique

sentry-mcp-getsentry.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Sentry MCP

Déboguer une erreur de production de bout en bout sans quitter Claude

👤 Développeurs traitant des alertes d'astreinte ⏱ ~20 min intermediate

Quand l'utiliser : Une alerte Sentry se déclenche ; vous avez besoin de la cause racine maintenant.

Prérequis

Token d'authentification Sentry — Paramètres utilisateur → Auth Tokens → créer avec 'project:read', 'event:read', 'org:read'
Token dans l'environnement — Définir SENTRY_AUTH_TOKEN et SENTRY_HOST (sentry.io ou auto-hébergé)

Déroulement

Trouver l'issue

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

→ ID de l'issue + nombre + première/dernière occurrence
Récupérer le contexte complet

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

→ Payload complet de l'événement avec frames + historique des actions utilisateur
Corréler avec le déploiement

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

→ Tag de release + liste de commits
Proposer un correctif

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

→ Fichier + ligne spécifiques référencés ; patch concret

Résultat : De l'alerte au correctif candidat en quelques minutes, avec toute la chaîne de preuves.

Pièges

Source maps absentes — frames de pile inexploitables — Vérifier l'upload des source maps dans vos releases Sentry ; sans elles, les frames minifiées ne donnent rien à Claude

Combiner avec : github

Vérification pré-déploiement avant de promouvoir une release

👤 Ingénieurs release, responsables de déploiement ⏱ ~15 min intermediate

Quand l'utiliser : Sur le point de promouvoir une release canary à 100%.

Déroulement

Comparer la santé des releases

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

→ Taux sans crash par release, adoption, nombre de régressions
Vérifier les nouvelles erreurs

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

→ Liste des nouvelles issues avec nombre d'occurrences
Recommander

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

→ Recommandation claire avec seuils explicités

Résultat : Décision promotion/blocage basée sur les données, pas sur l'instinct.

Pièges

Adoption trop faible pour être statistiquement significative — Claude devrait signaler les fenêtres à faible adoption comme non concluantes — pas prétendre savoir

Investiguer une régression de performance via les traces de transaction

👤 Ingénieurs backend qui traquent la latence ⏱ ~25 min advanced

Quand l'utiliser : La latence p95 sur /checkout a augmenté après le dernier déploiement.

Déroulement

Récupérer une trace récente lente

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

→ Trace avec décomposition des spans
Trouver le nouveau span

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

→ Diff : nouvelle requête BD 'SELECT cart_items', moyenne 1,4s
Relier au code

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

→ Commit + proposition de correctif concret

Résultat : Cause racine d'une régression de performance, avec proposition de correctif au niveau du code.

Pièges

Taux d'échantillonnage de traces trop faible — aucune trace lente capturée — Augmenter temporairement le taux d'échantillonnage, ou demander à Claude d'utiliser les endpoints statistiques à la place

Combiner avec : github

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

sentry-mcp-getsentry + github

Depuis une frame de pile Sentry directement vers un brouillon de PR

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

sentry-mcp-getsentry + linear

Créer automatiquement des tickets engineering depuis les régressions

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

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search_issues	project, query, statsPeriod?	Filtrer les issues par requête Sentry	1 appel API Sentry
get_issue	issue_id	Vue d'ensemble d'une issue	1 appel API
get_event	event_id ou 'latest'	Récupérer une occurrence spécifique avec contexte complet	1 appel API
list_releases	project, version?	Comparaison inter-releases	1 appel API
get_trace	trace_id	Investigation de performance	1 appel API

Coût et limites

Coût d'exécution

Quota d'API: Limites de taux standard de l'API Sentry — les rafales peuvent déclencher des 429
Tokens par appel: Le payload d'événement peut représenter 5–20k tokens — récupérer de manière sélective
Monétaire: Gratuit pour le plan développeur Sentry ; plans payants avec limites de taux plus élevées
Astuce: Utiliser search_issues pour réduire d'abord la sélection ; appeler get_event uniquement sur les candidats — pas sur des listes entières

Sécurité

Permissions, secrets, portée

Portées minimales : project:read event:read org:read

Stockage des identifiants : Variable d'env SENTRY_AUTH_TOKEN (utiliser un token à portée limitée, lié au projet)

Sortie de données : Tous les appels vers votre host Sentry (sentry.io ou auto-hébergé)

Ne jamais accorder : project:write ou org:write à un agent piloté par chat

Les données d'événement peuvent contenir des PII (corps de requête, IDs utilisateur) — appliquer les règles de nettoyage de données Sentry en amont

Dépannage

Erreurs courantes et correctifs

401 Unauthorized

Token expiré ou portée incorrecte — regénérer avec les portées de lecture listées

Vérifier : curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

La stack trace n'affiche que des frames minifiées

Vérifier l'upload des source maps dans votre pipeline de release ; sans elles, Claude ne peut pas raisonner sur les frames

Vérifier : UI Sentry → Release → Artifacts

404 sur une issue connue

L'issue est dans un projet non couvert par le token — re-cibler le token vers ce projet

Sentry auto-hébergé — connexion refusée

Définir SENTRY_HOST explicitement avec l'URL de votre instance et le protocole

Vérifier : curl $SENTRY_HOST/api/0/

Alternatives

Sentry MCP vs autres

Alternative	Quand l'utiliser	Compromis
Datadog MCP	Votre équipe utilise Datadog APM/suivi d'erreurs	Couverture différente ; APM d'abord, moins centré sur les issues
Honeycomb MCP	Vous êtes une équipe observabilité-first utilisant des événements plutôt que des stack traces	Pas de regroupement d'issues natif ; centré sur les traces

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills