# 이슈·PR·에러 기록을 터미널 대화에서 바로 다루기 (Claude Code MCP 연결)
id: claude-code-mcp-connect · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-mcp-connect
기준일: 2026-11-15 (여기서 고친 날)
도구: Claude Code, GitHub, Sentry
평가 점수: 32/100 (확인 없음 · 검수 대기)

GitHub·Sentry 화면을 오가지 않고 터미널 대화에서 PR 검토, 이슈 만들기, 에러 확인까지 처리할 수 있습니다.

설명: 연결 범위를 정한 뒤 claude mcp add로 Sentry·GitHub 같은 서버를 추가하고, /mcp에서 인증과 연결 상태를 확인합니다. 그다음부터는 평소 말로 요청하면 Claude가 연결한 도구를 써서 처리합니다.

준비물: Claude Code 설치 · 연결할 서비스 계정 (GitHub는 개인 액세스 토큰, Sentry는 브라우저 로그인)

본문:

## 준비

- Claude Code 설치
- 연결할 서비스 계정 (GitHub는 개인 액세스 토큰, Sentry는 브라우저 로그인)

### 1. 연결 범위 선택

`--scope`를 생략하면 local(이 프로젝트에서 나만, `~/.claude.json`)입니다. 팀과 함께 쓰려면 project(프로젝트 루트의 `.mcp.json`), 내 모든 프로젝트에서 쓰려면 user를 고릅니다.

### 2. Sentry 서버 추가 (OAuth 방식)

원격 서버는 HTTP 전송을 권장합니다. 기본 형식은 `claude mcp add --transport http <name> <url>`입니다.

```bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```

`claude mcp get sentry`로 설정을 확인합니다.

### 3. GitHub 서버 추가 (토큰 헤더 방식)

`YOUR_GITHUB_PAT` 자리에 내 토큰을 직접 넣어 터미널에서 실행합니다. 토큰은 대화에 붙여 넣지 않습니다. 이 명령은 자격 증명을 검사하지 않고 저장만 합니다.

```bash
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`를 씁니다.

```bash
/mcp
```

`/mcp`에서 실패로 나오면 토큰이나 로그인을 다시 확인합니다.

### 5. 평소 말로 도구 사용

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

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

주의:
- 외부 내용을 가져오는 서버는 프롬프트 인젝션 위험 · 믿을 수 있는 서버만 연결
- 같은 서버가 여러 범위에 있으면 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로 넘어가지 않고 연결 실패로 표시

출처:
- Connect Claude Code to tools via MCP https://code.claude.com/docs/en/mcp