{"id":"claude-code-mcp-connect","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/claude-code-mcp-connect","title":"이슈·PR·에러 기록을 터미널 대화에서 바로 다루기 (Claude Code MCP 연결)","summary":"GitHub·Sentry 화면을 오가지 않고 터미널 대화에서 PR 검토, 이슈 만들기, 에러 확인까지 처리할 수 있습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"},{"id":"integrate","label":"앱 연동·자동화"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code","GitHub","Sentry"],"whenToUse":"연결 범위를 정한 뒤 claude mcp add로 Sentry·GitHub 같은 서버를 추가하고, /mcp에서 인증과 연결 상태를 확인합니다. 그다음부터는 평소 말로 요청하면 Claude가 연결한 도구를 써서 처리합니다.","body":"## 준비\n\n- Claude Code 설치\n- 연결할 서비스 계정 (GitHub는 개인 액세스 토큰, Sentry는 브라우저 로그인)\n\n### 1. 연결 범위 선택\n\n`--scope`를 생략하면 local(이 프로젝트에서 나만, `~/.claude.json`)입니다. 팀과 함께 쓰려면 project(프로젝트 루트의 `.mcp.json`), 내 모든 프로젝트에서 쓰려면 user를 고릅니다.\n\n### 2. Sentry 서버 추가 (OAuth 방식)\n\n원격 서버는 HTTP 전송을 권장합니다. 기본 형식은 `claude mcp add --transport http <name> <url>`입니다.\n\n```bash\nclaude mcp add --transport http sentry https://mcp.sentry.dev/mcp\n```\n\n`claude mcp get sentry`로 설정을 확인합니다.\n\n### 3. GitHub 서버 추가 (토큰 헤더 방식)\n\n`YOUR_GITHUB_PAT` 자리에 내 토큰을 직접 넣어 터미널에서 실행합니다. 토큰은 대화에 붙여 넣지 않습니다. 이 명령은 자격 증명을 검사하지 않고 저장만 합니다.\n\n```bash\nclaude mcp add --transport http github https://api.githubcopilot.com/mcp/ \\\n  --header \"Authorization: Bearer YOUR_GITHUB_PAT\"\n```\n\n`claude mcp list` 목록에 github가 보이면 등록된 것입니다.\n\n### 4. 연결 상태 확인과 인증\n\nClaude Code 안에서 `/mcp`를 입력합니다. 인증이 필요한 서버는 브라우저에서 로그인을 마칩니다. 셸에서는 `claude mcp login sentry`를 씁니다.\n\n```bash\n/mcp\n```\n\n`/mcp`에서 실패로 나오면 토큰이나 로그인을 다시 확인합니다.\n\n### 5. 평소 말로 도구 사용\n\n연결된 뒤에는 서버 이름을 몰라도 하려는 일을 그대로 요청하면 됩니다.\n\n```prompt\n나에게 지정된 열린 PR을 모두 보여 줘\n```\n\n응답에 MCP 도구 호출이 표시되면 됩니다.\n\n## 주의\n\n- 외부 내용을 가져오는 서버는 프롬프트 인젝션 위험이 있습니다. 믿을 수 있는 서버만 연결합니다.\n- 같은 서버가 여러 범위에 있으면 local → project → user 순으로 한 곳의 설정만 쓰고, 필드를 합치지 않습니다.\n- project 범위(`.mcp.json`) 서버는 대화형 세션에서 쓰기 전에 승인을 요청합니다. 선택을 초기화하려면 `claude mcp reset-project-choices`를 실행합니다.\n- 도구 출력이 10,000 토큰을 넘으면 경고가 나오고, 기본 한도는 25,000 토큰입니다. 늘리려면 `MAX_MCP_OUTPUT_TOKENS` 환경 변수를 씁니다.\n- `claude mcp remove`는 저장된 OAuth 토큰만 지우고 철회하지는 않습니다. 철회하려면 먼저 `claude mcp logout <name>`을 실행합니다.\n- 헤더로 직접 넣은 토큰이 거부되면 OAuth로 넘어가지 않고 연결 실패로 표시됩니다.","prerequisites":["Claude Code 설치","연결할 서비스 계정 (GitHub는 개인 액세스 토큰, Sentry는 브라우저 로그인)"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"human","title":"연결 범위 선택","body":"--scope 생략 시 local(이 프로젝트, 나만, ~/.claude.json). project는 프로젝트 루트 .mcp.json으로 팀 공유, user는 내 모든 프로젝트","expected":"정해진 범위","check":"팀 공유가 필요한지 확인","tool":"Claude Code"},{"n":2,"kind":"command","title":"Sentry 서버 추가 (OAuth 방식)","body":"원격 서버는 HTTP 전송 권장. 기본 형식은 claude mcp add --transport http <name> <url>","prompt":"claude mcp add --transport http sentry https://mcp.sentry.dev/mcp","expected":"sentry 서버 설정","check":"claude mcp get sentry로 설정 내용 확인","tool":"Claude Code"},{"n":3,"kind":"command","title":"GitHub 서버 추가 (토큰 헤더 방식)","body":"YOUR_GITHUB_PAT 자리에 내 토큰을 직접 넣어 터미널에서 실행 · 토큰은 대화에 붙여 넣지 않음. 명령은 자격 증명을 검사하지 않고 저장만 함","prompt":"claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \\\n  --header \"Authorization: Bearer YOUR_GITHUB_PAT\"","expected":"github 서버 설정","check":"claude mcp list 목록에 github가 보이면 등록됨","tool":"Claude Code"},{"n":4,"kind":"command","title":"연결 상태 확인과 인증","body":"Claude Code 안에서 /mcp 입력. 인증이 필요한 서버는 브라우저에서 로그인 마무리. 셸에서는 claude mcp login sentry","prompt":"/mcp","expected":"연결된 서버 목록","check":"claude mcp list의 상태 표시 · /mcp에서 실패로 나오면 토큰이나 로그인 다시 확인","tool":"Claude Code"},{"n":5,"kind":"ai","title":"평소 말로 도구 사용","body":"연결된 뒤에는 서버 이름을 몰라도 하려는 일을 그대로 요청","prompt":"나에게 지정된 열린 PR을 모두 보여 줘","expected":"PR·이슈 정보를 바탕으로 한 답","check":"응답 중 MCP 도구 호출 표시 확인","tool":"Claude Code"}],"pitfalls":["외부 내용을 가져오는 서버는 프롬프트 인젝션 위험 · 믿을 수 있는 서버만 연결","같은 서버가 여러 범위에 있으면 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로 넘어가지 않고 연결 실패로 표시"],"sources":[{"title":"Connect Claude Code to tools via MCP","url":"https://code.claude.com/docs/en/mcp"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":23,"likes":0}