MCP do Sentry

O rastreamento de erros da plataforma utiliza o MCP oficial do Sentry — o getsentry/sentry-mcp, mantido pela própria Sentry. Ele conecta assistentes de IA (Claude, Gemini, Copilot, Cursor, etc.) à instância de bug tracking do Embrapa I/O (bug.embrapa.io), permitindo investigar exceções, analisar issues, consultar projetos e DSNs — tudo via linguagem natural.

Diferente dos demais MCPs da plataforma (servidores HTTP próprios, com login OAuth e URL de conexão), este é o servidor oficial da Sentry e roda por transporte stdio: o processo executa localmente na máquina do desenvolvedor (via Node/npx) e se conecta à instância self-hosted apontando para bug.embrapa.io. Uma versão hospedada com URL própria (mcp.bug.embrapa.io, streamable HTTP) está planejada; até lá, siga a configuração stdio descrita abaixo.

Conectar

Não há URL de conexão (o transporte é stdio). O servidor é o pacote npm @sentry/mcp-server, executado localmente. Pré-requisitos:

• Node.js instalado (versão LTS — 20 ou superior), que fornece o npx;
• um Auth Token do Sentry criado em bug.embrapa.io (veja abaixo).

Comando base (referência — os clientes abaixo encapsulam isto):

npx -y @sentry/mcp-server@latest --access-token=SEU_TOKEN --host=bug.embrapa.io --disable-skills=seer

• --host=bug.embrapa.io — aponta para a instância self-hosted (sem isto, o pacote tenta o Sentry cloud);
• --disable-skills=seer — o Seer (análise por IA da Sentry) não existe no self-hosted; desabilitá-lo evita expor tools que não funcionariam;
• o token pode ser passado pela variável de ambiente SENTRY_ACCESS_TOKEN em vez de --access-token (recomendado nos arquivos de configuração).

Criar o Auth Token

1. Acesse bug.embrapa.io e faça login;
2. Vá em User Settings → Auth Tokens (https://bug.embrapa.io/settings/account/api/auth-tokens/);
3. Clique em Create New Token e selecione os scopes:

   org:read   project:read   project:write   team:read   team:write   event:write
   

4. Copie o token gerado (começa com sntryu_…) — ele não é exibido novamente.

Atenção! O token herda as permissões da sua conta: você só enxerga as organizações e projetos aos quais já tem acesso no bug.embrapa.io.

Funcionalidades

O servidor oficial expõe tools para os principais fluxos de debugging:

Organizações, Times e Projetos — Listagem das organizações, times e projetos acessíveis ao usuário; criação de projetos/times e consulta de configurações.

Issues e Eventos — Detalhamento de uma issue (mensagem de erro, stack trace, frequência, versões afetadas), consulta de eventos individuais e atualização de status (resolver, ignorar).

Busca em linguagem natural — Tools de busca (search_events, search_issues) que traduzem perguntas em linguagem natural para a sintaxe de consulta do Sentry.

Releases e DSNs — Consulta de releases e das client keys (DSNs) de cada projeto.

Documentação — Consulta da documentação oficial do Sentry (SDKs, integração) diretamente pelo assistente.

Nota! As tools de busca por linguagem natural (search_events/search_issues) usam um modelo de IA para traduzir a consulta e, por isso, só funcionam se você fornecer um provedor de LLM próprio ao servidor (variáveis como OPENAI_API_KEY/ANTHROPIC_API_KEY). Sem provedor, essas tools ficam indisponíveis e todas as demais seguem funcionando normalmente. O Seer não está disponível no self-hosted — por isso mantemos --disable-skills=seer.

Nota! A instância da plataforma opera em modo somente erros (errors-only): recursos de traces/performance, profiling, session replay, crons, user feedback e metrics não são coletados. Assim, as tools ligadas a traces (notadamente get_trace_details e a busca de transactions no search_events) retornam vazio — o que não afeta as tools de erros, issues, projetos, releases e DSNs, que são o foco e funcionam normalmente.

Exemplos de Prompts

Abaixo, exemplos do que pode ser solicitado em linguagem natural a um assistente de IA conectado a este MCP:

Liste meus projetos no Sentry e quantas issues abertas cada um tem.

Mostre os detalhes da issue mais recente do projeto pasto-certo/api:
stack trace, frequência e versões afetadas.

Quais erros novos apareceram no projeto arena nas últimas 24 horas?

Resolva a issue 12345 do projeto controlpec/api.

Qual é o DSN do projeto fertiliza/backend?

Faça um diagnóstico do projeto mecaniza: principais erros, frequência
e em quais versões eles ocorrem.

Configuração no Claude Code

Como o transporte é stdio, a configuração informa o comando a executar (não uma URL). O Claude Code é o cliente de referência na plataforma — comece por ele.

Adicione o servidor com um único comando (--scope user o deixa disponível em qualquer projeto):

claude mcp add sentry --scope user \
  --env SENTRY_ACCESS_TOKEN=SEU_TOKEN \
  -- npx -y @sentry/mcp-server@latest --host=bug.embrapa.io --disable-skills=seer

Confirme a conexão com claude mcp list (o sentry deve aparecer como connected) ou digitando /mcp dentro do Claude Code.

Dica! Prefira passar o token pela variável SENTRY_ACCESS_TOKEN (--env), como acima, em vez de --access-token no comando — assim ele não fica exposto na linha de execução do processo.

Outros clientes

De forma acessória, os demais clientes usam o mesmo servidor stdio. O bloco JSON canônico (formato mcpServers) é:

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "@sentry/mcp-server@latest", "--host=bug.embrapa.io", "--disable-skills=seer"],
      "env": { "SENTRY_ACCESS_TOKEN": "SEU_TOKEN" }
    }
  }
}

Cursor, Windsurf, Antigravity e Claude Desktop usam exatamente esse bloco — cole-o no arquivo correspondente:

OpenAI Codex CLI e Gemini CLI — mesma lógica do Claude Code:

# OpenAI Codex CLI
codex mcp add sentry --env SENTRY_ACCESS_TOKEN=SEU_TOKEN \
  -- npx -y @sentry/mcp-server@latest --host=bug.embrapa.io --disable-skills=seer

# Gemini CLI
gemini mcp add sentry -e SENTRY_ACCESS_TOKEN=SEU_TOKEN \
  -- npx -y @sentry/mcp-server@latest --host=bug.embrapa.io --disable-skills=seer

VS Code (GitHub Copilot) — em .vscode/mcp.json (por projeto) ou nas User Settings, usa a chave servers com type: stdio:

{
  "servers": {
    "sentry": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sentry/mcp-server@latest", "--host=bug.embrapa.io", "--disable-skills=seer"],
      "env": { "SENTRY_ACCESS_TOKEN": "SEU_TOKEN" }
    }
  }
}

GitHub Copilot CLI — lê servidores MCP no mesmo formato mcpServers (bloco canônico); adicione o servidor sentry ao arquivo de configuração de MCP do Copilot CLI (consulte a documentação do cliente para o caminho exato na sua versão).

Nota! A partir destes exemplos é possível extrapolar para outros clientes com suporte a MCP stdio com poucos ajustes.

Referência Técnica

A superfície de tools do servidor oficial evolui entre versões. No momento, cobre os seguintes domínios:

Nota! Para a referência completa e sempre atualizada das tools, parâmetros e flags, consulte a documentação oficial (links abaixo).

Documentação oficial (Sentry MCP)

• Repositório getsentry/sentry-mcp
• Serviço e documentação do MCP
• Pacote @sentry/mcp-server (npm)