Day2 Supplement Mcp

Day 2 보충: MCP 딥다이브

이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.

---

STOP PROTOCOL — 절대 위반 금지

이 프로토콜은 이 스킬의 최우선 규칙이다.

아래 규칙을 위반하면 수업이 망가진다.

각 블록은 반드시 2턴에 걸쳐 진행한다

┌─ Phase A (첫 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 EXPLAIN 섹션을 읽는다    │
│ 2. 기능을 설명한다                                        │
│ 3. references/에서 해당 블록 파일의 EXECUTE 섹션을 읽는다    │
│ 4. "지금 직접 실행해보세요"라고 안내한다                     │
│ 5. ⛔ 여기서 반드시 STOP. 턴을 종료한다.                    │
│                                                          │
│ ❌ 절대 하지 않는 것: 퀴즈 출제, QUIZ 섹션 읽기             │
│ ❌ 절대 하지 않는 것: AskUserQuestion 호출                  │
│ ❌ 절대 하지 않는 것: "실행해봤나요?" 질문                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 사용자가 돌아와서 "했어", "완료", "다음" 등을 입력한다

┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다       │
│ 2. AskUserQuestion으로 퀴즈를 출제한다                     │
│ 3. 정답/오답 피드백을 준다                                 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다         │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터.                │
└──────────────────────────────────────────────────────────┘

핵심 금지 사항 (절대 위반 금지)

1. Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop 2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다 3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다 4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다

공식 문서 URL 출력 (절대 누락 금지)

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 > 공식 문서: URL을 반드시 그대로 출력한다.

📖 공식 문서: [URL]

• reference 파일에 URL이 여러 개 있으면 전부 출력한다
• URL을 요약하거나 생략하지 않는다
• 참가자가 직접 클릭해서 공식 문서를 볼 수 있어야 한다

Phase A 종료 시 필수 문구

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:

---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.

이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.

---

References 파일 맵

파일 경로는 이 SKILL.md 기준 상대경로다.

각 reference 파일은 ## EXPLAIN, ## EXECUTE, ## QUIZ 섹션으로 구성된다.

---

진행 규칙

• 한 번에 한 블록씩 진행한다
• "다음", "skip", 블록 번호/이름으로 이동한다
• BONUS 블록은 시간이 남을 때만 진행한다
• Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다
• Block 3 완료 후 전체 마무리 안내 (BONUS Block 4는 시간 여유 시 진행)

---

시작

스킬 시작 시 먼저 최신 커리큘럼을 설치한 뒤 블록을 선택한다.

Step 1: 최신 스킬 설치

아래 명령어를 출력하고 Bash로 실행한다:

npx skills add ai-native-camp/camp-1 --agent claude-code --yes

실행 결과를 간략히 안내한다 (예: "4개 스킬이 최신 버전으로 설치되었습니다").

Step 2: 블록 선택

아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.

AskUserQuestion({
  "questions": [{
    "question": "어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Block 0: MCP 개념", "description": "MCP가 뭔지, 왜 필요한지부터"},
      {"label": "Block 1: 서버 추가", "description": "바로 MCP 서버 연결 실습"},
      {"label": "Block 2: /mcp 탐색", "description": "이미 서버가 있어서 도구 확인부터"},
      {"label": "Block 3: 인기 서버", "description": "어떤 서버가 있는지 둘러보기"}
    ],
    "multiSelect": false
  }]
})

시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.

Block 0: MCP 개념 이해

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/mcp

📖 MCP 소개: https://modelcontextprotocol.io/introduction

