강의모드
← course overview
chapter 03lesson 3.4public

Claude Code 기본기 쌓기

MCP 핵심 파악하기

MCP 이해하기

얻어갈 것

  • MCP를 에이전트가 외부 도구와 데이터에 연결할 때 쓰는 표준 방식으로 이해합니다.
  • Skill과 MCP를 헷갈리지 않고 구분합니다.

자세한 명령과 옵션은 Claude Code MCP 문서를 보면 됩니다. 이 레슨에서는 처음 연결할 때 꼭 확인할 순서만 잡습니다.

MCP는 도구 연결 규격

  • MCP는 Model Context Protocol의 약자입니다.
  • 에이전트가 Google Calendar, GitHub, 데이터베이스, 브라우저 같은 외부 도구를 정해진 방식으로 쓰게 해줍니다.
  • 도구마다 사용법을 새로 익히기보다, 에이전트가 MCP 서버에서 제공하는 도구 목록을 호출한다고 보면 됩니다.
MCP는 에이전트가 외부 서비스를 직접 호출하는 통로입니다.

Skill과 MCP의 차이

  • Skill은 "어떻게 일할지"를 담은 작업 순서입니다.
  • MCP는 "무엇을 사용할지"를 제공하는 도구 연결입니다.
  • 실습에서는 MCP로 도구를 붙이고, Skill로 그 도구를 쓰는 방식을 정리해 보면 좋습니다.

어디에 쓰나

  • 생산성: Google Calendar, Gmail, Notion, Slack 같은 개인/팀 도구.
  • 개발: GitHub, Sentry, Linear 같은 코드와 이슈 관리 도구.
  • 데이터와 브라우저: Supabase, Neon, Postgres, Chrome처럼 실제 상태를 확인해야 하는 도구.

사용 전 점검 순서

  • 기본 리스트 확인: Claude Code 안에서 /mcp를 열어 이미 연결된 서버가 있는지 봅니다.
  • 설치: claude mcp add ...로 직접 추가하거나 Claude Code에 자연어로 요청합니다.
  • 스코프: local, project, user 중 어디에 붙일지 정합니다.
  • 인증: API 키, OAuth, 브라우저 로그인처럼 서버마다 필요한 인증 방식을 확인합니다.
  • 확인: claude mcp list로 등록 상태를 보거나 /mcp에서 실제 연결과 도구 수를 확인합니다.

스코프는 처음에 헷갈리기 쉽습니다.

  • local: 현재 프로젝트에서만 쓰지만 내 개인 설정에 저장됩니다. 실험용이나 개인 API 키에 좋습니다.
  • project: .mcp.json에 저장되어 팀과 공유됩니다. 대신 팀원이 승인해야 할 수 있습니다.
  • user: 내 모든 프로젝트에서 씁니다. 자주 쓰는 개인 도구에 맞습니다.

실습하기: Google Calendar 일정 확인하기

MCP 연결하기

Claude Code가 공식 지원하는 MCP 중 Google Calendar를 붙여 봅니다.

/mcp 화면에서 연결된 서버, 인증 상태, 쓸 수 있는 도구를 먼저 확인합니다.
  • /mcp를 열어 Google Calendar가 보이는지 확인합니다.
  • 인증이 필요하면 브라우저에서 로그인합니다.
  • 연결되면 아래 P1처럼 작은 읽기 작업부터 시켜 봅니다.
P1캘린더 읽기만 하기
Google Calendar에서 이번 주 일정을 표로 보여줘

MCP를 활용하는 Skill 만들기

MCP는 도구를 붙이는 것이고, 그 도구를 어떻게 쓸지는 Skill이 정한다고 했습니다. 이번에는 방금 붙인 Calendar MCP를 활용하는 Skill을 새로 하나 만들어 봅니다. "이번 주 일정을 읽고 미리 챙길 것까지 정리해주는" 흐름을 Skill로 굳혀두는 겁니다.

P2이번 주 준비 Skill 만들기
Google Calendar를 활용해서 "이번 주 준비" Skill을 새로 만들어줘.

이번 주 일정을 읽고, 이렇게 정리해주는 흐름이야.
- 회의마다 미리 챙길 것
- 이번 주에 처리할 일

실제 SKILL 파일 만들기 전에 초안부터 보여줘.

마무리

  • MCP는 에이전트가 외부 도구와 데이터에 연결될 때 쓰는 표준 방식입니다.
  • 다음 레슨에서는 매번 같은 설명을 반복하지 않도록, 프로젝트와 사용자 단위의 기억을 어떻게 남기는지 봅니다.