Claude Code MCP 설정법 2026 — 외부 도구 연결의 표준이 된 프로토콜

터미널에서 Claude Code를 쓰다가 GitHub 이슈를 확인하려면 브라우저를 열어야 했다. 웹 검색 결과를 붙여넣으려면 탭을 전환해야 했다. 이 복사-붙여넣기 루프가 하루에 수십 번 반복됐다. MCP를 설정하고 나서 이 루프가 사라졌다. 설정에 5분, 매일 절약하는 시간은 30분 이상이다.

MCP(Model Context Protocol)란, AI 에이전트를 외부 도구와 데이터에 연결하는 개방형 표준 프로토콜이다. Anthropic이 제안했고, 2026년 현재 200개 이상의 서버가 생태계를 형성하고 있다. Claude Code 입장에서 보면 플러그인 시스템이다. JSON 설정 파일 하나로 새로운 도구가 추가된다. 코드를 한 줄도 쓸 필요가 없다.

왜 MCP가 필요했는가

Claude Code는 강력한 코딩 에이전트지만, 기본 상태에서는 로컬 파일 시스템 바깥의 세계를 모른다. GitHub 이슈 목록을 가져올 수 없고, 웹을 검색할 수 없고, 브라우저를 열어서 UI를 테스트할 수도 없다. 이전에는 내가 중간 다리 역할을 했다. "이 이슈 내용이 뭐야?" 하고 물으면 직접 브라우저에서 복사해서 붙여넣었다. 한두 번이면 괜찮다. 하지만 프로젝트 규모가 커지면 이런 컨텍스트 스위칭이 하루에 40~50번 발생한다.

MCP 이전과 이후를 비교하면 차이가 명확하다. 이전에는 Claude Code가 "이 PR의 리뷰 코멘트를 확인해줘"라는 요청을 받으면 "저는 GitHub에 접근할 수 없습니다"라고 답했다. 이후에는 GitHub MCP 서버를 통해 직접 PR 코멘트를 조회하고, 코드를 분석하고, 리뷰를 작성한다. 수동으로 중계하던 시간이 0이 됐다.

Anthropic의 MCP 공식 문서에 따르면, MCP는 USB-C 같은 존재다. 기기마다 다른 충전기를 쓰던 시절이 USB-C 하나로 통일된 것처럼, AI 도구 연결도 MCP 하나로 표준화하겠다는 구상이다. MCP 스펙은 오픈 표준으로 공개되어 있어서 누구나 서버를 만들 수 있다.

설정은 어떻게 하는가

Claude Code MCP 설정 방법은 크게 두 가지다. CLI 명령어로 한 줄에 추가하는 방법과, JSON 설정 파일에 직접 쓰는 방법이 있다.

CLI 방식이 가장 빠르다. 터미널에서 이렇게 입력하면 된다.

claude mcp add github -- npx -y @modelcontextprotocol/server-github \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN

이 한 줄이면 GitHub MCP 서버가 추가된다. Claude Code를 재시작하면 GitHub 관련 도구 20여 개가 자동으로 로드된다. 이슈 조회, PR 생성, 코드 검색, 리뷰 작성까지 전부 Claude Code 안에서 가능해진다.

설정 파일 방식은 프로젝트 루트에 .mcp.json을 만드는 것이다. 팀 전체가 같은 MCP 설정을 공유하고 싶을 때 유용하다. git에 커밋하면 팀원 모두 같은 도구 세트를 쓸 수 있다. 반면, 개인 설정은 ~/.claude/.mcp.json에 넣는다. API 키처럼 공유하면 안 되는 설정은 여기에 둔다.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

MCP 서버의 전송 방식(Transport)은 세 가지다. stdio는 로컬에서 프로세스를 실행하는 방식으로 가장 흔하다. SSE(Server-Sent Events)는 원격 서버에 연결할 때 쓴다. 그리고 2026년 들어 HTTP Streamable이 새로운 표준으로 자리잡고 있다. 대부분의 경우 stdio로 충분하다.

내가 쓰는 필수 MCP 3종 세트

200개 넘는 MCP 서버 중에서 내가 매일 쓰는 건 세 개다. GitHub, Brave Search, Playwright. 이 세 개면 웬만한 개발 워크플로우를 커버한다.

GitHub MCP는 위에서 설명한 대로다. 이슈와 PR을 Claude Code 안에서 직접 다룬다. Brave Search MCP는 웹 검색을 가능하게 한다. "이 에러 메시지가 뭔지 찾아봐"라고 하면 Claude Code가 직접 검색해서 답을 준다. 이전에는 내가 구글에 검색하고 결과를 복사해줬다. Playwright MCP는 브라우저 자동화다. 배포 후 "랜딩 페이지 열어서 스크린샷 찍어봐"라고 하면 실제로 브라우저를 열어서 확인한다. E2E 테스트 시나리오를 Claude Code가 직접 실행할 수 있게 된다.

여기서 한 가지 중요한 기능이 Tool Search다. Claude Code MCP 도구가 많아질수록 매 대화마다 모든 도구 설명을 컨텍스트에 로드하면 토큰 낭비가 심해진다. Tool Search는 lazy loading 방식으로 필요한 도구만 로드한다. Anthropic에 따르면 이 기능 하나로 컨텍스트 사용량이 최대 95%까지 줄어든다. 또한 서브에이전트를 띄울 때도 메인 대화의 MCP 도구를 모두 상속받는다. 별도 설정이 필요 없다.

시사점

MCP는 단순히 Claude Code에 기능을 추가하는 것을 넘어서, AI 에이전트가 도구를 사용하는 방식의 표준이 되고 있다. 이전에는 각 AI 도구가 자체 플러그인 시스템을 만들었다. ChatGPT 플러그인, Cursor 확장, Copilot 어댑터가 모두 다른 규격이었다. MCP는 이 파편화를 하나의 프로토콜로 통합한다.

1인 개발자 입장에서 Claude Code MCP의 가장 큰 가치는 "인간이 중계자 역할을 그만둘 수 있다"는 것이다. AI가 직접 도구를 호출하고, 결과를 해석하고, 다음 행동을 결정한다. 내가 할 일은 설정 파일 하나 만들어두는 것뿐이다.

이 글은 Claude Code 파워 유저 가이드 시리즈의 첫 번째 편이다. 다음 편에서는 Hooks(자동화 트리거)를, 세 번째 편에서는 Agent(에이전트 시스템)를 다룬다. Claude Code의 Channels 기능과 함께 쓰면 MCP 도구를 Slack이나 Telegram에서도 활용할 수 있다.

참고 자료

• Claude Code MCP 공식 문서 - Anthropic
• MCP 프로토콜 스펙 - Model Context Protocol
• GitHub MCP 서버 - GitHub

---

가장 좋은 도구는 존재를 느끼지 못하는 도구다. MCP가 정확히 그렇다.

---

매일 아침 AI 뉴스를 이메일로 받아보세요. spoonai.me 뉴스레터 구독