MCP

Ligue primeiro o Sentry MCP remoto e depois consulte eventos de depuração

Serve para depuração em colaboração humana no Cursor ou Claude Code. Prefira o serviço alojado em vez de arrancar stdio de imediato. search_events e search_issues também precisam de um fornecedor LLM configurado; sem ele essas duas ficam indisponíveis e as restantes ferramentas continuam a funcionar.

Official source · sentry-mcp

Install

"url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }

Para quem

Se ao escrever código precisa de contrastar com Sentry para depurar e aceita human-in-the-loop em vez de automatizar todas as funções Sentry, este serviço combina. Oficialmente visa sobretudo agentes de código human-in-the-loop; a escolha de ferramentas pende para o fluxo de programador e a depuração, não para um Sentry MCP geral de todas as funções. Atua como camada intermédia sobre a API Sentry a montante e é nomeado como otimizado para Cursor, Claude Code e ferramentas de desenvolvimento semelhantes.

Não serve para quem quer cobrir todas as funções Sentry, nem para quem ainda não tem token de acesso Sentry mas quer correr stdio primeiro. O trecho atual só nomeia com clareza ferramentas de pesquisa IA como search_events e search_issues; existem outras ferramentas, mas os nomes não estão neste trecho. Não complete os nomes em falta.

As consultas só de leitura mesmo assim passam pela API Sentry; não interprete como ausência de rede ou de limite de privacidade.

Primeira tentativa em 3 minutos

Prepare primeiro o seu próprio token de acesso Sentry. O caminho principal recomendado oficialmente é o serviço alojado de produção, não instalar stdio ao lado:

A entrada das notas de produção é https://mcp.sentry.dev/ . A configuração de cliente remoto do trecho é:

"url": "https://mcp.sentry.dev/mcp ",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }

O esquema de autenticação é Sentry-Bearer; não o mude para Bearer comum. Coloque este bloco num cliente MCP que suporte um URL remoto, troque o token pelo seu valor e não use nenhuma string de espaço reservado de exemplo. O trecho não fixa um nome de arquivo de cliente.

Depois de ligar, ponha primeiro uma pergunta de depuração que já tenha no Sentry. Se ainda não configurou um fornecedor LLM (o trecho lista OpenAI, Azure OpenAI, Anthropic, OpenRouter), não chame search_events nem search_issues: sem fornecedor essas duas ficam indisponíveis e as restantes ferramentas continuam a funcionar. A primeira tentativa deve preferir uma ferramenta não de pesquisa ainda disponível para um olhar só de leitura; os nomes concretos não estão no trecho, portanto o que se pode confirmar para em «ferramentas além da pesquisa IA».

O sinal de sucesso é o endereço remoto https://mcp.sentry.dev/mcp conseguir conversar e devolver informação de depuração do lado Sentry, não um 401, nem Authorization escrito como Bearer.

Casos de uso

Caso 1: fazer uma consulta de depuração num assistente de código. O trecho afirma que este serviço remoto visa o fluxo de programador e a depuração, e atua como camada intermédia da API Sentry. Ligue primeiro o URL alojado e depois pergunte um problema de depuração já existente. O que se pode conferir é este caminho de camada intermédia; nomes concretos de ferramentas não de pesquisa e campos de retorno não aparecem no trecho atual.

Caso 2: pesquisar eventos ou issues em linguagem natural. O trecho afirma que ferramentas de pesquisa IA como search_events e search_issues precisam de um fornecedor LLM para traduzir linguagem natural em sintaxe de consulta Sentry. Confirme que o fornecedor está configurado antes de agir. Sem ele estas ferramentas ficam indisponíveis; não interprete essa falha como o serviço inteiro ter caído. Os comandos de instalação e variáveis de chave dos fornecedores não estão no trecho; não os invente.

Esses dois casos correspondem a «ferramentas de depuração ordinárias» e «pesquisa IA». Não force a segunda via se o fornecedor não estiver configurado.

Limites de uso

O caminho principal é o serviço alojado https://mcp.sentry.dev/ e o endereço MCP remoto https://mcp.sentry.dev/mcp . O trecho também dá o comando stdio npx @sentry/mcp-server@latest e passa com --access-token um User Auth Token que você criou no Sentry; não preencha nenhum espaço reservado de exemplo. Os âmbitos de que o stdio precisa incluem org:read, project:read, project:write, team:read, team:write, event:write. Não siga este caminho na primeira vez, e sobretudo não comece com âmbitos write para escrever.

O repositório oficial é https://github.com/getsentry/sentry-mcp . Não é um invólucro de API Sentry de todas as funções. Não complete por conta própria nomes de ferramentas, o comportamento de atualização OAuth nem passos de revogação que não aparecem.