Sentry MCP

센트리-mcp

이는 업스트림 Sentry API 공급자에 대한 미들웨어 역할을 하는 원격 MCP 서버의 프로토타입입니다.

이는 원격 MCP에 대한 Cloudflare의 작업을 기반으로 합니다.

시작하기

프로덕션에 배포된 서비스를 방문하면 알아야 할 모든 내용을 찾을 수 있습니다.

https://mcp.sentry.dev

기여하고 싶거나 작동 방식을 알아보고, 자체 호스팅 Sentry에서 실행하고 싶다면 아래로 계속 진행하세요.

Stdio 대 Remote

이 저장소는 MCP 서비스 역할에 중점을 두고 있지만, stdio 전송도 지원합니다. 이는 아직 진행 중이지만, 자체 호스팅 Sentry 설치 환경에서 MCP를 실행하는 가장 쉬운 방법입니다.

stdoio 전송을 사용하려면 Sentry에서 필요한 범위를 가진 개인 API 토큰(PAT)을 생성해야 합니다. 작성 시점을 기준으로 다음과 같습니다.

지엑스피1

운송을 시작하세요:

참고: 환경 변수를 사용할 수도 있습니다.

MCP 검사관

MCP에는 서비스를 쉽게 테스트할 수 있는 검사기가 포함되어 있습니다.

MCP 서버 URL( http://localhost:5173 )을 입력하고 연결을 클릭하세요. 그러면 인증 흐름이 시작됩니다.

참고: 127.0.0.1 에서 검사기에 액세스할 때 OAuth 흐름에 문제가 있는 경우 http://localhost:6274 방문하여 대신 localhost 사용해 보세요.

지역 개발

MCP 서버를 반복하고 테스트하려면 로컬 개발 환경에서 수행할 수 있습니다. 이를 위해서는 Sentry에서 다른 OAuth 앱을 생성해야 합니다(설정 => API => 애플리케이션 ).

• 홈페이지 URL에 http://localhost:8788 지정하세요.
• 승인된 리디렉션 URI의 경우 http://localhost:8788/callback 지정하세요.
• 클라이언트 ID를 기록하고 클라이언트 비밀번호를 생성하세요.
• 프로젝트 루트에 .dev.vars 파일을 다음과 같이 만듭니다.

확인하다

서버를 로컬로 실행하여 http://localhost:8788 에서 사용할 수 있도록 합니다.

로컬 서버를 테스트하려면 Inspector에 http://localhost:8788/sse 입력하고 연결을 클릭하세요. 안내에 따라 진행하면 "도구 목록"을 볼 수 있습니다.

테스트

두 가지 테스트 모음이 포함되어 있습니다. 기본 단위 테스트와 몇 가지 평가입니다.

단위 테스트는 다음을 사용하여 실행할 수 있습니다.

Evals에는 일부 구성이 포함된 .env 파일이 필요합니다.

완료되면 다음을 사용하여 실행할 수 있습니다.

노트

Claude 및 기타 MCP 클라이언트 사용

Claude를 사용하여 원격 MCP 서버에 연결할 때 오류 메시지가 표시될 수 있습니다. 이는 Claude Desktop이 아직 원격 MCP 서버를 지원하지 않아 가끔 혼동이 발생하기 때문입니다. MCP 서버가 연결되었는지 확인하려면 Claude 인터페이스 오른쪽 하단에 있는 🔨 아이콘에 마우스를 올려보세요. 사용 가능한 도구가 표시됩니다.

커서 및 기타 MCP 클라이언트 사용

Cursor를 MCP 서버에 연결하려면 Type : "명령"을 선택하고 Command 필드에서 명령 필드와 인수 필드를 하나로 결합합니다(예 npx mcp-remote@latest https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).

Cursor는 HTTP+SSE 서버를 지원하지만 인증은 지원하지 않으므로 여전히 mcp-remote 사용해야 합니다(그리고 HTTP 서버가 아닌 STDIO 서버를 사용해야 합니다).

Windsurf와 같은 다른 MCP 클라이언트에 MCP 서버를 연결하려면 클라이언트의 구성 파일을 열고 Claude 설정에 사용된 것과 동일한 JSON을 추가한 다음 MCP 클라이언트를 다시 시작하세요.