/ 디렉터리 / 플레이그라운드 / Sentry
← 모든 서버 ↗ GitHub
● 공식 getsentry 🔑 본인 키 필요

Sentry

제작: getsentry · getsentry/sentry-mcp

AI 에이전트가 모든 Sentry 조사의 첫 5분을 처리하도록 하세요 — 문제를 찾고, 스택트레이스를 가져오고, 나쁜 릴리스를 파악합니다.

Sentry의 공식 MCP 서버입니다. 신규도/릴리스/환경별로 문제를 검색하고, 전체 스택트레이스 및 브레드크럼을 가져오고, 릴리스와 교차 참조합니다. Slack에서 '뭔가 깨졌다'는 알림을 1분 이내에 분류된 인시던트로 변환합니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

sentry.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "sentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add sentry -- npx -y @sentry/mcp-server

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Sentry

프로덕션 인시던트를 5분 내에 분류합니다

👤 온콜 엔지니어 ⏱ ~5 min intermediate

언제 쓸까: PagerDuty가 당신을 깨웠습니다. Sentry가 오류 급증을 보고합니다. 무엇인지, 왜인지, 롤백할지 여부를 빠르게 파악해야 합니다.

사전 조건
  • Sentry 조직 슬러그 + 프로젝트 슬러그 — sentry.io/organizations/<ORG>/issues/?project=<ID>의 Sentry URL을 확인하세요
  • event:read 및 project:read 권한이 있는 Sentry 사용자 인증 토큰 — sentry.io/settings/account/api/auth-tokens/
흐름
  1. 지난 시간 동안 최상위 새 문제를 찾습니다
    지난 시간 동안 우리의 web-prod 프로젝트에서 이벤트 수 기준으로 순위가 매겨진 최상위 새 문제는 무엇입니까?✓ 복사됨
    → 제목, 이벤트 수, 영향받은 사용자, 처음 확인된 타임스탐프가 있는 단일 문제
  2. 최신 이벤트와 전체 스택트레이스 + 브레드크럼을 가져옵니다
    해당 문제의 최신 이벤트를 가져옵니다. 스택트레이스, 릴리스, 크래시 이전의 마지막 5개 브레드크럼을 표시합니다.✓ 복사됨
    → 오류를 발생시킨 함수의 파일:라인 + 오류 이전의 사용자 작업 시퀀스
  3. 도입한 릴리스를 파악합니다
    이 문제가 나타난 릴리스와 동일한 릴리스에서 처음 확인되었나요, 아니면 이전에 계속되었나요? 릴리스 태그를 비교합니다.✓ 복사됨
    → 롤백 결정을 근거로 한 예/아니오 및 확신도

결과: Slack에 붙여넣을 수 있는 3줄의 인시던트 요약: 무엇이 깨졌는지, 누가 영향을 받았는지, 어떤 릴리스가 이를 초래했는지, 권장 작업입니다.

함정
  • 릴리스 태그가 연결되어 있지 않으면 어떤 배포가 버그를 도입했는지 알 수 없습니다 — 이를 사용하기 전에 CI에서 sentry-cli releases를 설정하세요 — 없으면 추측하는 것입니다
  • 스택트레이스가 축소된 JavaScript로 되어 있어 읽을 수 없습니다 — 소스맵이 업로드되었는지 확인하세요 — sentry-cli sourcemaps upload가 빌드 파이프라인에 있어야 합니다
함께 쓰기: github · linear

Sentry 오류와 이를 초래한 GitHub 커밋을 교차 참조합니다

👤 반복되는 문제를 디버깅하는 시니어 엔지니어 ⏱ ~30 min advanced

언제 쓸까: 오류가 각 릴리스 이후마다 반복해서 나타납니다. 특정 코드 경로를 의심하지만 확인하고 싶습니다.

사전 조건
  • Sentry MCP 및 GitHub MCP 설치 — github 가이드에서 설정을 참조하세요
  • Sentry에서 git SHA가 태그된 릴리스 — CI에서 sentry-cli releases new $SHA를 사용하세요
