O que sentry-mcp faz?
Servidor MCP do Sentry para rastreamento de erros, stack traces, tendências de frequência e monitoramento de deploys.
Visão Geral
O sentry/sentry-mcp fornece ferramentas para que agentes de IA consultem e analisem dados da plataforma de monitoramento Sentry. Através do Model Context Protocol (MCP), agentes como Claude Code, Cursor, Codex e outros podem investigar erros, releases e tendências diretamente do seu fluxo de trabalho.
Funcionalidades
- Rastreamento de Erros: Obtenha stack traces completos para issues específicas.
- Tendências de Frequência: Analise a frequência de erros ao longo do tempo.
- Monitoramento de Deploys: Consulte releases e deploys recentes.
- Detalhes da Issue: Recupere breadcrumbs, metadados e contexto.
Configuração
Para usar este servidor MCP, você precisa de:
- Uma conta no Sentry (ou instância auto-hospedada).
- Um token de autenticação do Sentry (chave de API).
- Configurar o MCP no seu cliente (ex.: Claude Code, Cursor, VS Code).
Instalação
# Exemplo de instalação via pip (se publicado como pacote Python)
pip install sentry-mcp
Configuração no Cliente
Adicione o servidor ao arquivo de configuração MCP do seu cliente:
Exemplo para Claude Code (claude.json):
{
"mcpServers": {
"sentry": {
"command": "uvx",
"args": ["sentry-mcp"],
"env": {
"SENTRY_AUTH_TOKEN": "seu-token-aqui"
}
}
}
}
Variáveis de Ambiente:
SENTRY_AUTH_TOKEN(obrigatório): Token de autenticação da API do Sentry.SENTRY_ORG(opcional): Slug da organização no Sentry.SENTRY_URL(opcional): URL da instância auto-hospedada (padrão:https://sentry.io).
Ferramentas Disponíveis
| Ferramenta | Descrição | Parâmetros Principais |
|---|---|---|
get_issue_stack_trace | Obtém o stack trace completo de uma issue. | issueId (string) |
get_event_trends | Retorna tendências de frequência de eventos. | orgSlug, projectSlug, interval (opcional) |
list_releases | Lista releases recentes de um projeto. | orgSlug, projectSlug, limit (opcional) |
get_issue_breadcrumbs | Recupera breadcrumbs de uma issue específica. | issueId (string) |
Exemplos de Uso
Como consultar um stack trace:
"Mostre o stack trace da issue SENTRY-123"
Como ver tendências de frequência:
"Quais são as tendências de erro no projeto 'meu-app' na última semana?"
Como listar deploys:
"Liste as últimas 5 releases do projeto 'meu-app'"
Recursos Adicionais
Licença
Este projeto é distribuído sob a licença MIT.