Sentry MCP : analyser et corriger vos erreurs de production avec l’IA

Un lundi matin, une alerte Sentry tombe : une exception se déclenche sur la page de paiement. Le réflexe habituel, c’est d’ouvrir le tableau de bord, lire la stack trace, retrouver le fichier concerné, puis revenir dans l’éditeur. Avec le serveur Sentry MCP, votre assistant IA fait ce va-et-vient à votre place : il lit l’erreur, regarde le contexte, ouvre le bon fichier dans votre projet et vous propose une correction.

Sentry publie et maintient ce serveur officiel. Voyons comment l’installer, comment l’utiliser au quotidien et quelles précautions prendre.

Sentry MCP en bref

Point cléDétail
ÉditeurSentry (officiel, open source)
URL distantehttps://mcp.sentry.dev/mcp
AuthentificationOAuth (connexion à votre compte Sentry)
Version localenpx @sentry/mcp-server@latest
PrixGratuit, compte Sentry requis
Idéal pourTriage d’incidents, débogage, suivi des performances

📇 Retrouvez la fiche Sentry MCP dans notre annuaire des serveurs MCP : commande d’installation, liens officiels et catégorie.

Que permet le serveur Sentry MCP ?

Le serveur donne à l’assistant un accès en langage naturel à vos données Sentry. Il peut notamment :

  • lister vos organisations, équipes et projets ;
  • rechercher des issues et des événements (« les erreurs les plus fréquentes cette semaine ») ;
  • récupérer le détail d’une issue : stack trace, tags, navigateur, release concernée ;
  • lancer une analyse de cause racine avec Seer, l’agent IA de Sentry, si la fonctionnalité est activée sur votre organisation ;
  • créer un projet ou récupérer une DSN, et mettre à jour le statut d’une issue.

L’intérêt, c’est la combinaison : dans Claude Code ou Cursor, l’agent a à la fois l’erreur (via Sentry) et le code source (dans votre dépôt). Il peut donc relier les deux sans que vous ayez à copier-coller quoi que ce soit.

Installer Sentry MCP

Avec Claude Code

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Lancez ensuite Claude Code, tapez /mcp et suivez la connexion OAuth dans votre navigateur. Pour limiter l’accès à une seule organisation ou un seul projet, ajoutez-les à l’URL : https://mcp.sentry.dev/mcp/mon-organisation/mon-projet.

Avec Cursor

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

Dans VS Code, passez par la palette de commandes : « MCP: Add Server », choisissez HTTP et collez l’URL.

En local ou avec Sentry auto-hébergé

Si vous utilisez une instance Sentry auto-hébergée, lancez le serveur en local avec un jeton d’authentification utilisateur :

npx @sentry/mcp-server@latest --access-token=VOTRE_TOKEN --host=sentry.mon-entreprise.fr

Le jeton doit disposer au minimum des permissions org:read, project:read, project:write, team:read, team:write et event:write. Notez que les outils de recherche en langage naturel ont besoin d’un fournisseur de LLM configuré (OpenAI, Anthropic, Azure OpenAI ou OpenRouter) via la variable EMBEDDED_AGENT_PROVIDER ; les autres outils fonctionnent sans.

Premiers pas : des prompts pour déboguer

  • « Quelles sont les 5 erreurs non résolues les plus fréquentes du projet front depuis 24 heures ? »
  • « Analyse l’issue PROJ-1234, trouve le fichier concerné dans ce dépôt et propose un correctif. »
  • « Est-ce que la dernière release a introduit de nouvelles erreurs ? Compare avec la précédente. »
  • « Lance une analyse Seer sur cette issue et résume-moi la cause probable. »
  • « Crée un nouveau projet Sentry pour mon API Node.js et donne-moi la DSN à mettre dans mon fichier .env. »

Cas d’usage concrets

Le triage du matin. Une question suffit pour obtenir la liste des erreurs nouvelles ou en hausse, classées par impact. Vous décidez ensuite lesquelles traiter.

Du ticket au correctif. L’agent lit la stack trace, ouvre les fichiers concernés, comprend le contexte (utilisateur, navigateur, données) et vous propose une modification. Vous gardez la main sur la validation.

Le suivi après déploiement. Juste après une mise en production, demandez à l’assistant de surveiller les nouvelles erreurs liées à la release. Vous repérez une régression avant vos utilisateurs.

L’intégration d’un nouveau projet. Créer le projet, récupérer la DSN et configurer le SDK peut se faire dans la même conversation.

Bonnes pratiques pour utiliser Sentry MCP

1. Limitez la portée dès l’installation

Si vous travaillez sur un seul produit, ajoutez l’organisation et le projet dans l’URL. L’assistant voit moins de données inutiles, répond plus vite et ne risque pas de mélanger deux projets.

2. Préférez la version distante avec OAuth

La connexion OAuth évite de manipuler des jetons à la main et suit automatiquement les mises à jour du serveur. Gardez la version locale pour les instances auto-hébergées.

3. Si vous utilisez un jeton, donnez-lui le minimum

Créez un jeton dédié à l’usage MCP, avec uniquement les permissions nécessaires, et stockez-le dans une variable d’environnement. Ne le versionnez jamais dans votre dépôt.

4. Gardez la validation humaine pour les actions d’écriture

Résoudre, ignorer ou assigner une issue modifie l’état partagé avec votre équipe. Laissez l’approbation manuelle activée pour ces outils, et relisez toujours les correctifs proposés avant de les pousser.

5. Donnez un identifiant plutôt qu’une description vague

« L’erreur sur le panier » peut correspondre à dix issues. Collez l’identifiant (PROJ-1234) ou l’URL de l’issue : l’agent va droit au but.

6. Faites attention aux données personnelles

Les événements Sentry peuvent contenir des e-mails, adresses IP ou contenus saisis par les utilisateurs. Configurez le nettoyage des données sensibles côté Sentry, et gardez à l’esprit que ces informations seront transmises au modèle d’IA.

7. Méfiez-vous des injections de prompt

Un message d’erreur peut contenir du texte saisi par un utilisateur. Un attaquant pourrait y glisser des instructions. Ne laissez pas l’agent exécuter automatiquement des commandes ou pousser du code sur la seule base du contenu d’une issue.

Problèmes fréquents et solutions

La connexion OAuth échoue. Vérifiez que vous êtes connecté au bon compte Sentry dans votre navigateur, puis relancez l’authentification depuis /mcp dans Claude Code.

Les outils de recherche sont absents en local. Ils nécessitent un fournisseur de LLM configuré via EMBEDDED_AGENT_PROVIDER et la clé API correspondante.

L’assistant ne trouve pas mon projet. Si l’URL est restreinte à une organisation ou un projet, vérifiez les slugs exacts dans les paramètres Sentry.

Questions fréquentes

Le serveur Sentry MCP est-il payant ?

Non, le serveur est gratuit et open source. Il faut simplement un compte Sentry, et les fonctionnalités accessibles dépendent de votre offre (Seer, par exemple).

Fonctionne-t-il avec Sentry auto-hébergé ?

Oui, en lançant le serveur en local avec l’option --host et un jeton d’authentification utilisateur.

L’IA peut-elle corriger le bug toute seule ?

Elle peut proposer un correctif très pertinent, surtout dans un agent comme Claude Code qui a accès au code. La validation et les tests restent de votre responsabilité.

Quelle différence avec Seer ?

Seer est l’agent d’analyse intégré à Sentry. Le serveur MCP permet à votre assistant de l’utiliser, mais aussi de consulter toutes vos données Sentry et de les croiser avec votre code local.

En résumé

Le serveur Sentry MCP supprime les allers-retours entre le tableau de bord et l’éditeur. Votre assistant lit l’erreur, comprend le contexte et propose une correction dans votre code. Limitez sa portée, gardez la main sur les actions d’écriture et surveillez les données personnelles : vous aurez un vrai copilote de débogage.

À lire aussi