Sentry MCP — Sentry가 쌓아 둔 에러·성능 데이터를 Claude Code 같은 AI 코딩 도구와 연결해 주는 서버입니다. 여기서 MCP(Model Context Protocol)는 AI 도구가 외부 서비스와 표준화된 방식으로 대화하도록 정한 규약 — 쉬운 풀이: AI가 여러 서비스를 각기 다른 방법으로 배울 필요 없이 같은 방식으로 다루게 해 주는 공통 연결 규격입니다. 이 글은 Claude Code에 Sentry MCP 서버를 연결해서, 이슈를 조회하고 스택 트레이스를 읽고 원인을 분석하는 과정을 터미널 밖으로 나가지 않고 이어가는 방법을 순서대로 안내합니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
이 글로 할 수 있게 되는 것
이 글을 따라 하면 Claude Code 터미널 안에서 Sentry 이슈 목록 조회, 스택 트레이스(에러가 나기까지 코드가 호출된 경로 기록) 확인, 원인 분석까지 화면 전환 없이 처리할 수 있게 됩니다. Sentry 계정에 이미 로그인되어 있고 해당 조직의 멤버라면 예상 소요 시간은 약 10~15분입니다.
시작 전 준비물
- Sentry 계정과 연결하려는 조직의 멤버 권한(관리자일 필요는 없지만, 조직에 소속되어 있어야 합니다)
- Claude Code CLI 설치 및 로그인이 끝난 상태
- 터미널을 쓸 수 있는 macOS·Linux·Windows(WSL) 환경
- 브라우저에서 OAuth 인증 화면을 열 수 있는 환경(팝업 차단이 꺼져 있으면 좋습니다)
- 자체 호스팅(온프레미스) Sentry를 쓴다면 아래 "로컬·자체 호스팅 환경" 항목을 별도로 참고하세요
용어 빠른 풀이
| 용어 | 쉬운 풀이 |
|---|---|
| MCP (Model Context Protocol) | AI 도구가 외부 서비스와 표준화된 방식으로 대화하도록 정한 연결 규약 |
| OAuth | 비밀번호를 직접 넘기지 않고 "로그인 후 권한 승인" 절차만으로 인증하는 방식 |
| 트랜스포트(transport) | MCP 서버와 실제로 데이터를 주고받는 통신 방식(이 글에서는 HTTP) |
| 토큰(token) / 스코프(scope) | API 접근을 허용하는 열쇠(토큰)와 그 열쇠로 할 수 있는 일의 범위(스코프) |
| 스택 트레이스(stack trace) | 에러가 발생하기까지 코드가 호출된 순서를 남긴 기록 |
| DSN | Sentry가 각 프로젝트를 식별하는 고유 주소값 |
| Seer | Sentry가 제공하는 AI 기반 원인 분석 기능 |
단계별 설정
Sentry.io 클라우드를 쓰고 있다면 별도 설치 없이 원격(OAuth) 방식으로 바로 연결할 수 있습니다. 아래 순서대로 진행하세요.
- 터미널에서 서버 등록 명령 실행. 아래 명령을 그대로 입력합니다.
성공 신호: "등록되었습니다" 계열의 안내 메시지가 뜨고, 에러 없이 프롬프트로 돌아옵니다.claude mcp add --transport http sentry https://mcp.sentry.dev/mcp - Claude Code 실행 후 /mcp 명령 입력. 터미널에서
claude로 Claude Code를 연 뒤/mcp를 입력합니다. 방금 등록한 sentry 서버가 목록에 뜨고, 인증이 필요하다는 안내가 함께 나타납니다. - 브라우저에서 Sentry 로그인 및 권한 승인. 자동으로 열리는 브라우저 창에서 Sentry 계정으로 로그인하고, 연결하려는 조직을 선택한 뒤 권한 승인(Authorize) 버튼을 누릅니다. 정확한 버튼 명칭은 화면에서 확인하세요.
- 연결 확인. Claude Code로 돌아와
/mcp화면에서 sentry 서버 상태가 연결됨으로 표시되면 성공입니다. 이어서 "Sentry에서 최근 이슈 목록 보여줘"처럼 자연어로 요청해 실제 응답이 오는지 확인하세요.
어떤 도구를 쓸 수 있나요
Sentry MCP 서버는 이슈 조회·검색, 이벤트·스택 트레이스 상세 확인, 프로젝트·팀 관리, Sentry 문서 검색까지 아우르는 여러 도구를 제공합니다. 정확한 도구 개수와 이름은 서비스 업데이트에 따라 바뀔 수 있으므로, 가장 정확한 확인 방법은 연결 후 Claude에게 "Sentry MCP로 뭘 할 수 있어?"라고 물어보거나 /mcp 화면에서 직접 목록을 보는 것입니다.
- 자연어 검색을 포함한 이슈 조회·검색
- 특정 이슈의 이벤트·스택 트레이스 상세 조회
- Seer를 이용한 AI 기반 원인 분석 실행
- 프로젝트·팀·DSN 관리(쓰기 권한이 있는 경우)
- Sentry 공식 문서 검색
로컬·자체 호스팅 환경에서 연결하기
자체 호스팅(온프레미스) Sentry를 쓴다면 원격 URL 대신 로컬 실행 방식을 씁니다. 아래 명령으로 로컬 MCP 서버를 실행하고, 자체 호스팅 인스턴스 주소를 별도 옵션으로 지정합니다.
npx @sentry/mcp-server자체 호스팅 인스턴스를 가리키려면 --host 옵션을, HTTPS 인증서가 없는 개발 환경이라면 --insecure-http 옵션을 추가로 씁니다. 정확한 플래그 표기와 값은 실행 시 도움말(--help)이나 공식 문서에서 재확인하세요. 이 방식은 Sentry 조직 설정에서 직접 발급한 인증 토큰이 필요하며, 토큰에는 아래 스코프가 포함되어야 합니다.
| 스코프 | 허용되는 동작 |
|---|---|
| org:read | 조직 정보 읽기 |
| project:read | 프로젝트 정보·이슈 읽기 |
| project:write | 프로젝트 생성·설정 변경 |
| team:read | 팀 정보 읽기 |
| team:write | 팀 생성·구성원 관리 |
| event:write | 이슈 상태·담당자 등 이벤트 관련 변경 |
보안 — 조직 스코프와 토큰 권한 최소화
원격 OAuth 방식이 로컬에서 직접 발급한 토큰보다 다루기가 더 안전합니다. Sentry MCP 서버는 원격 방식에서 업스트림 토큰을 서버 쪽에 저장·검증·갱신하지 않는다고 밝히고 있어, 토큰 수명 관리 책임은 클라이언트(Claude Code) 쪽에 있습니다. 아래 원칙을 지키세요.
- 로컬·자체 호스팅 방식에서 토큰을 직접 발급할 때는 실제로 쓸 계획이 있는 스코프만 부여합니다. 조회만 할 예정이라면
event:write·project:write·team:write같은 쓰기 스코프는 빼는 것이 안전합니다. --scope project옵션으로 설정을.mcp.json에 저장해 팀과 공유하는 경우, 토큰 값을 파일에 직접 적지 말고 환경변수 참조 방식을 씁니다. 이 파일이 git 저장소에 커밋될 수 있다는 점을 항상 염두에 두세요.- 더 이상 쓰지 않는 토큰은 Sentry 쪽에서 폐기하고, 주기적으로 재발급하는 습관을 들입니다.
자주 막히는 지점과 해결
연결 과정에서 막히는 지점은 대부분 인증·권한 문제입니다. 아래 상황을 먼저 확인하세요.
- OAuth 로그인 창이 뜨지 않는 경우 — 브라우저 팝업 차단을 해제하고
/mcp를 다시 실행합니다. - "조직을 찾을 수 없음" 류의 에러 — 로그인한 Sentry 계정이 연결하려는 조직의 멤버인지 확인합니다. 다른 계정으로 로그인되어 있을 수 있습니다.
- 자체 호스팅 Sentry인데 원격 URL로 연결이 안 되는 경우 — 원격
mcp.sentry.dev주소는 Sentry.io 클라우드용입니다. 자체 호스팅이라면 위의 로컬 실행 방식을 대신 씁니다. - 도구 호출은 되는데 권한 오류가 나는 경우 — 토큰 또는 계정 권한(스코프)이 부족한 상태입니다. 필요한 스코프를 추가해 토큰을 다시 발급하세요.
응용 — 다음 단계
연결이 끝났다면 실제 디버깅 흐름에 녹여 보세요. 예를 들어 "어제 배포 이후 새로 생긴 에러 이슈를 찾아서, 관련 코드까지 같이 봐줘"처럼 요청하면 Claude Code가 Sentry MCP 도구로 이슈를 조회하고, 저장소 코드와 연결해 원인을 함께 살펴봅니다. GitHub MCP처럼 비슷한 이름의 도구를 제공하는 다른 MCP 서버를 함께 연결했다면, 도구 이름이 겹칠 수 있으니 /mcp 화면에서 서버별 도구 목록이 잘 구분되는지 한 번 확인해 두는 것이 좋습니다.
자주 묻는 질문
Q. Sentry MCP 서버를 쓰려면 별도로 설치해야 하나요?
아니요, Sentry.io 클라우드를 쓴다면 원격(OAuth) 방식은 Sentry가 호스팅하는 서버에 연결하는 방식이라 별도 설치가 필요 없습니다. claude mcp add 명령으로 등록하고 브라우저에서 OAuth 로그인만 하면 됩니다. 자체 호스팅 Sentry라면 npx @sentry/mcp-server로 로컬 서버를 실행하는 방식을 대신 씁니다.
Q. 로컬 방식과 원격 방식 중 뭘 써야 하나요?
Sentry.io 클라우드를 쓰고 있다면 원격 OAuth 방식이 설정이 간단하고 토큰 관리 부담도 적습니다. 자체 호스팅 Sentry 인스턴스를 운영 중이라면 로컬 실행 방식을 씁니다.
Q. 연결한 뒤 Claude Code에게 어떻게 이슈를 조회하라고 하면 되나요?
도구 이름을 몰라도 자연어로 요청하면 됩니다. "Sentry에서 지난 24시간 동안 발생한 에러 이슈 보여줘"처럼 말하면 Claude가 알맞은 Sentry MCP 도구를 골라 호출합니다.
Q. 토큰이나 인증 정보가 새어나갈 위험은 없나요?
원격 OAuth 모드에서는 Sentry MCP 서버가 업스트림 토큰을 저장·검증·갱신하지 않는다고 공식적으로 밝히고 있어 클라이언트 쪽에서 토큰 수명을 관리해야 합니다. 로컬 방식에서 직접 발급한 토큰은 스코프를 최소화하고, .mcp.json 같은 공유 파일에 평문으로 남기지 않아야 합니다.