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

Name: Sentry MCP MCP Server
Author: getsentry

Por que usar

Principais recursos

Buscar issues com a sintaxe de query do Sentry
Buscar payload completo do evento: stack trace, breadcrumbs, request, tags
Saúde do release: detecção de regressão, adoção, taxa sem crashes
Traces de performance com breakdown de spans
Metadados de projeto + time para queries entre projetos

Demo ao vivo

Como fica na prática

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

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

~/.continue/config.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Depurar um erro de produção de ponta a ponta sem sair do Claude

👤 Desenvolvedores triando alertas de plantão ⏱ ~20 min intermediate

Quando usar: Um alerta do Sentry dispara; você precisa da causa raiz agora.

Pré-requisitos

Token de autenticação do Sentry — Configurações de usuário → Auth Tokens → criar com 'project:read', 'event:read', 'org:read'
Token no ambiente — Defina SENTRY_AUTH_TOKEN e SENTRY_HOST (sentry.io ou self-hosted)

Fluxo

Encontrar o issue

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

→ ID do issue + contagem + visto pela primeira/última vez
Buscar contexto completo

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

→ Payload completo do evento com frames + rastro de ações do usuário
Correlacionar com o deploy

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

→ Tag do release + lista de commits
Propor correção

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

→ Arquivo + linha específicos referenciados; patch concreto

Resultado: Do alerta à correção candidata em minutos, com cadeia completa de evidências.

Armadilhas

Source maps ausentes — frames do stack inúteis — Verifique o upload de source maps no seu release do Sentry; sem eles, frames minificados não dão ao Claude nada para raciocinar

Combine com: github

Verificação pré-voo antes de promover um release

👤 Engenheiros de release, responsáveis pelo deploy ⏱ ~15 min intermediate

Quando usar: Prestes a promover um release canário para 100%.

Fluxo

Comparar saúde do release

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

→ % sem crash por release, adoção, contagem de regressões
Verificar novos erros

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

→ Lista de novos issues com contagens
Recomendar

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

→ Recomendação clara com thresholds explicitados

Resultado: Decisão de publicar/pausar baseada em dados, não em intuição.

Armadilhas

Adoção muito baixa para ser estatisticamente significativa — O Claude deve sinalizar janelas de baixa adoção como inconclusivas — não fingir saber

Investigar uma regressão de performance usando traces de transação

👤 Engenheiros de backend caçando latência ⏱ ~25 min advanced

Quando usar: A latência p95 no /checkout aumentou após o último deploy.

Fluxo

Buscar um trace lento recente

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

→ Trace com breakdown de spans
Encontrar o novo span

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

→ Diff: nova query DB 'SELECT cart_items', média 1,4s
Conectar ao código

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

→ Commit + proposta concreta de correção

Resultado: Causa raiz para uma regressão de performance, com proposta de correção no nível do código.

Armadilhas

Taxa de amostragem de trace muito baixa — nenhum trace lento capturado — Aumente temporariamente a taxa de amostragem, ou peça ao Claude para usar endpoints de estatísticas

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

sentry-mcp-getsentry + github

Do frame de stack do Sentry direto para um rascunho de PR

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

sentry-mcp-getsentry + linear

Criar tickets de engenharia automaticamente a partir de regressões

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

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_issues	project, query, statsPeriod?	Filtrar issues por query do Sentry	1 chamada à API do Sentry
get_issue	issue_id	Visão geral de um issue	1 chamada de API
get_event	event_id ou 'latest'	Buscar uma ocorrência específica com contexto completo	1 chamada de API
list_releases	project, version?	Comparação cross-release	1 chamada de API
get_trace	trace_id	Investigação de performance	1 chamada de API

Custo e limites

O que custa rodar

Cota de API: Limites padrão de rate limit da API do Sentry — rajadas podem gerar 429
Tokens por chamada: Payload de evento pode ter 5–20k tokens — busque seletivamente
Monetário: Gratuito para plano developer do Sentry; planos pagos têm limites maiores
Dica: Use search_issues para refinar primeiro; só chame get_event nos candidatos — não em listas inteiras de resultados

Segurança

Permissões, segredos, alcance

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

Armazenamento de credenciais: Variável de ambiente SENTRY_AUTH_TOKEN (use um token com escopo restrito ao projeto)

Saída de dados: Todas as chamadas para o seu host Sentry (sentry.io ou self-hosted)

Nunca conceda: project:write ou org:write a um agente controlado por chat

Dados de evento podem conter PII (corpos de request, IDs de usuário) — aplique as regras de scrubbing de dados do Sentry anteriormente

Solução de problemas

Erros comuns e correções

401 Unauthorized

Token expirado ou escopo errado — regenere com os escopos de leitura listados

Verificar: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

Stack trace mostra apenas frames minificados

Verifique o upload de source maps no seu pipeline de release; sem mapas, o Claude não consegue raciocinar sobre os frames

Verificar: UI do Sentry → Release → Artifacts

404 em um issue conhecido

O issue está em um projeto que o token não cobre — restrinja o escopo do token a esse projeto

Sentry self-hosted — conexão recusada

Defina SENTRY_HOST explicitamente para a URL da sua instância com protocolo

Verificar: curl $SENTRY_HOST/api/0/

Alternativas

Sentry MCP vs. outros

Alternativa	Quando usar	Troca
Datadog MCP	Seu time usa Datadog APM/rastreamento de erros	Cobertura diferente; focado em APM, menos orientado a issues
Honeycomb MCP	Você é um time com observabilidade baseada em eventos, não em stack traces	Sem agrupamento de issues de primeira classe; centrado em traces

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills