MCP

D’abord connecter le Sentry MCP distant, puis interroger les événements de débogage

Convient au débogage humain-dans-la-boucle dans Cursor ou Claude Code. Préférez le service hébergé plutôt que de lancer stdio d’emblée. search_events et search_issues exigent aussi un fournisseur LLM configuré ; sans lui ces deux-là sont indisponibles, les autres outils fonctionnent encore.

Official source · sentry-mcp

Install

"url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }

Pour qui

Si vous avez besoin de Sentry à côté du code et acceptez human-in-the-loop plutôt que d’automatiser toutes les fonctions Sentry, ce service correspond. Officiellement, il vise surtout les agents de codage human-in-the-loop ; le choix d’outils penche vers le flux développeur et le débogage, pas un Sentry MCP généraliste toutes fonctions. Il sert de couche intermédiaire sur l’API Sentry amont et est nommé comme optimisé pour Cursor, Claude Code et des outils de développement similaires.

Il ne convient pas à qui veut couvrir toutes les fonctions Sentry, ni à qui n’a pas encore de jeton d’accès Sentry mais veut d’abord lancer stdio. L’extrait actuel ne nomme clairement que des outils de recherche IA tels que search_events et search_issues ; d’autres outils existent, mais leurs noms ne sont pas écrits dans cet extrait. N’inventez pas les noms manquants.

Les requêtes en lecture seule passent encore par l’API Sentry ; ne les traitez pas comme une absence de réseau ou de frontière de confidentialité.

Premier essai en 3 minutes

Préparez d’abord votre propre jeton d’accès Sentry. Le chemin principal recommandé officiellement est le service hébergé de production, pas d’installer stdio à côté :

L’entrée des notes de production est https://mcp.sentry.dev/ . La configuration client distante de l’extrait est :

"url": "https://mcp.sentry.dev/mcp ",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }

Le schéma d’authentification est Sentry-Bearer ; ne le changez pas en Bearer ordinaire. Placez ce bloc dans un client MCP qui prend en charge une URL distante, remplacez le jeton par votre valeur, et n’utilisez aucune chaîne d’espace réservé d’exemple. L’extrait ne fige pas de nom de fichier client.

Une fois connecté, posez d’abord une question de débogage que vous avez déjà dans Sentry. Si vous n’avez pas encore configuré de fournisseur LLM (l’extrait liste OpenAI, Azure OpenAI, Anthropic, OpenRouter), n’appelez pas search_events ou search_issues : sans fournisseur ces deux-là sont indisponibles, les autres outils fonctionnent encore. Le premier essai doit privilégier un outil non recherche encore disponible pour un regard en lecture seule ; les noms concrets ne sont pas dans l’extrait, donc on ne peut confirmer que « les outils autres que la recherche IA ».

Le signal de succès est que l’adresse distante https://mcp.sentry.dev/mcp peut dialoguer et renvoyer des informations de débogage côté Sentry, et non un 401, ni Authorization écrit comme Bearer.

Cas d’usage

Cas 1 : faire une requête de débogage dans un assistant de code. L’extrait indique que ce service distant vise le flux développeur et le débogage, et sert de couche intermédiaire de l’API Sentry. Connectez d’abord l’URL hébergée, puis posez une question de débogage déjà existante. On peut confirmer ce chemin de couche intermédiaire ; les noms d’outils non recherche et les champs de retour n’apparaissent pas dans l’extrait actuel.

Cas 2 : chercher des événements ou issues en langage naturel. L’extrait indique que les outils de recherche IA tels que search_events et search_issues ont besoin d’un fournisseur LLM pour traduire le langage naturel en syntaxe de requête Sentry. Confirmez que le fournisseur est configuré avant d’agir. Sans lui ces outils sont indisponibles ; ne traitez pas cet échec comme une panne du service entier. Les commandes d’installation et variables de clés des fournisseurs ne sont pas dans l’extrait ; ne les inventez pas.

Ces deux cas correspondent à « outils de débogage ordinaires » et « recherche IA ». N’empruntez pas de force la seconde voie si le fournisseur n’est pas configuré.

Limites d’usage

Le chemin principal est le service hébergé https://mcp.sentry.dev/ et l’adresse MCP distante https://mcp.sentry.dev/mcp . L’extrait donne aussi la commande stdio npx @sentry/mcp-server@latest, et passe avec --access-token un User Auth Token que vous avez créé vous-même dans Sentry ; ne remplissez aucun espace réservé d’exemple. Les portées nécessaires à stdio incluent org:read, project:read, project:write, team:read, team:write, event:write. N’empruntez pas ce chemin la première fois, et surtout ne commencez pas par des portées write pour écrire.

Le dépôt officiel est https://github.com/getsentry/sentry-mcp . Ce n’est pas un encapsuleur API Sentry toutes fonctions. N’inventez pas les noms d’outils, le comportement de rafraîchissement OAuth et les étapes de révocation absents.