```

EXPLAIN

MCP가 뭔가?

MCP = Model Context Protocol

AI 앱과 외부 도구를 연결하는 오픈 표준이다.

MCP가 없으면 vs 있으면

MCP 없이                              MCP로
┌──────────┐                         ┌──────────┐
│ Claude   │                         │ Claude   │
│ Code     │                         │ Code     │
└────┬─────┘                         └────┬─────┘
     │                                    │ MCP (표준 규격)
     │ ❌ 각각 다른 방식으로               │
     │    연결해야 함                 ┌────┴────┐
     │                               │ MCP     │
┌────┼──────┐                        │ Server  │
│    │      │                        └────┬────┘
▼    ▼      ▼                             │
Slack Notion Calendar             ┌───────┼───────┐
(각각 다른 API)                    ▼       ▼       ▼
                                 Slack  Notion  Calendar
                                 (전부 같은 방식)

3가지 핵심 요소

┌─────────────────────────────────┐
│         Host (Claude Code)      │
│                                 │
│  ┌─────────┐  ┌─────────┐      │
│  │ Client 1│  │ Client 2│      │
│  └────┬────┘  └────┬────┘      │
└───────┼────────────┼────────────┘
        │            │
   ┌────▼────┐  ┌────▼────┐
   │ Slack   │  │ Notion  │
   │ Server  │  │ Server  │
   └─────────┘  └─────────┘

MCP Server가 제공하는 3가지

가장 많이 쓰는 건 Tools다. "Slack 메시지 읽어줘"라고 하면 Claude가 MCP를 통해 Slack Server의 Tool을 호출한다.

EXECUTE

Claude Code에 아래를 입력해서 MCP 개념을 확인해보자:

1. 현재 연결된 MCP 서버 확인:

/mcp

/mcp를 입력하면 지금 내 Claude Code에 연결된 MCP 서버 목록이 나온다.

아직 아무것도 없어도 괜찮다. 다음 블록에서 추가한다.

2. MCP에 대해 Claude에게 물어보기:

MCP가 뭔지, 내가 쓸 수 있는 대표적인 MCP 서버 5개를 알려줘

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "MCP를 USB-C에 비유했습니다. MCP의 핵심 역할은?",
    "header": "Quiz 0",
    "options": [
      {"label": "AI와 외부 도구를 표준 규격으로 연결", "description": "USB-C처럼 하나의 표준으로 다양한 도구를 꽂는 것"},
      {"label": "Claude의 성능을 높이는 업그레이드", "description": "MCP는 성능이 아니라 연결의 문제를 해결"},
      {"label": "코드를 자동으로 작성해주는 도구", "description": "MCP는 외부 서비스 연결 프로토콜"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 피드백: "맞습니다! MCP = 표준 연결 규격. USB-C가 기기를 하나로 통일했듯, MCP는 AI와 외부 도구 연결을 하나로 통일합니다."

Block 1: MCP 서버 추가하기

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/mcp

```

EXPLAIN

MCP 서버를 추가하는 3가지 방법

MCP 서버는 어디서 실행되느냐에 따라 추가 방법이 다르다.

핵심 명령어: claude mcp add

claude mcp add --transport [방법] [이름] [주소]

이 명령어가 길어 보이지만, 한 단어씩 뜯어보면 간단하다:

즉, "클로드야, MCP 서버 하나 추가해줘. HTTP 방식으로, 이름은 notion이고, 주소는 이거야" 라는 말이다.

방법 1: HTTP (가장 추천)

# Notion에 연결
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Sentry에 연결
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

방법 2: stdio (내 컴퓨터에서 실행)

# 파일 시스템 접근 서버
claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/folder

-- 뒤에 오는 건 MCP 서버를 실행하는 명령어다.

서버 관리 명령어

저장 범위 (scope)

# 모든 프로젝트에서 쓸 서버 추가
claude mcp add --transport http --scope user notion https://mcp.notion.com/mcp

.mcp.json 파일이 뭔지 궁금할 수 있다. `claude mcp add` 명령어를 실행하면 Claude가 알아서 만들어주는 설정 파일이다. 직접 열어서 편집할 일은 거의 없다.

<details> <summary>🔍 (참고) .mcp.json 파일의 구조가 궁금하다면</summary>

project scope로 서버를 추가하면 프로젝트 폴더에 .mcp.json 파일이 생긴다. 내용은 이런 형태다:

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

이 파일을 git에 커밋하면 팀원도 같은 MCP 서버를 쓸 수 있다. 하지만 직접 편집할 필요는 없다. claude mcp add/remove 명령어가 이 파일을 자동으로 관리해준다.

</details>

EXECUTE

실제로 MCP 서버를 하나 추가해보자. 아래 중 하나를 선택해서 실행한다:

