Claude Code MCP 실전: GitHub·CodeGraph·API 전체 아키텍처

MCP 트리플 연결이란

Claude Code MCP는 MCP 프로토콜로 GitHub(이슈·의도), CodeGraph(저장소 구조·영향 범위), API(환경·실제 데이터)를 Claude Code에 넣어 에이전트가 「무엇을 할지·어디를 바꿀지·맞는지」를 함께 보도록 합니다. 이를 트리플 연결이라 부릅니다.

이 페이지는 Cloud Mac AI Stack의 MCP 개요입니다. 큰 그림은 다이어그램 한 장, 명령과 문제 해결은 설치·아키텍처·CodeGraph 글에 있습니다. L2 이전 글: 병렬 메모리 스케줄링.

한 긴 글 대신 나눈 이유

독자마다 상황이 다릅니다. 지금 환경만 통과시키고 싶은 분, GitHub와 CodeGraph를 함께 쓰는 이유를 알고 싶은 분, token·권한을 줄이고 싶은 분. 설치 단계·설계·권한 체크리스트를 한 URL에 넣으면 설정을 복사하려는 사람은 긴 mcpServers 블록 사이를 왔다 갔다 하고, 먼저 지도만 보고 싶은 사람의 흐름은 끊깁니다.

그래서 작업별로 나눴습니다. 이 페이지에서 트리플 연결 역할을 한 그림으로 보고, 배선할 때는 설치 가이드, 팀에 설계를 설명할 때는 아키텍처 글을 여세요. 여기를 MCP의 문으로 쓰면 됩니다.

시리즈에서의 역할

MCP 트리플 연결의 목차 페이지로 보시면 됩니다. 조각이 어떻게 맞는지 본 뒤 해당 주제로 들어갑니다. 설치 대행이나 CodeGraph·Runner 전용 가이드를 대신하지는 않습니다.

이 페이지에서 다루지 않습니다:

• Claude Code MCP 단계별 설치(복사·붙여넣기 명령 목록 없음)
• 긴 아키텍처 유도와 Context Engineering 이론
• CodeGraph 단독 배포·운영(CodeGraph 5분 참고)

이 페이지가 하는 일: 목표나 증상에 맞는 다음 글(설치·아키텍처·그래프·Runner·실행 환경·권한)을 가리키기.

여기 말고: 읽을 글

왼쪽 열의 내용이 필요하면 「읽기」로 주제 글을 여세요. 개요에서 단계를 찾지 마세요.

빠른 안내: 다음에 읽을 글

목표에 맞는 주제를 하나 고르세요. 아래에 상황·증상별 표가 더 있습니다.

push 후 CI를 녹색으로 맞추려면? GitHub Runner 가이드. 뚜껑 닫으면 MCP가 끊기거나 인덱스가 낡나요? Cloud Mac vs 로컬 Mac

무엇을 하려 하시나요?

검색어는 달라도 목적은 보통 네 가지입니다. 맞는 쪽을 고르면 시간을 아낍니다.

① 환경부터 통과시키기

예: Claude Code MCP setup · install MCP server · configure GitHub MCP · connect Claude Code to GitHub

목표: 도구 체인을 돌리고 Claude Code에서 mcp__* 도구가 보이게 하기.
추천 설치 가이드

② 전체 설계 이해

예: MCP architecture explained · Context Diff Fact · why MCP needed

목표: 계층을 이해하고 팀과 맞추기.
추천 아키텍처 글

③ 저장소 그래프 / 영향 분석만

예: CodeGraph MCP · codegraph_impact · repo graph Claude Code

목표: 그래프 먼저, GitHub 이슈 흐름은 나중에.
추천 CodeGraph 5분; 트리플 연결 전체는 나중에 설치 가이드

④ 권한과 안전

예: MCP permissions · token scope · read-only API MCP

목표: token 범위·쓰기 도구 분리·staging 읽기 전용.
추천 권한 가이드; 최소 연결부터 하려면 설치 가이드 후 권한을 조이세요

아직 모르겠다면 빠른 안내 또는 아래 증상 대조표를 쓰세요.

흔한 상황에서 시작

같은 트리플 연결이라도 입구는 다릅니다. 가까운 줄을 고르세요.

• MCP가 처음: 이 다이어그램 훑기 → 설치 가이드
• CodeGraph는 됐고 GitHub만 → 설치 가이드 GitHub 절; 그래프는 CodeGraph 5분
• CI: push 후 녹색 체크 → GitHub Runner 가이드; MCP와 Runner 차이 → 아키텍처 글
• token·환경 변수·읽기 전용 API 조이기 → 권한 가이드; 임시는 설치 가이드 최소 연결
• 설치했는데 도구가 없거나 불안정 → 설치 가이드 · 문제 해결
• 아직 설치 없이 설계만 → 아키텍처 글

문제가 있나요? 증상으로 고르기

증상별로 먼저 열 글을 안내합니다. 원인과 명령은 주제 글에 있습니다.

흔한 읽기 경로 3가지

MCP 첫 접촉

Claude Code 열기 → 이 개요(트리플 연결) → 설치 가이드로 mcpServers 맞추고 채팅에서 도구 확인 → push 후 검사는 GitHub Runner 가이드.

그래프는 됐고 GitHub만

CodeGraph 5분 완료 → 여기서 GitHub 위치 확인 → 설치 가이드에서 GitHub MCP만 → 경계는 아키텍처 글.

팀 AI 보조 CI 도입

이 개요 → 설치 가이드(트리플) → Runner 가이드(자동 검사) → 아키텍처 글(팀 정렬) → 권한 가이드로 token 조이기.

한 장으로 역할 파악

GitHub      = intent
CodeGraph   = context
API         = truth
Claude Code = diff
Runner      = fact

자주 묻는 질문

MCP 트리플 연결의 시작점으로 북마크하세요. 영어 슬러그: claude-code-mcp-github-files-api-chain.