센트리-mcp

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

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

시작하기

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

https://mcp.sentry.dev

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

Stdio 대 Remote

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

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

지엑스피1

저장소를 복제하고 평소처럼 설정합니다.

pnpm install
pnpm build

운송을 시작하세요:

pnpm start:stdio --access-token=sentry-pat --host=sentry.example.com

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

SENTRY_AUTH_TOKEN=
SENTRY_HOST=

MCP 검사관

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

pnpm inspector

https://[domain].workers.dev/sse (TODO)를 입력하고 연결을 클릭하세요. 인증 절차를 거치면 도구가 작동하는 것을 볼 수 있습니다.

Claude Desktop에서 원격 MCP 서버에 액세스

Claude Desktop을 열고 설정으로 이동한 후, ⌘ + , (쉼표) -> 개발자 -> 구성 편집을 누릅니다. 그러면 Claude가 액세스할 수 있는 MCP 서버를 제어하는 구성 파일이 열립니다.

다음 구성으로 콘텐츠를 바꾸세요. Claude Desktop을 다시 시작하면 OAuth 로그인 페이지가 표시된 브라우저 창이 열립니다. 인증 흐름을 완료하여 Claude에게 MCP 서버 접근 권한을 부여하세요. 접근 권한을 부여하면 도구를 사용할 수 있게 됩니다.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

인터페이스에 도구(🔨 아래)가 표시되면 Claude에게 도구를 사용해 달라고 요청할 수 있습니다. 예: "수학 도구를 사용하여 23과 19를 더해 주시겠어요?" Claude는 도구를 호출하여 MCP 서버에서 생성된 결과를 표시합니다.

지역 개발

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

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

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

확인하다

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

pnpm dev

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

테스트

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

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

pnpm test

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

OPENAI_API_KEY=

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

pnpm test

노트

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

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

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

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

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

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

Sentry MCP

Integrations