Sentry MCP Server

Um servidor MCP para interagir com a plataforma de rastreamento de erros e monitoramento de desempenho Sentry.

GitHub
11
Experimente este MCPPatrocinado

Documentação

Nota - Isto foi em grande parte substituído pelo Remote-MCP Server do Sentry, que suporta muito mais recursos (autenticação, melhores ferramentas, etc...). Este existe para fins educacionais como um servidor MCP autônomo; mas muito provavelmente você vai querer usar o remoto. Você pode vê-lo ao vivo em https://mcp.sentry.dev

Sentry MCP Server

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 do Sentry com as permissões apropriadas

Configuração

  1. Instale as dependências: 
    npm install

Usando dentro de uma IDE

Este MCP foi verificado para funcionar com Cursor, Codeium Windsurf e Claude Desktop.

Usando com Claude

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

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-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 acessíveis do Sentry 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 específico do Sentry de um problema.

Parâmetros:

  • issue_id_or_url (string, obrigatório): Ou uma URL completa do problema do 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 específico do Sentry.

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 específico do Sentry.

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 específico do Sentry.

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 do 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 específica do Sentry.

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 para ordenar replays
  • query (string, opcional): Consulta de busca 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 do Sentry com as permissões apropriadas para acessar a API do Sentry. Você pode gerar um token nas configurações da sua conta do Sentry em Configurações -> Configurações do Usuário -> Tokens de Autenticação.