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

Pourquoi l'utiliser

Fonctionnalités clés

Officiel — publié par Sentry, suit leur modèle d'authentification
Filtrez les issues par release, environnement, impact utilisateur, ancienneté
Stacktrace complète + breadcrumbs pour n'importe quel événement
Lecture seule par défaut — ne résoudra pas accidentellement les issues

Démo en direct

Aperçu en pratique

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

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

~/.continue/config.json

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

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

claude mcp add sentry -- 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

Triez un incident de production frais en 5 minutes

👤 Ingénieurs d'astreinte ⏱ ~5 min intermediate

Quand l'utiliser : PagerDuty vient de vous réveiller. Sentry dit que les erreurs augmentent. Vous devez savoir quoi, pourquoi, et s'il faut revenir en arrière — rapidement.

Prérequis

Slug org Sentry + slug projet — Regardez n'importe quelle URL Sentry : sentry.io/organizations/<ORG>/issues/?project=<ID>
Token d'authentification utilisateur Sentry avec event:read et project:read — sentry.io/settings/account/api/auth-tokens/

Déroulement

Trouvez le problème NOUVEAU le plus important de la dernière heure

Quel est le problème nouveau le plus important de notre projet web-prod de la dernière heure, classé par nombre d'événements ?✓ Copié

→ Un seul issue avec titre, nombre d'événements, utilisateurs affectés, timestamp d'apparition
Récupérez l'événement le plus récent avec stacktrace complète + breadcrumbs

Obtenez l'événement le plus récent pour ce problème. Montrez-moi la stacktrace, la release, et les 5 derniers breadcrumbs avant le crash.✓ Copié

→ File:line de la fonction qui lance l'exception + séquence des actions utilisateur avant l'erreur
Identifiez la release qui a introduit le problème

Ce problème a-t-il été vu pour la première fois dans la même release qu'il est apparu, ou a-t-il été reporté ? Comparez le tag de release.✓ Copié

→ Oui/non avec confiance — oriente la décision de revert

Résultat : Un résumé d'incident en 3 lignes que vous pouvez coller dans Slack : qu'est-ce qui est cassé, qui est affecté, quelle release l'a causé, action recommandée.

Pièges

Si vos tags de release ne sont pas configurés, vous ne pouvez pas savoir quel déploiement a introduit le bug — Configurez sentry-cli releases dans votre CI avant de vous fier à cela — sans cela, vous devinez
La stacktrace est en JS minifié et illisible — Vérifiez que les sourcemaps sont téléchargées — sentry-cli sourcemaps upload devrait être dans votre pipeline de construction

Combiner avec : github · linear

Référence croisée des erreurs Sentry avec les commits GitHub qui les ont causées

👤 Ingénieurs seniors corrigeant les problèmes récurrents ⏱ ~30 min advanced

Quand l'utiliser : Une erreur continue de revenir après chaque release. Vous suspectez un chemin de code spécifique mais voulez confirmer.

Prérequis

Sentry MCP et GitHub MCP tous deux installés — Voir le guide GitHub pour la configuration
Releases étiquetées avec le SHA git dans Sentry — Utilisez sentry-cli releases new $SHA dans CI

Déroulement

Listez l'historique du problème à travers les releases

Pour le problème Sentry WEB-3a91, listez chaque release où il est apparu et le nombre d'événements par release.✓ Copié

→ Tableau montrant le problème augmentant après des déploiements spécifiques
Pour chaque augmentation, récupérez le diff

Pour les 3 releases avec le plus haut nombre d'événements, utilisez le MCP GitHub pour obtenir le diff de commit. Quels fichiers chaque release a-t-elle modifiés ?✓ Copié

→ Fichiers communs à travers les augmentations — la preuve irréfutable
Formez une hypothèse de cause racine

En fonction de ces diffs, quelle est la cause racine la plus probable ? Soyez précis — pointez la/les ligne(s).✓ Copié

→ Théorie au niveau des lignes que vous pouvez valider en vérifiant le code

Résultat : Une hypothèse spécifique au niveau du code avec des preuves des événements de Sentry et des diffs de GitHub.

Pièges

Plusieurs commits dans une release — difficile d'isoler lequel est responsable — Utilisez le style git bisect : déployez une build avec seulement la moitié des commits et vérifiez si le taux d'erreur diminue

Combiner avec : github

Générez un rapport de qualité d'ingénierie hebdomadaire à partir des données Sentry

👤 Responsables d'ingénierie ⏱ ~20 min intermediate

Quand l'utiliser : Vendredi après-midi, avant la planification de la semaine prochaine. Vous voulez savoir si la qualité est en hausse ou en baisse.

Prérequis

Accès en lecture à tous vos projets dans Sentry — Token limité à org:read + project:read + event:read

Déroulement

Récupérez les nombre d'erreurs et les sessions sans crash pour la semaine

Pour notre organisation, donnez-moi le pourcentage de sessions sans crash par projet pour cette semaine par rapport à la semaine dernière. Signalez tout projet où il a diminué.✓ Copié

→ Comparaison par projet avec deltas
Identifiez les principaux contributeurs au volume d'erreurs

Quels 5 problèmes sont responsables de la plupart des événements cette semaine, sur tous les projets ?✓ Copié

