Sentry MCP

Name: Sentry MCP MCP Server
Author: getsentry

왜 쓰나요

핵심 기능

Sentry 쿼리 구문으로 이슈 검색
전체 이벤트 페이로드 조회: 스택 추적, 브레드크럼, 요청, 태그
릴리스 건전성: 회귀 감지, 채택률, 크래시 없는 비율
span 분석이 있는 성능 추적
크로스 프로젝트 쿼리를 위한 프로젝트 + 팀 메타데이터

라이브 데모

실제 사용 모습

sentry-mcp-getsentry.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

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

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

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

사용 사례

실전 활용법: Sentry MCP

Claude를 떠나지 않고 프로덕션 에러를 처음부터 끝까지 디버그

👤 온콜 알림을 처리하는 개발자 ⏱ ~20 min intermediate

언제 쓸까: Sentry 알림이 뜨고 지금 당장 근본 원인이 필요할 때.

사전 조건

Sentry 인증 token — User Settings → Auth Tokens → 'project:read', 'event:read', 'org:read' 권한으로 생성
환경 변수에 token 설정 — SENTRY_AUTH_TOKEN과 SENTRY_HOST 설정 (sentry.io 또는 자체 호스팅)

흐름

이슈 찾기

Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ 복사됨

→ 이슈 ID + 발생 수 + 처음/마지막 발생 시각
전체 컨텍스트 조회

Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ 복사됨

→ 프레임과 사용자 행동 추적이 있는 전체 이벤트 페이로드
배포와 연결

What release was running when this first appeared? List the commits in that release.✓ 복사됨

→ 릴리스 태그 + 커밋 목록
수정안 제안

Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ 복사됨

→ 특정 파일 + 라인 참조; 구체적인 패치

결과: 완전한 증거 체계와 함께 알림에서 후보 수정안까지 몇 분 만에.

함정

소스 맵 없음 — 스택 프레임이 도움 안 됨 — Sentry 릴리스에서 소스 맵 업로드 확인; 없으면 축소된 프레임은 Claude에게 아무 정보도 없음

함께 쓰기: github

릴리스 프로모션 전 사전 점검

👤 릴리스 엔지니어, 배포 게이트키퍼 ⏱ ~15 min intermediate

언제 쓸까: 카나리 릴리스를 100%로 프로모션하려고 할 때.

흐름

릴리스 건전성 비교

Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ 복사됨

→ 릴리스별 크래시 없는 비율 %, 채택률, 회귀 수
새 에러 확인

List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ 복사됨

→ 수와 함께 새 이슈 목록
권고

Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ 복사됨

→ 임계값이 명시된 명확한 권고

결과: 감으로 판단하지 않는 데이터 기반 프로모션/중단 결정.

함정

채택률이 너무 낮아 통계적으로 유의미하지 않음 — Claude가 낮은 채택률 기간을 불확실로 표시해야 함 — 확실한 척 하지 않도록

트랜잭션 추적으로 성능 회귀 조사

👤 지연시간을 추적하는 백엔드 엔지니어 ⏱ ~25 min advanced

언제 쓸까: 마지막 배포 후 /checkout의 p95 지연시간이 급증했을 때.

흐름

최근 느린 추적 조회

Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ 복사됨

→ span 분석이 있는 추적
새 span 찾기

Compare span list to a similar trace from last week. Which spans are new or longer?✓ 복사됨

→ 차이점: 새 DB 쿼리 'SELECT cart_items', 평균 1.4s
코드와 연결

What commit added that query? Suggest an index or a query rewrite.✓ 복사됨

→ 커밋 + 구체적인 수정 제안

결과: 성능 회귀 근본 원인 특정, 코드 수준의 수정 제안.

함정

추적 샘플링 비율이 너무 낮아 느린 추적이 잡히지 않음 — 임시로 샘플 비율 높이기, 또는 Claude에게 stats 엔드포인트 사용 요청

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

sentry-mcp-getsentry + github

Sentry 스택 프레임에서 바로 PR 초안까지

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ 복사됨

sentry-mcp-getsentry + linear

회귀로부터 엔지니어링 티켓 자동 생성

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
search_issues	project, query, statsPeriod?	Sentry 쿼리로 이슈 필터링	1 Sentry API call
get_issue	issue_id	특정 이슈 개요 확인	1 API call
get_event	event_id or 'latest'	전체 컨텍스트가 있는 특정 발생 조회	1 API call
list_releases	project, version?	릴리스 간 비교	1 API call
get_trace	trace_id	성능 조사	1 API call

비용 및 제한

운영 비용

API 쿼터: 표준 Sentry API 속도 제한 — 급격한 요청은 429 반환 가능
호출당 토큰: 이벤트 페이로드는 5–20k token 가능 — 선택적으로 가져오기
금액: Sentry 개발자 플랜은 무료; 유료 플랜은 더 높은 속도 제한
팁: 먼저 search_issues로 범위 좁히기; 후보에만 get_event — 전체 결과 목록 아님

보안

권한, 시크릿, 파급범위

최소 스코프: project:read event:read org:read

자격 증명 저장: SENTRY_AUTH_TOKEN 환경 변수 (범위가 제한된 프로젝트 바인딩 token 사용)

데이터 외부 송신: Sentry 호스트로의 모든 호출 (sentry.io 또는 자체 호스팅)

절대 부여 금지: 채팅 기반 에이전트에 project:write 또는 org:write 금지

이벤트 데이터에 PII가 포함될 수 있음 (요청 본문, 사용자 ID) — 업스트림에서 Sentry의 데이터 스크러빙 규칙 적용

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

token이 만료됐거나 scope가 잘못됨 — 나열된 읽기 scope로 재생성

확인: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

스택 추적이 축소된 프레임만 표시

릴리스 파이프라인에서 소스 맵 업로드 확인; 맵 없이는 Claude가 프레임을 분석할 수 없음

확인: Sentry UI → Release → Artifacts

알려진 이슈에서 404

이슈가 token이 커버하지 않는 프로젝트에 있음 — 해당 프로젝트로 token 재범위 지정

자체 호스팅 Sentry — 연결 거부

SENTRY_HOST를 프로토콜이 포함된 인스턴스 URL로 명시적 설정

확인: curl $SENTRY_HOST/api/0/

대안

Sentry MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Datadog MCP	팀이 Datadog APM/에러 추적을 사용할 때	커버리지가 다름; APM 우선, 이슈 중심성 낮음
Honeycomb MCP	스택 추적이 아닌 이벤트를 사용하는 observability 우선 팀	1등급 이슈 그룹화 없음; 추적 중심