Sentry MCP Server

센트리 MCP 서버

Sentry와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP 서버는 Sentry API와 상호 작용하는 도구를 제공하여 AI 어시스턴트가 오류 데이터를 검색 및 분석하고, 프로젝트를 관리하고, 애플리케이션 성능을 모니터링할 수 있도록 지원합니다.

요구 사항

• Node.js(v14 이상)
• npm 또는 yarn
• API 액세스가 가능한 Sentry 계정
• 적절한 권한이 있는 Sentry 인증 토큰

설정

1. 종속성 설치:지엑스피1

IDE 내에서 이것을 사용

이 MCP는 Codeium Windsurf에서 작동하는 것으로 검증되었습니다.

커서는 현재 MCP 구현과 관련하여 문제가 있으며, 이 도구는 아직 완전히 작동하지 않습니다.

Claude와 함께 사용

Claude와 함께 이 MCP 서버를 사용하려면 Claude 설정에 다음 구성을 추가하세요.

• args 필드에 디렉토리 경로를 업데이트합니다.
• <YOUR_AUTH_TOKEN> Sentry 인증 토큰으로 바꾸세요.

사용 가능한 도구

프로젝트 목록

주어진 조직에서 접근 가능한 모든 Sentry 프로젝트를 나열합니다.

매개변수:

• organization_slug (문자열, 필수): 프로젝트를 나열할 조직의 슬러그
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

해결_짧은_아이디

짧은 ID를 사용하여 문제에 대한 세부 정보를 검색합니다.

매개변수:

• organization_slug (문자열, 필수): 문제가 속한 조직의 슬러그
• short_id (문자열, 필수): 해결할 문제의 짧은 ID(예: PROJECT-123)
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

get_sentry_event

문제에서 특정 Sentry 이벤트를 검색하고 분석합니다.

매개변수:

• issue_id_or_url (문자열, 필수): 전체 Sentry 문제 URL 또는 숫자 문제 ID
• event_id (문자열, 필수): 검색할 특정 이벤트 ID
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

프로젝트의 오류 이벤트 목록

특정 Sentry 프로젝트의 오류 이벤트를 나열합니다.

매개변수:

• organization_slug (문자열, 필수): 프로젝트가 속한 조직의 슬러그
• project_slug (문자열, 필수): 이벤트를 나열할 프로젝트의 슬러그
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

프로젝트 생성

Sentry에서 새 프로젝트를 만들고 클라이언트 키를 검색합니다.

매개변수:

• organization_slug (문자열, 필수): 프로젝트를 생성할 조직의 슬러그
• team_slug (문자열, 필수): 프로젝트를 할당할 팀의 슬러그
• name (문자열, 필수): 새 프로젝트의 이름
• platform (문자열, 선택 사항): 새 프로젝트의 플랫폼
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

프로젝트_문제_목록

특정 Sentry 프로젝트의 문제를 나열합니다.

매개변수:

• organization_slug (문자열, 필수): 프로젝트가 속한 조직의 슬러그
• project_slug (문자열, 필수): 문제를 나열할 프로젝트의 슬러그
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

이슈_이벤트_목록

특정 Sentry 문제에 대한 이벤트를 나열합니다.

매개변수:

• organization_slug (문자열, 필수): 문제가 속한 조직의 슬러그
• issue_id (문자열, 필수): 이벤트를 나열할 문제의 ID
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

get_sentry_issue

Sentry 문제를 검색하고 분석합니다.

매개변수:

• issue_id_or_url (문자열, 필수): 전체 Sentry 문제 URL 또는 숫자 문제 ID
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

목록_조직_재생

특정 Sentry 조직의 리플레이를 나열합니다.

매개변수:

• organization_slug (문자열, 필수): 리플레이를 나열할 조직의 슬러그
• project_ids (string[], 선택 사항): 리플레이를 필터링할 프로젝트 ID 목록
• environment (문자열, 선택 사항): 리플레이를 필터링할 환경
• stats_period (문자열, 선택 사항): 통계 기간(예: "24시간", "7일")
• start (문자열, 선택 사항): 리플레이 필터링 시작 날짜
• end (문자열, 선택 사항): 리플레이 필터링의 종료 날짜
• sort (문자열, 선택 사항): 리플레이를 정렬할 필드
• query (문자열, 선택 사항): 리플레이를 필터링하기 위한 검색 쿼리
• per_page (숫자, 선택 사항): 페이지당 리플레이 수
• cursor (문자열, 선택 사항): 페이지 매김을 위한 커서
• view (문자열, 선택 사항): 보기 유형, "요약" 또는 "상세" (기본값: "상세")
• format (문자열, 선택 사항): 출력 형식, "plain" 또는 "markdown"(기본값: "markdown")

서버 실행

입증

이 도구를 사용하려면 Sentry API에 접근하기 위한 적절한 권한이 있는 Sentry 인증 토큰이 필요합니다. Sentry 계정 설정의 "API 키"에서 토큰을 생성할 수 있습니다.

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 인증 토큰이 없습니다
• API 요청 실패
• 잘못된 매개변수
• 네트워크 오류

모든 오류는 디버깅을 위해 콘솔에 기록됩니다.