본문으로 건너뛰기

이슈·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/mcp

claude 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. 평소 말로 도구 사용

연결된 뒤에는 서버 이름을 몰라도 하려는 일을 그대로 요청하면 됩니다.

AI에게 보내기
나에게 지정된 열린 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로 넘어가지 않고 연결 실패로 표시됩니다.

업무 분야 · 필요한 기능

이 기능을 가진 도구