COMPARISON.md•3.34 kB
# Comparação: MCP Sentry Oficial vs Nossa Implementação
## Ferramentas do MCP Oficial do Sentry
1. **list_projects** - Lista projetos acessíveis do Sentry
2. **resolve_short_id** - Recupera detalhes de um issue usando short ID
3. **get_sentry_event** - Recupera um evento específico do Sentry
4. **list_error_events_in_project** - Lista eventos de erro de um projeto
5. **create_project** - Cria um novo projeto no Sentry
6. **list_project_issues** - Lista issues de um projeto
7. **list_issue_events** - Lista eventos de um issue específico
8. **get_sentry_issue** - Recupera e analisa um issue do Sentry
9. **list_organization_replays** - Lista replays de uma organização
10. **setup_sentry** - Configura Sentry para um projeto
11. **search_errors_in_file** - Busca erros em um arquivo específico
## Ferramentas da Nossa Implementação
### SDK Tools (12 ferramentas)
1. **sentry_capture_exception** - Captura e envia exceções
2. **sentry_capture_message** - Captura e envia mensagens
3. **sentry_add_breadcrumb** - Adiciona breadcrumbs
4. **sentry_set_user** - Define contexto de usuário
5. **sentry_set_tag** - Define tags
6. **sentry_set_context** - Define contexto customizado
7. **sentry_start_transaction** - Inicia transação de performance
8. **sentry_finish_transaction** - Finaliza transação
9. **sentry_start_session** - Inicia sessão (Release Health)
10. **sentry_end_session** - Finaliza sessão
11. **sentry_set_release** - Define versão de release
12. **sentry_capture_session** - Captura sessão manual
### API Tools (6 ferramentas)
1. **sentry_list_projects** - Lista projetos
2. **sentry_list_issues** - Lista issues
3. **sentry_create_release** - Cria release
4. **sentry_list_releases** - Lista releases
5. **sentry_get_organization_stats** - Estatísticas da organização
6. **sentry_create_alert_rule** - Cria regra de alerta
## Análise Comparativa
### Vantagens do MCP Oficial:
- **Formatação de saída**: Suporta markdown e plain text
- **Parâmetros de view**: summary vs detailed
- **Ferramentas específicas**: resolve_short_id, search_errors_in_file, replays
- **setup_sentry**: Configuração automática de projetos
- **get_sentry_event/issue**: Acesso direto a eventos e issues
### Vantagens da Nossa Implementação:
- **SDK completo**: Todas operações do SDK (captura, breadcrumbs, performance)
- **Release Health**: Gestão completa de sessões
- **Performance Monitoring**: Transações e spans
- **Contexto rico**: User, tags, custom context
- **Alertas**: Criação de regras de alerta
- **Estatísticas**: Acesso a stats da organização
## Melhorias Propostas
### Do MCP Oficial para o Nosso:
1. ✅ **Formatação de output** (markdown/plain)
2. ✅ **View modes** (summary/detailed)
3. ✅ **resolve_short_id** - Resolver IDs curtos
4. ✅ **search_errors_in_file** - Buscar erros por arquivo
5. ✅ **setup_sentry** - Setup automático
6. ✅ **list_organization_replays** - Listar replays
7. ✅ **get_sentry_event** - Obter evento específico
8. ✅ **get_sentry_issue** - Obter issue específico
### Melhorias de Arquitetura:
1. ✅ **Types TypeScript** - Importar types.ts do oficial
2. ✅ **Error handling** - Melhorar tratamento de erros
3. ✅ **Debug mode** - Adicionar logs de debug
4. ✅ **Response formatting** - Estrutura de resposta consistente