🚀 MCP Sentry para Cursor - Model Context Protocol Server

Um servidor MCP completo para integração com Sentry no Cursor, oferecendo 27 ferramentas para monitoramento de erros, performance e saúde de aplicações.

✨ Características

• 27 Ferramentas Completas: 12 SDK + 15 API
• Release Health: Monitoramento completo de sessões
• Performance Monitoring: Transações e spans
• Alertas Customizados: Regras de alerta automatizadas
• Busca Avançada: Por arquivo, short ID, queries complexas
• Setup Automático: Configuração de projetos com um comando
• Monitor em Tempo Real: Script de monitoramento incluído

🛠️ Instalação Rápida

1. Clone e Configure

cd /Users/agents/Desktop/context-engineering-intro/sentry-mcp-cursor
npm install
npm run build

2. Configure as Credenciais

# Edite config.env com suas credenciais (já configurado)
nano config.env

3. Adicione ao Cursor

./add-to-cursor.sh

📚 Scripts Disponíveis

🚀 Inicialização

• ./start-cursor.sh - Script otimizado para Cursor
• ./start-standalone.sh - Inicia com validações e status detalhado
• ./start.sh - Script padrão
• ./start-mcp.sh - Script com configurações hardcoded

🧪 Testes e Monitoramento

• ./test-standalone.sh - Executa suite completa de testes
• ./monitor.sh - NOVO! Monitor em tempo real com estatísticas

🔧 Gerenciamento

• ./add-to-cursor.sh - NOVO! Adiciona ao Cursor automaticamente
• ./add-to-claude-code.sh - Adiciona ao Claude Code
• ./remove-from-claude-code.sh - Remove do Claude Code

🎯 Ferramentas Disponíveis

SDK Tools (12)

1. mcp__sentry__sentry_capture_exception - Captura exceções
2. mcp__sentry__sentry_capture_message - Captura mensagens
3. mcp__sentry__sentry_add_breadcrumb - Adiciona breadcrumbs
4. mcp__sentry__sentry_set_user - Define usuário
5. mcp__sentry__sentry_set_tag - Define tags
6. mcp__sentry__sentry_set_context - Define contexto
7. mcp__sentry__sentry_start_transaction - Inicia transação
8. mcp__sentry__sentry_finish_transaction - Finaliza transação
9. mcp__sentry__sentry_start_session - Inicia sessão
10. mcp__sentry__sentry_end_session - Finaliza sessão
11. mcp__sentry__sentry_set_release - Define release
12. mcp__sentry__sentry_capture_session - Captura sessão

API Tools (15)

1. mcp__sentry__sentry_list_projects - Lista projetos
2. mcp__sentry__sentry_list_issues - Lista issues
3. mcp__sentry__sentry_create_release - Cria release
4. mcp__sentry__sentry_list_releases - Lista releases
5. mcp__sentry__sentry_get_organization_stats - Estatísticas
6. mcp__sentry__sentry_create_alert_rule - Cria alertas
7. mcp__sentry__sentry_resolve_short_id - Resolve IDs curtos
8. mcp__sentry__sentry_get_event - Obtém evento
9. mcp__sentry__sentry_list_error_events_in_project - Lista erros
10. mcp__sentry__sentry_create_project - Cria projeto
11. mcp__sentry__sentry_list_issue_events - Lista eventos de issue
12. mcp__sentry__sentry_get_issue - Obtém issue
13. mcp__sentry__sentry_list_organization_replays - Lista replays
14. mcp__sentry__sentry_setup_project - Setup de projeto
15. mcp__sentry__sentry_search_errors_in_file - Busca erros em arquivo

💡 Uso no Cursor

No Cursor, as ferramentas ficam disponíveis com o prefixo mcp__sentry__:

// Capturar exceção
await mcp__sentry__sentry_capture_exception({
  error: "Database connection failed",
  level: "error",
  tags: {
    component: "database"
  }
});

// Listar projetos
await mcp__sentry__sentry_list_projects();

// Criar release
await mcp__sentry__sentry_create_release({
  version: "app@1.0.0",
  projects: ["coflow"]
});

📊 Monitor em Tempo Real

Execute o monitor para acompanhar estatísticas:

./monitor.sh

O monitor exibe:

• Status do servidor MCP
• Configuração no Cursor
• Estatísticas das últimas 24h
• Issues não resolvidas
• Última release
• Total de ferramentas disponíveis
• Atualização automática a cada 30s

🧪 Testes

Execute a suite completa de testes:

./test-standalone.sh

🔍 Troubleshooting

Servidor não aparece no Cursor

# Verificar configuração
cat ../.cursor/mcp.json

# Reinstalar
./add-to-cursor.sh

# Reiniciar Cursor

Monitor não encontra servidor

# Verificar se o servidor está rodando
ps aux | grep "node dist/index.js"

# Reiniciar servidor no Cursor

📝 Configuração

config.env

SENTRY_DSN=https://782bbb46ddaa4e64a9a705e64f513985@o927801.ingest.us.sentry.io/5877334
SENTRY_AUTH_TOKEN=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
SENTRY_ORG=coflow
SENTRY_API_URL=https://sentry.io/api/0/
SENTRY_RELEASE=mcp-sentry-cursor@1.0.0
SENTRY_ENVIRONMENT=production

🎯 Melhorias Implementadas

Do MCP Claude Code:

• ✅ Script monitor.sh para monitoramento em tempo real
• ✅ Script add-to-cursor.sh para instalação automatizada
• ✅ Melhor suporte para config.env no start-cursor.sh
• ✅ Documentação atualizada com prefixos do Cursor

🔗 Links Úteis

• Documentação Sentry
• MCP SDK
• Dashboard Sentry

📄 Licença

MIT

---

Desenvolvido com ❤️ para Cursor