Raygun

✨ 주요 기능

• 🐛 오류 관리 - 전체 스택 트레이스와 컨텍스트를 포함한 애플리케이션 오류 및 충돌을 조사, 해결, 추적합니다
• 🚀 배포 추적 - 릴리스를 모니터링하고 오류를 배포와 연관시켜 문제가 있는 변경 사항을 식별합니다
• ⚡ 성능 인사이트 - 페이지 로드 시간, 사용자 지표, 시간에 따른 성능 추세를 분석합니다
• 🔬 APM 조사 - 백엔드 병목 지점, 반복적인 성능 문제, 느린 트레이스를 찾습니다
• 👥 사용자 모니터링 - 고객 세션, 행동 패턴을 추적하고 영향을 받는 사용자를 식별합니다
• 🤝 팀 협업 - 초대를 관리하고 팀 전체의 오류 해결을 조정합니다
• 📊 지표 및 분석 - 오류 및 성능에 대한 시계열 분석과 분포 히스토그램

📋 요구 사항

• 활성 구독이 있는 Raygun 계정
• OAuth를 지원하는 MCP 클라이언트 또는 Raygun 개인 액세스 토큰

🚀 시작하기

Raygun MCP 서버는 다음 위치에서 호스팅됩니다:

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

Raygun이 서비스를 호스팅하고 업데이트하므로 설치할 패키지나 로컬 서버가 없습니다.

OAuth (권장)

Authorization 헤더 없이 URL을 Streamable HTTP 서버로 추가하세요. 첫 연결 시 MCP 클라이언트가 브라우저에서 Raygun을 열어 로그인, 플랜 선택, 요청된 권한 검토, 액세스 승인을 진행합니다.

OAuth 클라이언트 ID나 클라이언트 시크릿을 제공할 필요가 없습니다. Raygun은 자동 클라이언트 등록을 지원합니다.

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"
    }
  }
}

개인 액세스 토큰

PAT 인증은 MCP OAuth를 지원하지 않는 클라이언트와 자동화를 위해 계속 지원됩니다. 다음 예시는 Cursor의 구성 형식을 사용합니다. 다른 클라이언트는 HTTP 서버 구성에서 동일한 Authorization 헤더를 사용합니다:

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

💬 첫 프롬프트

구성 후 AI 어시스턴트에게 다음을 시도해 보세요:

• "내 체크아웃 애플리케이션의 최신 배포 이후 처음 나타난 오류를 찾아줘."
• "가장 빈번하게 발생하는 프로덕션 오류를 조사하고 대표적인 스택 트레이스를 보여줘."
• "지난 24시간 동안 가장 많은 시간을 소비한 백엔드 메서드나 데이터베이스 쿼리는 무엇인가요?"
• "고객 user@example.com의 마지막 세션을 보여주고 어디서 경험이 실패했는지 설명해줘."
• "지난 7일 동안의 p95 페이지 성능을 비교하고 가장 큰 회귀를 식별해줘."

🛠️ 도구

Raygun MCP 서버는 다음 도구 범주를 제공합니다:

각 도구에 대한 자세한 문서는 도구 참조를 참조하세요.

🔐 인증

OAuth

Raygun은 HTTP 클라이언트용 MCP 권한 부여 흐름을 구현합니다. 서버는 OAuth 보호 리소스 메타데이터를 통해 권한 부여 서버를 광고하며, 호환 클라이언트는 클라이언트 ID 메타데이터 문서 또는 동적 클라이언트 등록을 통해 자동으로 등록됩니다.

액세스는 동의 화면에서 승인된 Raygun 사용자, 플랜 및 범위에 연결됩니다. 호환 클라이언트는 자체 토큰을 안전하게 저장하고 새로 고칩니다.

각 OAuth 연결은 하나의 Raygun 플랜에 대한 액세스를 부여합니다. 다른 플랜으로 작업해야 하는 경우 다른 Raygun MCP 구성을 추가하고 별도로 권한을 부여하세요.

보안 및 액세스

• OAuth는 로그인한 Raygun 사용자가 이미 보유한 액세스보다 더 많은 액세스를 클라이언트에 부여하지 않습니다.
• 읽기 및 쓰기 액세스는 OAuth 중 승인되거나 PAT에 할당된 범위에 의해 제어됩니다.
• 일부 도구는 오류 상태, 배포, 초대, 댓글 및 수집 API 키를 포함한 Raygun 데이터를 변경할 수 있습니다. MCP 클라이언트에서 승인하기 전에 쓰기 작업을 검토하세요.
• 애플리케이션 도구는 수집 API 키를 반환하거나 회전시킬 수 있습니다. 반환된 키를 자격 증명으로 취급하세요. 키를 회전하면 이전 키가 즉시 무효화됩니다.
• 도구 결과는 선택한 AI 클라이언트 또는 모델 공급자가 처리하는 대화에 포함될 수 있습니다. 진단 및 고객 데이터 공유에 대한 조직의 정책을 따르세요.

개인 액세스 토큰 얻기

OAuth가 적합하지 않은 경우 PAT를 계속 사용할 수 있습니다:

1. Raygun 개인 액세스 토큰으로 이동
2. 새 토큰 만들기 클릭
3. 토큰에 설명적인 이름을 지정(예: "MCP 서버 액세스")
4. 사용 사례에 적합한 권한 선택
5. 생성된 토큰을 복사하고 Authorization: Bearer YOUR_PAT_TOKEN로 전송

PAT를 안전하게 유지하고 버전 관리에 커밋하지 마세요.

자세한 내용은 Raygun API 문서를 참조하세요.

📖 소개

Raygun MCP 서버는 AI 어시스턴트가 충돌 보고, RUM 및 APM 데이터를 조사하고, 배포를 추적하고, 성능을 분석하고, 자연어 대화를 통해 애플리케이션 모니터링을 관리할 수 있게 합니다.

🔗 리소스

• 📚 Raygun 문서
• 📘 Raygun MCP 설정 가이드
• 🔌 Raygun API 참조
• 🤖 Model Context Protocol
• 🐛 문제 보고