흐름
  1. 릴리스 전체에 걸친 문제의 이력을 나열합니다
    Sentry 문제 WEB-3a91에 대해 나타난 모든 릴리스 및 릴리스당 이벤트 수를 나열합니다.✓ 복사됨
    → 특정 배포 이후에 문제가 급증하는 것을 보여주는 테이블
  2. 각 급증에 대해 차이점을 가져옵니다
    이벤트 수가 가장 많은 3개의 릴리스에 대해 GitHub MCP를 사용하여 커밋 차이를 가져옵니다. 각 릴리스는 어떤 파일을 변경했습니까?✓ 복사됨
    → 급증 전체에 걸친 공통 파일 — 증거
  3. 근본 원인 가설을 형성합니다
    해당 차이를 기반으로 가장 가능성 높은 근본 원인은 무엇입니까? 구체적으로 — 라인을 지적하세요.✓ 복사됨
    → 코드를 확인하여 검증할 수 있는 라인 수준의 이론

결과: Sentry의 이벤트와 GitHub의 차이에 대한 증거가 있는 특정 코드 수준의 가설입니다.

함정
  • 릴리스의 여러 커밋 — 어떤 것이 책임이 있는지 파악하기 어렵습니다 — git bisect 스타일 사용: 커밋의 절반만 있는 빌드를 배포하고 오류율이 떨어지는지 확인합니다
함께 쓰기: github

Sentry 데이터로 주간 엔지니어링 품질 보고서를 작성합니다

👤 엔지니어링 관리자 ⏱ ~20 min intermediate

언제 쓸까: 금요일 오후, 다음 주 계획 이전입니다. 품질이 상승하는지 하락하는지 알고 싶습니다.

사전 조건
  • Sentry의 모든 프로젝트에 대한 읽기 액세스 — org:read + project:read + event:read로 범위가 지정된 토큰
흐름
  1. 주간 오류 및 크래시 프리 세션 수를 가져옵니다
    우리 조직의 경우, 이번 주와 지난 주의 프로젝트당 크래시 프리 세션 %를 제공합니다. 크래시 프리 세션이 감소한 프로젝트를 표시합니다.✓ 복사됨
    → 델타가 있는 프로젝트별 비교
  2. 오류 볼륨에 가장 많이 기여하는 것을 파악합니다
    모든 프로젝트에서 이번 주 가장 많은 이벤트에 책임이 있는 상위 5개 문제는 무엇입니까?✓ 복사됨
    → 이벤트 수 및 링크가 있는 구체적인 문제 목록
  3. 다음 주 초점을 제안합니다
    이 데이터를 기반으로 팀이 다음 주 수정할 우선순위는 무엇입니까? 볼륨과 사용자 영향을 고려합니다.✓ 복사됨
    → 추론이 있는 3개의 우선순위 권장사항

결과: 주간 엔지니어링 검토에서 공유할 수 있는 구체적인 우선순위가 있는 1페이지 보고서입니다.

함정
  • 볼륨 지표가 하나의 시끄러운 문제에 의해 지배되어 다른 모든 것을 숨깁니다 — 해당 문제를 필터링하고 다시 순위를 매기세요 — 가장 시끄러운 것이 가장 중요한 것은 아닙니다
함께 쓰기: linear · notion

수정 여부를 결정하기 전에 알려진 버그의 사용자 영향을 정량화합니다

👤 제품 관리자, 버그 백로그를 분류하는 기술 리드 ⏱ ~15 min beginner

언제 쓸까: 알려진 버그가 있고 팀이 우선순위를 논쟁하고 있습니다. 의견이 아닌 데이터가 필요합니다.

흐름
  1. 문제의 사용자 영향 통계를 가져옵니다
    Sentry 문제 WEB-3a91에 대해 지난 30일 동안 몇 명의 고유 사용자가 이를 경험했고, 전체 활성 사용자의 몇 %입니까?✓ 복사됨
    → 절대값 + 백분율
  2. 영향받은 사용자를 분석합니다
    영향받은 사용자 중에서 브라우저, OS 및 계정 티어(유료 vs 무료)별 분포는 무엇입니까?✓ 복사됨
    → 가장자리 사례인지 핵심 플로우 문제인지 나타내는 분석
  3. 다른 열린 문제와 비교합니다
    이번 달 사용자 영향을 받은 상위 10개의 열린 버그를 순위 매기세요. 이 문제는 어디에 위치합니까?✓ 복사됨
    → 우선순위 지정 컨텍스트

결과: 데이터 기반 우선순위 권장사항: 지금 수정, 이번 스프린트에 수정, 또는 연기합니다.

조합

다른 MCP와 조합해 10배 효율

sentry + github

Sentry → 나쁜 릴리스를 파악 → GitHub → 이를 도입한 커밋 찾기 → 롤백 PR 초안

문제 WEB-3a91이 릴리스 [email protected] 이후에 급증했습니다. GitHub에서 해당 릴리스의 커밋을 찾고, 가장 가능성 높은 원인을 파악하고, 롤백 PR을 초안합니다.✓ 복사됨
sentry + linear

이벤트 임계값을 초과하는 새로운 Sentry 문제에서 Linear 문제 자동 생성

지난 24시간의 100개 이상 이벤트가 있는 새로운 Sentry 문제를 찾습니다. 각 문제에 대해 온콜 엔지니어에게 할당된 Linear 버그 티켓을 생성합니다.✓ 복사됨
sentry + notion

Notion에 게시되는 주간 엔지니어링 품질 보고서

이번 주의 Sentry 통계를 가져오고 Engineering / Weekly Reports 데이터베이스에 Notion 페이지를 생성합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
list_issues organization, project, query?, sort?, limit? 상태/릴리스/환경/기간별로 문제 스트림을 검색합니다 1개 API 호출
get_issue issue_id 릴리스 범위를 포함한 특정 문제의 전체 메타데이터를 가져옵니다 1개 API 호출
get_event issue_id, event_id? 디버깅을 위해 실제 스택트레이스 및 브레드크럼을 가져옵니다 1개 API 호출
list_releases organization, project 배포 타임라인 및 어떤 릴리스가 무엇을 도입했는지 확인합니다 1개 API 호출
list_projects organization 조직에 존재하는 프로젝트를 발견합니다 1개 API 호출

비용 및 제한

운영 비용

API 쿼터
Sentry: 토큰당 40회/초 (매우 관대합니다). API 자체에 일일 한도가 없습니다.
호출당 토큰
문제/이벤트 응답당 200-1000개 토큰; 큰 스택트레이스는 5k에 도달할 수 있습니다
금액
무료 티어: 월 5k 오류. 유료 요금제는 API 사용량이 아닌 이벤트 볼륨에 따라 청구됩니다.
팁
API는 무료입니다. 실제로 비용을 지불하는 것은 이벤트 수집입니다. Sentry 자체의 샘플링 규칙을 사용하여 수집 비용을 예측 가능하게 유지합니다.

보안

권한, 시크릿, 파급범위

최소 스코프: org:read project:read event:read
자격 증명 저장: 환경 변수 SENTRY_AUTH_TOKEN에서 Sentry 사용자 인증 토큰
데이터 외부 송신: Sentry 인스턴스(sentry.io 또는 자체 호스팅)에 대한 모든 호출
절대 부여 금지: org:write project:admin member:write

문제 해결

자주 발생하는 오류와 해결

401 Invalid token

토큰이 만료되었거나 요청된 권한이 없습니다. sentry.io/settings/account/api/auth-tokens/에서 다시 생성하세요

확인: curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" https://sentry.io/api/0/organizations/
404 Project not found

프로젝트 슬러그는 대소문자를 구분하며 URL과 정확히 일치해야 합니다. sentry.io/settings/projects/을 확인하세요

Empty stacktrace

소스맵이 업로드되지 않았습니다. 빌드 파이프라인의 일부로 sentry-cli sourcemaps upload를 실행하세요.

대안

Sentry 다른 것과 비교

대안언제 쓰나단점/장점
Datadog APM MCP이미 Datadog을 사용 중이고 통합 APM + 오류를 원하는 경우더 비싸고 오류에 덜 집중합니다
Rollbar / Bugsnag MCP이미 이들을 위해 비용을 지불하는 경우더 작은 커뮤니티 구축 MCP 생태계

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기