이슈·PR·에러 기록을 터미널 대화에서 바로 다루기 (Claude Code MCP 연결)
GitHub·Sentry 화면을 오가지 않고 터미널 대화에서 PR 검토, 이슈 만들기, 에러 확인까지 처리할 수 있습니다.
연결 범위를 정한 뒤 claude mcp add로 Sentry·GitHub 같은 서버를 추가하고, /mcp에서 인증과 연결 상태를 확인합니다. 그다음부터는 평소 말로 요청하면 Claude가 연결한 도구를 써서 처리합니다.
준비
- Claude Code 설치
- 연결할 서비스 계정 (GitHub는 개인 액세스 토큰, Sentry는 브라우저 로그인)
1. 연결 범위 선택
--scope를 생략하면 local(이 프로젝트에서 나만, ~/.claude.json)입니다. 팀과 함께 쓰려면 project(프로젝트 루트의 .mcp.json), 내 모든 프로젝트에서 쓰려면 user를 고릅니다.
2. Sentry 서버 추가 (OAuth 방식)
원격 서버는 HTTP 전송을 권장합니다. 기본 형식은 claude mcp add --transport http <name> <url>입니다.
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpclaude mcp get sentry로 설정을 확인합니다.
3. GitHub 서버 추가 (토큰 헤더 방식)
YOUR_GITHUB_PAT 자리에 내 토큰을 직접 넣어 터미널에서 실행합니다. 토큰은 대화에 붙여 넣지 않습니다. 이 명령은 자격 증명을 검사하지 않고 저장만 합니다.
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"claude mcp list 목록에 github가 보이면 등록된 것입니다.
4. 연결 상태 확인과 인증
Claude Code 안에서 /mcp를 입력합니다. 인증이 필요한 서버는 브라우저에서 로그인을 마칩니다. 셸에서는 claude mcp login sentry를 씁니다.
/mcp/mcp에서 실패로 나오면 토큰이나 로그인을 다시 확인합니다.
5. 평소 말로 도구 사용
연결된 뒤에는 서버 이름을 몰라도 하려는 일을 그대로 요청하면 됩니다.
나에게 지정된 열린 PR을 모두 보여 줘응답에 MCP 도구 호출이 표시되면 됩니다.
주의
- 외부 내용을 가져오는 서버는 프롬프트 인젝션 위험이 있습니다. 믿을 수 있는 서버만 연결합니다.
- 같은 서버가 여러 범위에 있으면 local → project → user 순으로 한 곳의 설정만 쓰고, 필드를 합치지 않습니다.
- project 범위(
.mcp.json) 서버는 대화형 세션에서 쓰기 전에 승인을 요청합니다. 선택을 초기화하려면claude mcp reset-project-choices를 실행합니다. - 도구 출력이 10,000 토큰을 넘으면 경고가 나오고, 기본 한도는 25,000 토큰입니다. 늘리려면
MAX_MCP_OUTPUT_TOKENS환경 변수를 씁니다. claude mcp remove는 저장된 OAuth 토큰만 지우고 철회하지는 않습니다. 철회하려면 먼저claude mcp logout <name>을 실행합니다.- 헤더로 직접 넣은 토큰이 거부되면 OAuth로 넘어가지 않고 연결 실패로 표시됩니다.
댓글