Sentry MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Primeira parte — publicado pelo Sentry, segue seu modelo de auth
Filtre issues por release, ambiente, impacto do usuário, idade
Stacktrace completo + breadcrumbs para qualquer evento
Somente leitura por padrão — não vai resolver issues acidentalmente

Demo ao vivo

Como fica na prática

sentry.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Sentry

Trie um incidente de produção fresco em 5 minutos

👤 Engenheiros de plantão ⏱ ~5 min intermediate

Quando usar: PagerDuty acabou de acordá-lo. Sentry diz que erros estão aumentando. Você precisa saber o quê, por que e se deve reverter — rápido.

Pré-requisitos

Slug da org Sentry + slug do projeto — Olhe qualquer URL do Sentry: sentry.io/organizations/<ORG>/issues/?project=<ID>
Token de auth do usuário Sentry com event:read e project:read — sentry.io/settings/account/api/auth-tokens/

Fluxo

Encontre o problema NEW superior na última hora

Qual é o problema novo superior em nosso projeto web-prod na última hora, classificado por contagem de eventos?✓ Copiado

→ Um único problema com título, contagem de eventos, usuários afetados, timestamp do primeiro avistamento
Puxe o evento mais recente com stacktrace completo + breadcrumbs

Obtenha o evento mais recente para esse problema. Mostre-me o stacktrace, a release, e os últimos 5 breadcrumbs antes do crash.✓ Copiado

→ Arquivo:linha da função que lança + sequência de ações do usuário antes do erro
Identifique a release que introduziu

Este problema foi visto pela primeira vez na mesma release em que apareceu, ou permaneceu? Compare a tag de release.✓ Copiado

→ Sim/não com confiança — conduz a decisão de reversão

Resultado: Um resumo de incidente de 3 linhas que você pode colar no Slack: o que está quebrado, quem foi afetado, qual release causou, ação recomendada.

Armadilhas

Se suas tags de release não estiverem configuradas, você não consegue saber qual deploy introduziu o bug — Configure sentry-cli releases em seu CI antes de depender disso — sem isso, você está adivinhando
Stacktrace está em JS minificado e ilegível — Verifique se os sourcemaps foram enviados — sentry-cli sourcemaps upload deve estar em seu pipeline de construção

Combine com: github · linear

Referência cruzada de erros do Sentry com os commits do GitHub que os causaram

👤 Engenheiros sênior depurando problemas recorrentes ⏱ ~30 min advanced

Quando usar: Um erro continua voltando após cada release. Você suspeita de um caminho de código específico, mas quer confirmar.

Pré-requisitos

Tanto Sentry MCP quanto GitHub MCP instalados — Veja o guia do github para configuração
Releases marcadas com SHA do git no Sentry — Use sentry-cli releases new $SHA em CI

Fluxo

Liste o histórico do problema em releases

Para o problema Sentry WEB-3a91, liste cada release onde apareceu e a contagem de eventos por release.✓ Copiado

→ Tabela mostrando o problema disparando após deployments específicos
Para cada pico, busque o diff

Para as 3 releases com a contagem de eventos mais alta, use o GitHub MCP para obter o diff do commit. Quais arquivos cada release mudou?✓ Copiado

→ Arquivos comuns entre os picos — a arma do crime
Forme uma hipótese de causa raiz

Com base nesses diffs, qual é a causa raiz mais provável? Seja específico — aponte a(s) linha(s).✓ Copiado

→ Teoria no nível de linha que você pode validar verificando o código

Resultado: Uma hipótese específica em nível de código com evidência de eventos do Sentry e diffs do GitHub.

Armadilhas

Múltiplos commits em uma release — difícil isolar qual é o responsável — Use estilo git bisect: deploy um build com apenas metade dos commits e verifique se a taxa de erro cai

Combine com: github

Gere um relatório semanal de qualidade de engenharia a partir dos dados do Sentry

👤 Gerentes de engenharia ⏱ ~20 min intermediate

Quando usar: Sexta à tarde, antes do planejamento da próxima semana. Você quer saber se a qualidade está tendendo para cima ou para baixo.

Pré-requisitos

Acesso de leitura a todos os seus projetos no Sentry — Token com escopo para org:read + project:read + event:read

Fluxo

Puxe contagens de erros e sessões sem crash para a semana

Para nossa org, dê-me a % de sessão sem crash por projeto desta semana vs semana passada. Sinalize qualquer projeto onde caiu.✓ Copiado

→ Comparação por projeto com deltas
Identifique os principais contribuidores para o volume de erros

Quais 5 problemas são responsáveis pelos eventos mais desta semana, em todos os projetos?✓ Copiado

→ Lista concreta de problemas com contagens de eventos e links
Sugira foco para a próxima semana