→ Liste concrète des problèmes avec nombre d'événements et liens
Suggérez un focus pour la semaine prochaine

En fonction de ces données, qu'est-ce que l'équipe devrait prioriser à corriger la semaine prochaine ? Considérez à la fois le volume et l'impact utilisateur.✓ Copié

→ 3 recommandations priorisées avec justification

Résultat : Un rapport d'une page que vous pouvez partager dans votre revue d'ingénierie hebdomadaire avec des priorités concrètes.

Pièges

Les métriques de volume sont dominées par un problème bruyant, masquant tout le reste — Filtrez ce problème et réclassez — parfois le plus bruyant n'est pas le plus important

Combiner avec : linear · notion

Quantifiez l'impact utilisateur d'un bug connu avant de décider de le corriger

👤 Responsables de produit, tech leads triant le backlog de bugs ⏱ ~15 min beginner

Quand l'utiliser : Il y a un bug connu et l'équipe débat de la priorité. Vous avez besoin de données, pas d'opinions.

Déroulement

Récupérez les statistiques d'impact utilisateur du problème

Pour le problème Sentry WEB-3a91, combien d'utilisateurs uniques l'ont touché au cours des 30 derniers jours, et quel pourcentage des utilisateurs actifs totaux est-ce ?✓ Copié

→ Nombre absolu + pourcentage
Segmentez les utilisateurs affectés

Parmi les utilisateurs affectés, quelle est la distribution par navigateur, SE et niveau de compte (payant vs gratuit) ?✓ Copié

→ Ventilation qui révèle si c'est un problème de cas limite ou de flux principal
Comparez avec d'autres problèmes ouverts

Classez nos 10 bugs ouverts les plus importants par utilisateurs affectés ce mois-ci. Où celui-ci se situe-t-il ?✓ Copié

→ Contexte pour la priorisation

Résultat : Une recommandation de priorité basée sur les données : corriger maintenant, corriger ce sprint, ou reporter.

Combinaisons

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

sentry + github

Sentry → identifiez la mauvaise release → GitHub → trouvez le commit qui l'a introduite → rédigez une PR de revert

Le problème WEB-3a91 a augmenté après la release [email protected]. Trouvez les commits dans cette release sur GitHub, identifiez le coupable le plus probable, et rédigez une PR de revert.✓ Copié

sentry + linear

Créez automatiquement des issues Linear à partir des nouvelles issues Sentry dépassant un seuil d'événements

Trouvez tous les nouveaux problèmes Sentry des dernières 24h avec >100 événements. Pour chacun, créez un ticket de bug Linear assigné à l'ingénieur d'astreinte.✓ Copié

sentry + notion

Rapport de qualité d'ingénierie hebdomadaire posté sur Notion

Récupérez les statistiques Sentry de cette semaine et créez une page Notion dans la base de données Engineering / Weekly Reports.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_issues	organization, project, query?, sort?, limit?	Recherchez le flux d'issues par statut/release/environnement/ancienneté	1 appel API
get_issue	issue_id	Obtenez les métadonnées complètes pour un issue spécifique incluant la plage de release	1 appel API
get_event	issue_id, event_id?	Récupérez la stacktrace réelle et les breadcrumbs pour débogage	1 appel API
list_releases	organization, project	Consultez la chronologie de déploiement et quelle release a introduit quoi	1 appel API
list_projects	organization	Découvrez quels projets existent dans votre organisation	1 appel API

Coût et limites

Coût d'exécution

Quota d'API: Sentry : 40 req/sec par token (très généreux). Pas de limite quotidienne sur l'API elle-même.
Tokens par appel: 200–1000 tokens par réponse d'issue/événement ; les grandes stacktraces peuvent atteindre 5k
Monétaire: Niveau gratuit : 5k erreurs/mois. Les plans payants facturent en fonction du volume d'événements, pas de l'utilisation de l'API.
Astuce: L'API est gratuite ; ce pour quoi vous payez réellement est l'ingestion d'événements. Utilisez les règles d'échantillonnage dans Sentry lui-même pour maintenir les coûts d'ingestion prévisibles.

Sécurité

Permissions, secrets, portée

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

Stockage des identifiants : Token d'authentification utilisateur Sentry dans la variable d'environnement SENTRY_AUTH_TOKEN

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

Ne jamais accorder : org:write project:admin member:write

Dépannage

Erreurs courantes et correctifs

401 Token invalide

Le token a expiré ou n'a pas les portées demandées. Recréez-le à sentry.io/settings/account/api/auth-tokens/

Vérifier : curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" https://sentry.io/api/0/organizations/

404 Projet non trouvé

Le slug du projet est sensible à la casse et doit correspondre exactement à l'URL. Vérifiez sentry.io/settings/projects/

Stacktrace vide

Sourcemaps non téléchargées. Exécutez sentry-cli sourcemaps upload dans votre pipeline de construction.

Alternatives

Sentry vs autres

Alternative	Quand l'utiliser	Compromis
Datadog APM MCP	Vous êtes déjà sur Datadog et voulez un APM + erreurs unifié	Plus cher, moins axé spécifiquement sur les erreurs
Rollbar / Bugsnag MCP	Vous les payez déjà	Écosystème MCP construit par la communauté plus petit

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills