Raygun

✨ Principais Recursos

• 🐛 Gerenciamento de Erros - Investigue, resolva e acompanhe erros e falhas de aplicativos com stack traces completos e contexto
• 🚀 Rastreamento de Implantações - Monitore versões e correlacione erros com implantações para identificar alterações problemáticas
• ⚡ Insights de Desempenho - Analise tempos de carregamento de páginas, métricas de usuários e tendências de desempenho ao longo do tempo
• 🔬 Investigação de APM - Encontre gargalos no backend, problemas recorrentes de desempenho e traces lentos
• 👥 Monitoramento de Usuários - Acompanhe sessões de clientes, padrões de comportamento e identifique usuários afetados
• 🤝 Colaboração em Equipe - Gerencie convites e coordene a resolução de erros em sua equipe
• 📊 Métricas e Análises - Análise de séries temporais e histogramas de distribuição para erros e desempenho

📋 Requisitos

• Uma conta Raygun com assinatura ativa
• Um cliente MCP com suporte a OAuth, ou um Personal Access Token do Raygun

🚀 Começando

O servidor MCP Raygun está hospedado em:

https://api.raygun.com/v3/mcp

A Raygun hospeda e atualiza o serviço, portanto não há pacote ou servidor local para instalar.

OAuth (recomendado)

Adicione a URL como um servidor HTTP Streamable sem o cabeçalho Authorization. Na primeira conexão, seu cliente MCP abrirá o Raygun no seu navegador para que você faça login, selecione um plano, revise as permissões solicitadas e autorize o acesso.

Você não precisa fornecer um ID de cliente OAuth ou segredo de cliente. A Raygun suporta registro automático de clientes.

codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun

claude mcp add --transport http raygun https://api.raygun.com/v3/mcp

{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

{
  "servers": {
    "raygun": {
      "type": "http",
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

Personal Access Token

A autenticação por PAT continua suportada para clientes sem suporte a OAuth do MCP e para automação. O exemplo a seguir usa o formato de configuração do Cursor; outros clientes usam o mesmo cabeçalho Authorization em sua configuração de servidor HTTP:

{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

💬 Seu Primeiro Prompt

Após a configuração, tente perguntar ao seu assistente de IA:

• "Encontre os erros que apareceram pela primeira vez após a implantação mais recente do meu aplicativo de checkout."
• "Investigue o erro de produção mais frequente e mostre-me um stack trace representativo."
• "Quais métodos de backend ou consultas de banco de dados consumiram mais tempo nas últimas 24 horas?"
• "Mostre-me a última sessão do cliente user@example.com e explique onde a experiência dele falhou."
• "Compare o desempenho de página p95 nos últimos sete dias e identifique a maior regressão."

🛠️ Ferramentas

O servidor MCP Raygun fornece as seguintes categorias de ferramentas:

Para documentação detalhada sobre cada ferramenta, consulte a Referência de Ferramentas.

🔐 Autenticação

OAuth

A Raygun implementa o fluxo de autorização do MCP para clientes HTTP. O servidor anuncia seu servidor de autorização por meio de Metadados de Recurso Protegido OAuth, e clientes compatíveis se registram automaticamente usando Documentos de Metadados de ID de Cliente ou Registro Dinâmico de Cliente.

O acesso está vinculado ao usuário, plano e escopos do Raygun aprovados na tela de consentimento. Clientes compatíveis armazenam e atualizam seus próprios tokens com segurança.

Cada conexão OAuth concede acesso a um plano Raygun. Adicione outra configuração MCP do Raygun e autorize-a separadamente quando precisar trabalhar com um plano diferente.

Segurança e acesso

• O OAuth nunca dá ao cliente mais acesso do que o usuário do Raygun conectado já possui.
• O acesso de leitura e escrita é controlado pelos escopos aprovados durante o OAuth ou atribuídos ao PAT.
• Algumas ferramentas podem alterar dados do Raygun, incluindo status de erros, implantações, convites, comentários e chaves de API de ingestão. Revise as ações de escrita antes de aprová-las no seu cliente MCP.
• As ferramentas de aplicativo podem retornar ou rotacionar chaves de API de ingestão. Trate as chaves retornadas como credenciais; rotacionar uma chave invalida imediatamente a anterior.
• Os resultados das ferramentas podem ser incluídos em conversas processadas pelo seu cliente de IA ou provedor de modelo escolhido. Siga as políticas da sua organização para compartilhar dados de diagnóstico e de clientes.

Obtendo um Personal Access Token

Os PATs permanecem disponíveis quando o OAuth não é adequado:

1. Navegue até Personal Access Tokens do Raygun
2. Clique em Criar Novo Token
3. Dê ao seu token um nome descritivo (por exemplo, "Acesso ao Servidor MCP")
4. Selecione as permissões apropriadas para o seu caso de uso
5. Copie o token gerado e envie-o como Authorization: Bearer YOUR_PAT_TOKEN

Mantenha os PATs seguros e nunca os envie para o controle de versão.

Para mais detalhes, consulte a documentação da API Raygun.

📖 Sobre

O servidor MCP Raygun permite que assistentes de IA investiguem dados de Crash Reporting, RUM e APM; acompanhem implantações; analisem desempenho; e gerenciem o monitoramento de aplicativos por meio de conversas em linguagem natural.

🔗 Recursos

• 📚 Documentação do Raygun
• 📘 Guia de Configuração do MCP Raygun
• 🔌 Referência da API Raygun
• 🤖 Model Context Protocol
• 🐛 Relatar Problemas