---
name: opencurrent-code-mcp-connect
description: "GitHub·Sentry 화면을 오가지 않고 터미널 대화에서 PR 검토, 이슈 만들기, 에러 확인까지 처리할 수 있습니다. 이럴 때 사용: 연결 범위를 정한 뒤 claude mcp add로 Sentry·GitHub 같은 서버를 추가하고, /mcp에서 인증과 연결 상태를 확인합니다. 그다음부터는 평소 말로 요청하면 Claude가 연결한 도구를 써서 처리합니다. 도구: Claude Code, GitHub, Sentry."
metadata:
  source: "https://opencurrent.ai/w/claude-code-mcp-connect"
  opencurrent-id: "claude-code-mcp-connect"
  verification: "pending"
  exported-at: "2026-11-21T11:15:53.201Z"
---

# 이슈·PR·에러 기록을 터미널 대화에서 바로 다루기 (Claude Code MCP 연결)

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-mcp-connect
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-mcp-connect")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.
3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.
4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

연결 범위를 정한 뒤 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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-mcp-connect 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