옵션 A: Context7 (프로그래밍 문서 검색 — 추천)

claude mcp add --transport stdio context7 -- npx -y @upstash/context7-mcp@latest

Context7은 라이브러리 공식 문서를 실시간으로 검색해주는 MCP 서버다.

옵션 B: Notion (노션 사용자)

claude mcp add --transport http notion https://mcp.notion.com/mcp

옵션 C: Fetch (웹페이지 가져오기)

claude mcp add --transport stdio fetch -- npx -y @anthropic-ai/mcp-fetch@latest

설치 후 확인:

claude mcp list

방금 추가한 서버가 목록에 보이면 성공!

Claude Code를 재시작해야 적용되는 경우가 있다. 새 세션을 시작해보자.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "클라우드 서비스(Notion, Sentry)에 연결할 때 추천하는 transport 방법은?",
    "header": "Quiz 1",
    "options": [
      {"label": "HTTP", "description": "클라우드 서비스 연결의 표준 방식"},
      {"label": "stdio", "description": "stdio는 내 컴퓨터에서 로컬 실행할 때 사용"},
      {"label": "FTP", "description": "MCP에서 FTP는 지원하지 않음"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 피드백: "정확합니다! 클라우드 = HTTP, 로컬 = stdio. 이 두 가지만 기억하면 됩니다."

Block 2: /mcp 명령어로 도구 탐색

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/mcp

```

EXPLAIN

/mcp 명령어란?

Claude Code 안에서 /mcp를 입력하면 연결된 MCP 서버의 상태와 도구를 한눈에 볼 수 있다.

/mcp에서 볼 수 있는 것

/mcp 실행 시
┌──────────────────────────────────────────┐
│ MCP Servers                              │
│                                          │
│ ✅ context7 (stdio)                      │
│    Tools: resolve-library-id, query-docs │
│                                          │
│ ✅ slack (http)                          │
│    Tools: slack_send_message,            │
│           slack_read_channel, ...        │
│                                          │
│ ❌ notion (http) - 인증 필요             │
│    → "인증" 선택하여 로그인              │
└──────────────────────────────────────────┘

MCP 도구의 이름 규칙

MCP 도구는 mcp__서버이름__도구이름 형태로 불린다:

이름이 길지만 직접 외울 필요 없다. Claude에게 "Slack 메시지 읽어줘"라고 하면 알아서 올바른 도구를 호출한다.

claude.ai에서 MCP 연결하기 (가장 쉬운 방법)

터미널에서 claude mcp add 명령어 외에, 웹 브라우저에서 클릭 몇 번으로 MCP를 연결하는 방법이 있다:

1. https://claude.ai/settings/connectors 접속
2. 연결하고 싶은 서비스 선택 (Slack, Notion 등)
3. 로그인 후 연결 승인
4. Claude Code에서 /mcp → "claude.ai" 섹션에 자동 등록!

/mcp 실행 시 (Connectors로 연결한 경우)
┌──────────────────────────────────────────┐
│ MCP Servers                              │
│                                          │
│ 📌 claude.ai                             │
│ ✅ Slack                                 │
│    Tools: slack_send_message,            │
│           slack_read_channel, ...        │
│                                          │
│ 📌 local                                 │
│ ✅ context7 (stdio)                      │
│    Tools: resolve-library-id, query-docs │
└──────────────────────────────────────────┘

Slack을 처음 연결한다면 이 방법이 가장 쉽다. 터미널 명령어 없이 웹에서 로그인만 하면 된다.

OAuth 인증이 필요한 서버

Notion, GitHub, Sentry 같은 서비스는 로그인이 필요하다:

1. /mcp 실행
2. 인증이 필요한 서버 옆의 "인증" 선택
3. 브라우저가 열리면 로그인
4. 인증 완료 → 서버 연결됨

인증 토큰은 자동 저장되고 자동 갱신된다. 한 번만 하면 된다.

EXECUTE

3단계로 /mcp 명령어를 체험해보자:

1단계: /mcp 실행

Claude Code에서 아래를 입력한다:

/mcp

연결된 서버 목록이 나온다. 각 서버의 상태(연결/오류)와 제공하는 도구를 확인하자.

2단계: 도구 목록 확인

/mcp 화면에서 각 서버를 열어보면 그 서버가 제공하는 도구(Tools) 목록이 나온다. 어떤 도구가 있는지 살펴보자.

3단계: 도구 실제 사용

연결된 서버의 도구를 Claude에게 사용해달라고 요청해본다:

Context7이 있다면:

context7으로 React의 useEffect 사용법을 검색해줘

Slack이 있다면:

Slack에서 가장 최근 메시지 5개를 보여줘

Fetch가 있다면:

https://news.ycombinator.com 에서 오늘의 인기 글 3개를 가져와줘

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "/mcp 명령어의 주요 역할은?",
    "header": "Quiz 2",
    "options": [
      {"label": "연결된 MCP 서버 상태와 도구 목록 확인", "description": "서버 연결 상태, 제공 도구, OAuth 인증까지"},
      {"label": "새 MCP 서버를 설치하는 명령어", "description": "설치는 claude mcp add로 함"},
      {"label": "MCP 서버를 삭제하는 명령어", "description": "삭제는 claude mcp remove로 함"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 피드백: "맞습니다! /mcp = 현황 파악. 설치는 claude mcp add, 삭제는 claude mcp remove입니다. /mcp는 '지금 뭐가 연결되어 있지?' 할 때 씁니다."

Block 3: 인기 MCP 서버 탐색 및 설치

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/mcp#popular-mcp-servers

📖 MCP 서버 목록: https://github.com/modelcontextprotocol/servers/blob/main/README.md

```

EXPLAIN

MCP 서버는 어디서 찾나?

비개발자에게 추천하는 인기 서버

커뮤니케이션

생산성

개발

데이터

서버 선택 기준

내가 매일 쓰는 도구가 뭐지?
  │
  ├─ Slack 많이 쓴다 → Slack MCP
  ├─ Notion에 정보 정리 → Notion MCP
  ├─ 이메일 관리 → Gmail MCP
  ├─ 코딩한다 → GitHub + Sentry MCP
  └─ 웹 검색/리서치 → Fetch MCP

한 번에 다 설치하지 말고, 가장 자주 쓰는 도구 1~2개부터 시작하자.

MCP의 한계 — 왜 Skill을 직접 만들어야 하나?

MCP 서버는 남이 만들어둔 범용 도구다. 설치만 하면 바로 쓸 수 있어서 편하지만, 한계가 있다:

MCP 서버 (남이 만든 것)              나만의 Skill (직접 만든 것)
  ├─ 설치 즉시 사용 가능              ├─ 내 워크플로우에 딱 맞게 설계
  ├─ 범용적 기능 제공                 ├─ 필요한 기능만 조합
  ├─ 커스텀이 어려움 ⚠️              ├─ 자유롭게 수정 가능
  └─ 모든 기능이 다 필요한 건 아님     └─ 진짜 효율적인 자동화

예를 들어, Slack MCP를 설치하면 메시지를 읽고 보낼 수 있다. 하지만 "매일 아침 3개 채널의 중요 메시지를 요약해서 Notion에 정리해줘" 같은 나만의 워크플로우는 MCP만으로는 만들 수 없다.

결론: MCP로 시작하되, 진짜 효과적인 워크플로우를 원한다면 직접 Skill로 만들자.

Day 2에서 이걸 직접 해본다!

EXECUTE

3단계로 인기 서버를 탐색하고 설치해보자:

1단계: 공식 문서에서 인기 서버 확인

Claude에게 물어보자:

Claude Code 공식 문서에서 추천하는 인기 MCP 서버 목록을 보여줘. 각각 뭘 할 수 있는지도 알려줘

2단계: 내게 필요한 서버 선택 및 설치

위 목록에서 하나를 골라 설치한다. 추천 순서:

1. 업무에서 가장 많이 쓰는 도구 2. 모르겠으면 Notion 또는 Fetch부터

설치 후 Claude Code를 새 세션으로 재시작한다 (기존 세션 종료 → claude 다시 실행).

3단계: 설치한 서버 도구 사용해보기

새 세션에서 /mcp로 서버가 연결되었는지 확인한 후, Claude에게 도구를 사용해달라고 요청한다.

방금 설치한 MCP 서버의 도구를 사용해서 뭔가 해봐

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "MCP 서버를 선택할 때 가장 좋은 기준은?",
    "header": "Quiz 3",
    "options": [
      {"label": "내가 매일 쓰는 도구부터 1~2개", "description": "실제 업무에서 바로 활용할 수 있는 것"},
      {"label": "인기 순위 1위부터 전부 설치", "description": "안 쓰는 서버는 리소스 낭비"},
      {"label": "가장 기술적으로 복잡한 것", "description": "복잡할수록 좋은 게 아님"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 피드백: "맞습니다! 매일 쓰는 도구부터 연결하면 바로 체감할 수 있습니다. 나중에 필요할 때 하나씩 추가하면 됩니다."

Block 4: /plugin으로 MCP 확장

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/plugins

📖 플러그인 마켓: https://code.claude.com/docs/ko/discover-plugins

```

EXPLAIN

Plugin과 MCP의 관계

Day 1에서 배웠듯, Plugin = Skill + MCP + Hook + Agent를 묶은 패키지다.

Plugin 안에 MCP가 포함될 수 있다
┌─────────────────────────────────┐
│         My Plugin               │
│                                 │
│  ┌─────────┐  ┌──────────────┐  │
│  │ Skills  │  │ MCP Servers  │  │
│  └─────────┘  └──────────────┘  │
│  ┌─────────┐  ┌──────────────┐  │
│  │ Hooks   │  │ Agents       │  │
│  └─────────┘  └──────────────┘  │
└─────────────────────────────────┘

Plugin을 설치하면 그 안에 포함된 MCP 서버가 자동으로 연결된다. 따로 claude mcp add를 할 필요가 없다.

/plugin 명령어

Plugin이 MCP보다 좋은 점

Official Plugin vs Community Plugin

Official Plugins                    Community Plugins
  ├─ Anthropic이 검증              ├─ 커뮤니티가 만든 것
  ├─ /plugin에서 바로 설치          ├─ marketplace 등록 후 설치
  └─ 안정성 보장                   └─ 다양한 기능

  /plugin                          /plugin marketplace add [URL]
  → 목록에서 선택                   → /plugin install [이름]

EXECUTE

3단계로 Plugin을 통한 MCP 확장을 체험해보자:

1단계: /plugin으로 공식 플러그인 탐색

Claude Code에서 아래를 입력한다:

/plugin

설치 가능한 공식 플러그인 목록이 나온다. 각 플러그인의 설명을 읽어보고 마음에 드는 것을 골라 설치해보자.

2단계: 커뮤니티 마켓플레이스 등록

Anthropic 공식 외에도 커뮤니티가 만든 플러그인이 있다. 마켓플레이스를 등록해보자:

/plugin marketplace add obra/superpowers-marketplace

등록 후 플러그인을 설치한다:

/plugin install superpowers@superpowers-marketplace

superpowers는 TDD, 디버깅, 코드리뷰 등 개발 워크플로우를 강화하는 플러그인이다.

3단계: 설치된 플러그인의 MCP 확인

플러그인을 설치한 후 /mcp를 실행해서 플러그인이 자동으로 추가한 MCP 서버가 있는지 확인한다:

/mcp

플러그인에 MCP 서버가 포함되어 있으면 자동으로 목록에 나타난다.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "Plugin에 MCP 서버가 포함되어 있으면?",
    "header": "Quiz 4",
    "options": [
      {"label": "설치하면 MCP 서버가 자동으로 연결된다", "description": "claude mcp add 없이 자동 설정"},
      {"label": "별도로 claude mcp add를 해야 한다", "description": "Plugin이 자동 처리"},
      {"label": "MCP와 Plugin은 관련 없다", "description": "Plugin은 MCP를 포함할 수 있음"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 피드백: "정확합니다! Plugin의 큰 장점이 바로 이겁니다. 복잡한 설정 없이 설치 한 줄이면 MCP 서버까지 자동 연결됩니다."