Com base esses dados, o que a equipe deve priorizar para consertar na próxima semana? Considere volume e impacto do usuário.✓ Copiado

→ 3 recomendações priorizadas com raciocínio

Resultado: Um relatório de 1 página que você pode compartilhar em sua revisão semanal de engenharia com prioridades concretas.

Armadilhas

Métricas de volume são dominadas por um problema ruidoso, mascarando tudo mais — Filtre esse problema e re-classifique — às vezes o mais ruidoso não é o mais importante

Combine com: linear · notion

Quantifique o impacto do usuário de um bug conhecido antes de decidir consertar

👤 Gerentes de produto, leads técnicos triando o backlog de bugs ⏱ ~15 min beginner

Quando usar: Há um bug conhecido e a equipe está debatendo prioridade. Você precisa de dados, não de opiniões.

Fluxo

Puxe as estatísticas de impacto do usuário do problema

Para o problema Sentry WEB-3a91, quantos usuários únicos o atingiram nos últimos 30 dias, e qual é a % de usuários ativos totais?✓ Copiado

→ Contagem absoluta + porcentagem
Segmente os usuários afetados

Entre usuários afetados, qual é a distribuição por navegador, SO e nível de conta (pago vs gratuito)?✓ Copiado

→ Análise que revela se é uma questão de caso extremo ou fluxo principal
Compare com outros problemas abertos

Classifique nossos top 10 bugs abertos por usuários afetados este mês. Onde este está?✓ Copiado

→ Contexto para priorização

Resultado: Uma recomendação de prioridade baseada em dados: corrigir agora, corrigir este sprint, ou adiar.

Combinações

Combine com outros MCPs para 10× de alavancagem

sentry + github

Sentry → identifique release ruim → GitHub → encontre o commit que introduziu → draft de PR de reversão

Issue WEB-3a91 disparou após release [email protected]. Encontre os commits nessa release no GitHub, identifique o culpado mais provável, e draft uma PR de reversão.✓ Copiado

sentry + linear

Auto-crie issues do Linear a partir de novos problemas Sentry excedendo limite de eventos

Encontre qualquer problema Sentry novo das últimas 24h com >100 eventos. Para cada um, crie um ticket de bug do Linear atribuído ao engenheiro de plantão.✓ Copiado

sentry + notion

Relatório de qualidade de engenharia semanal postado no Notion

Puxe as estatísticas do Sentry dessa semana e crie uma página Notion no banco de dados Engineering / Weekly Reports.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_issues	organization, project, query?, sort?, limit?	Pesquise o fluxo de issue por status/release/ambiente/idade	1 chamada de API
get_issue	issue_id	Obtenha metadados completos para um problema específico, incluindo intervalo de release	1 chamada de API
get_event	issue_id, event_id?	Puxe o stacktrace real e breadcrumbs para depuração	1 chamada de API
list_releases	organization, project	Veja cronograma de deploy e qual release introduziu o quê	1 chamada de API
list_projects	organization	Descubra quais projetos existem em sua org	1 chamada de API

Custo e limites

O que custa rodar

Cota de API: Sentry: 40 req/seg por token (muito generoso). Sem limite diário na API em si.
Tokens por chamada: 200–1000 tokens por resposta de issue/evento; stacktraces grandes podem atingir 5k
Monetário: Tier gratuito: 5k erros/mês. Planos pagos cobram por volume de eventos, não uso de API.
Dica: API é gratuita; o que você realmente paga é pela ingestão de eventos. Use regras de sampling no Sentry em si para manter custos de ingestão previsíveis.

Segurança

Permissões, segredos, alcance

Escopos mínimos: org:read project:read event:read

Armazenamento de credenciais: Token de auth do usuário Sentry em env var SENTRY_AUTH_TOKEN

Saída de dados: Todas as chamadas para sua instância Sentry (sentry.io ou auto-hospedada)

Nunca conceda: org:write project:admin member:write

Solução de problemas

Erros comuns e correções

401 Token inválido

Token expirou ou não tem os escopos solicitados. Recrie em sentry.io/settings/account/api/auth-tokens/

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

404 Projeto não encontrado

O slug do projeto é sensível a maiúsculas e deve corresponder exatamente à URL. Verifique sentry.io/settings/projects/

Stacktrace vazio

Sourcemaps não enviados. Execute sentry-cli sourcemaps upload como parte de seu pipeline de construção.

Alternativas

Sentry vs. outros

Alternativa	Quando usar	Troca
Datadog APM MCP	Você já está no Datadog e quer APM + erros unificados	Mais caro, menos focado em erros especificamente
Rollbar / Bugsnag MCP	Você já paga por eles	Ecossistema MCP construído pela comunidade menor

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills