Sentry

Interaja com a API do Sentry para monitorar erros e desempenho de aplicações.

GitHub
21
Experimente este MCPPatrocinado

Documentação

Servidor Sentry MCP

Um servidor Model Context Protocol (MCP) para interagir com o Sentry. Este servidor MCP fornece ferramentas para interagir com a API do Sentry, permitindo que assistentes de IA recuperem e analisem dados de erros, gerenciem projetos e monitorem o desempenho de aplicações.

Requisitos

  • Node.js (v14 ou superior)
  • npm ou yarn
  • Conta Sentry com acesso à API
  • Token de autenticação Sentry com permissões apropriadas

Configuração

  1. Instale as dependências: 
    npm install

Usando isso em uma IDE

Este MCP foi verificado para funcionar com o Codeium Windsurf.

O Cursor está atualmente com problemas em sua implementação de MCP; e esta ferramenta ainda não está totalmente funcional.

Usando com Claude

Para usar este servidor MCP com o Claude, adicione a seguinte configuração às suas configurações do Claude:

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/mcp-sentry-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
            }
        }
    }
}
  • Atualize com o caminho do seu diretório no campo args.
  • Substitua <YOUR_AUTH_TOKEN> pelo seu token de autenticação do Sentry.

Ferramentas Disponíveis

list_projects

Lista todos os projetos Sentry acessíveis para uma determinada organização.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização da qual listar projetos
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

resolve_short_id

Recupera detalhes sobre um problema usando seu ID curto.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização à qual o problema pertence
  • short_id (string, obrigatório): O ID curto do problema a resolver (ex.: PROJECT-123)
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

get_sentry_event

Recupera e analisa um evento Sentry específico de um problema.

Parâmetros:

  • issue_id_or_url (string, obrigatório): Ou uma URL completa do problema Sentry ou apenas o ID numérico do problema
  • event_id (string, obrigatório): O ID específico do evento a recuperar
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

list_error_events_in_project

Lista eventos de erro de um projeto Sentry específico.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização à qual o projeto pertence
  • project_slug (string, obrigatório): O slug do projeto do qual listar eventos
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

create_project

Cria um novo projeto no Sentry e recupera suas chaves de cliente.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização na qual criar o projeto
  • team_slug (string, obrigatório): O slug da equipe à qual atribuir o projeto
  • name (string, obrigatório): O nome do novo projeto
  • platform (string, opcional): A plataforma para o novo projeto
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

list_project_issues

Lista problemas de um projeto Sentry específico.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização à qual o projeto pertence
  • project_slug (string, obrigatório): O slug do projeto do qual listar problemas
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

list_issue_events

Lista eventos para um problema Sentry específico.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização à qual o problema pertence
  • issue_id (string, obrigatório): O ID do problema do qual listar eventos
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

get_sentry_issue

Recupera e analisa um problema do Sentry.

Parâmetros:

  • issue_id_or_url (string, obrigatório): Ou uma URL completa do problema Sentry ou apenas o ID numérico do problema
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

list_organization_replays

Lista replays de uma organização Sentry específica.

Parâmetros:

  • organization_slug (string, obrigatório): O slug da organização da qual listar replays
  • project_ids (string[], opcional): Lista de IDs de projetos para filtrar replays
  • environment (string, opcional): Ambiente para filtrar replays
  • stats_period (string, opcional): Período de tempo para estatísticas (ex.: "24h", "7d")
  • start (string, opcional): Data de início para filtrar replays
  • end (string, opcional): Data de término para filtrar replays
  • sort (string, opcional): Campo pelo qual ordenar replays
  • query (string, opcional): Consulta de pesquisa para filtrar replays
  • per_page (number, opcional): Número de replays por página
  • cursor (string, opcional): Cursor para paginação
  • view (string, opcional): Tipo de visualização, "summary" ou "detailed" (padrão: "detailed")
  • format (string, opcional): Formato de saída, "plain" ou "markdown" (padrão: "markdown")

Executando o Servidor

npx ts-node index.ts

Autenticação

Esta ferramenta requer um token de autenticação Sentry com permissões apropriadas para acessar a API do Sentry. Você pode gerar um token nas configurações da sua conta Sentry em "API Keys".

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

  • Token de autenticação ausente
  • Falhas em solicitações de API
  • Parâmetros inválidos
  • Erros de rede

Todos os erros são registrados no console para depuração.