Back to Details

day2-supplement-mcp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Day 2 보충: MCP 딥다이브

Day 2补充：MCP深度解析

이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.
调用此技能时，必须遵循以下STOP PROTOCOL。

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부터.                │
└──────────────────────────────────────────────────────────┘
┌─ 阶段A（第一回合） ──────────────────────────────┐
│ 1. 读取references/对应模块文件的EXPLAIN部分    │
│ 2. 讲解功能内容                                        │
│ 3. 读取references/对应模块文件的EXECUTE部分    │
│ 4. 提示“请您亲自尝试执行”                     │
│ 5. ⛔ 此处必须停止，结束当前回合。                    │
│                                                          │
│ ❌ 绝对禁止：出题测验、读取QUIZ部分             │
│ ❌ 绝对禁止：调用AskUserQuestion                  │
│ ❌ 绝对禁止：询问“您执行了吗？”                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 用户返回“完成了”、“已完成”、“下一步”等内容后

┌─ 阶段B（第二回合） ──────────────────────────────┐
│ 1. 读取references/对应模块文件的QUIZ部分       │
│ 2. 通过AskUserQuestion出题测验                     │
│ 3. 给出正确/错误的反馈                                 │
│ 4. 通过AskUserQuestion询问是否进入下一个模块         │
│ 5. ⛔ 进入下一个模块后，重新从阶段A开始。                │
└──────────────────────────────────────────────────────────┘

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

核心禁止事项（严禁违反）

  1. Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
  2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
  3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
  4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
  1. 阶段A中禁止调用AskUserQuestion — 完成讲解+执行提示后直接停止
  2. 阶段A中禁止出题测验 — QUIZ部分仅在阶段B读取
  3. 阶段A中禁止询问“您执行了吗？” — 等待用户主动反馈
  4. 禁止在一个回合内同时进行EXPLAIN+QUIZ — 必须拆分为两个回合

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

输出官方文档URL（严禁遗漏）

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 
> 공식 문서:
URL을 반드시 그대로 출력한다.
📖 공식 문서: [URL]
  • reference 파일에 URL이 여러 개 있으면 전부 출력한다
  • URL을 요약하거나 생략하지 않는다
  • 참가자가 직접 클릭해서 공식 문서를 볼 수 있어야 한다
所有模块的阶段A开始时，必须原样输出对应参考文件顶部的
> 공식 문서:
URL。
📖 官方文档: [URL]
  • 若参考文件包含多个URL，需全部输出
  • 不得总结或省略URL
  • 必须确保学员可直接点击查看官方文档

Phase A 종료 시 필수 문구

阶段A结束时的必填语句

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.
이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.
阶段A的最后必须输出以下格式的语句后停止：
---
👆 请您亲自尝试执行上述内容。
执行完成后，请输入“完成”或“下一步”。
此语句之后不得输出任何工具调用（包括AskUserQuestion）或额外文本。

References 파일 맵

参考文件映射

블록파일주제
Block 0
references/block0-concept.md
MCP 개념 이해
Block 1
references/block1-add-server.md
MCP 서버 추가하기
Block 2
references/block2-mcp-command.md
/mcp 명령어로 도구 탐색
Block 3
references/block3-popular-servers.md
인기 MCP 서버 탐색 및 설치
Block 4
references/block4-plugin-mcp.md
/plugin으로 MCP 확장
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은 
## EXPLAIN
, 
## EXECUTE
, 
## QUIZ
섹션으로 구성된다.
模块文件主题
Block 0
references/block0-concept.md
理解MCP概念
Block 1
references/block1-add-server.md
添加MCP服务器
Block 2
references/block2-mcp-command.md
用/mcp命令探索工具
Block 3
references/block3-popular-servers.md
探索并安装热门MCP服务器
Block 4
references/block4-plugin-mcp.md
用/plugin扩展MCP
文件路径基于本SKILL.md的相对路径。 每个参考文件均由
## EXPLAIN
、
## EXECUTE
、
## QUIZ
部分组成。

진행 규칙

执行规则

  • 한 번에 한 블록씩 진행한다
  • "다음", "skip", 블록 번호/이름으로 이동한다
  • Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다
  • Block 4 완료 후 전체 마무리 안내
  • 一次仅进行一个模块
  • 可通过“下一步”、“skip”、模块编号/名称切换模块
  • 若收到Claude Code相关问题，使用claude-code-guide代理（内置工具）回答。回答后需提供可让学员亲自跟随的分步指引，提问时使用AskUserQuestion
  • 完成Block 4后进行整体收尾说明

시작

开始

스킬 시작 시 아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.
Block주제내용
0MCP 개념MCP가 뭔지, USB-C 비유, 아키텍처
1서버 추가
claude mcp add
로 실제 서버 연결
2/mcp 탐색연결된 서버와 도구 목록 확인
3인기 서버공식 목록에서 유용한 서버 설치
4Plugin + MCP/plugin으로 MCP 포함 플러그인 설치
json
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부터 진행한다.
技能启动时，展示以下表格并通过AskUserQuestion询问从哪里开始。
模块主题内容
0MCP概念MCP是什么、USB-C类比、架构
1添加服务器用
claude mcp add
连接真实服务器
2/mcp探索查看已连接的服务器和工具列表
3热门服务器从官方列表安装实用服务器
4Plugin + MCP用/plugin安装包含MCP的插件
json
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
  }]
})
选择启动模块后 → 从对应模块的阶段A开始执行。