AI Native Camp Day 2 MCP & Context Sync. MCP를 배우고 나만의 Context Sync 스킬을 만든다. "2일차", "Day 2", "MCP", "context sync" 요청에 사용.

Day 2: MCP & Context Sync 이 스킬이 호출되면 아래 STOP PROTOCOL 을 반드시 따른다. 용어 정리 이 스킬에서 사용하는 핵심 용어: 용어 설명 MCP Model Context Protocol. AI와 외부 도구를 연결하는 오픈 표준. USB C처럼 다양한 서비스를 하나의 규격으로 연결 Host / Client / Server MCP의 3요소. Host=AI 앱(Claude Code), Client=연결 관리자, Server=외부 도구 제공자 Transport MCP 서버 연결 방식. HTTP(클라우드 서비스)와 stdio(로컬 실행) 2가지 Plugin Skill + MCP + Hook + Agent를 묶은 패키지. 설치 한 줄이면 MCP 서버까지 자동 연결 subagent Claude가 다른 Claude를 불러서 일을 시키는 것. 여러 일을 동시에 처리할 때 사용 Explore 에이전트 프로젝트 폴더 구조를 파악해주는 전문 subagent. 읽기 전용 API 서비스가 제공하는 데이터 창구. MCP가 없을 때 직접 코드로 데이터를 가져오는 방법 스킬(Skill) Claude Code에게 특정 작업 방법을 가르치는 문서. Day 1 Block 3 2에서 체험한 것 STUB 나중에 채울 빈칸. "여기에 나중에 내용이 들어갑니다"라는 표시. Part B에서 블록마다 하나씩 채워나간다 스켈레톤 빈칸(STUB)만 있는 뼈대. 건물로 치면 철골 구조만 세운 상태 frontmatter 파일 맨 위에 로 감싼 정보 영역. 스킬의 이름, 설명, 트리거 등을 적는 곳 YAML / JSON 데이터를 정리하는 형식. 엑셀이 표로 데이터를 정리하듯, 텍스트로 정리하는 방식 CLI Command Line Interface. 터미널에 직접 명령어를 입력하는 방식 STOP PROTOCOL — 절대 위반 금지 이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다. 각 블록은 반드시 2턴에 걸쳐 진행한다 핵심 금지 사항 (절대 위반 금지) 1. Phase A에서 AskUserQuestion을 호출하지 않는다 (Block 6, 7, 8, 9, 10 제외) — 이 5개 블록은 사용자 선택/확인이 필수이므로 예외 2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다 3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다 4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다 공식 문서 URL 출력 (절대 누락 금지) 모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 공식 문서: URL을 반드시 그대로 출력 한다. reference 파일에 URL이 여러 개 있으면 전부 출력한다 URL을 요약하거나 생략하지 않는다 참가자가 직접 클릭해서 공식 문서를 볼 수 있어야 한다 Phase A 종료 시 필수 문구 Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다: 이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다. 소요 시간 Part 블록 예상 시간 Part A: MCP 딥다이브 Block 0~4 ~60분 Part B: Context Sync 스킬 만들기 Block 5~10 ~110분 합계 Block 0~10 ~170분 핵심 전략 Part A: MCP 개념부터 Plugin까지 체계적으로 배우기 MCP의 개념(Block 0)부터 시작해서, 서버 추가(Block 1), 도구 탐색(Block 2), 인기 서버 설치(Block 3), Plugin으로 확장(Block 4)까지 순서대로 진행한다. Part B: 4개 도구 × 4가지 연결 방법 — 점진적 빌드 아래 방식으로 진행한다: 1. Block 5에서 templates/context sync.md 기반으로 4개 소스 STUB이 포함된 스켈레톤 스킬 파일을 생성한다 2. Block 6~9에서 블록마다 하나의 도구를 다른 연결 방법으로 연결하고, 해당 소스 STUB을 실제 내용으로 채운다 3. Block 10에서 실행 흐름 + 출력 포맷을 완성하고, 전체 스킬을 실행한다 핵심 : 4개 도구를 일괄 연결하는 것이 아니라, 블록마다 다른 연결 방식 을 실습한다. Part B 블록 구조 Block 연결 방법 도구 난이도 시간 5 — 전체 — ~12min 6 claude.ai Connector Slack ★☆☆☆ ~15min 7 claude mcp add Notion ★★☆☆ ~18min 8 Official Plugin ( /plugin ) Linear ★★★☆ ~15min 9 커뮤니티 Plugin (구조 분석) Google Calendar/Gmail ★★★★ ~20min 10 — (병렬 수집 + Output + 마무리) 전체 — ~20min 점진적 빌드 — 템플릿 채움 순서 블록 소스 매핑 Block 채우는 소스 연결 방법 스킬 파일 변경 영역 5 — (골격 생성) — 전체 스켈레톤 생성 6 소스 1: Slack Connector 소스 1 STUB → 실제 내용 7 소스 2: Notion claude mcp add 소스 2 STUB → 실제 내용 8 소스 3: Linear /plugin install 소스 3 STUB → 실제 내용 9 소스 4: Google 커뮤니티 Plugin 소스 4 STUB → 실제 내용 10 — (완성 + 실행) — 실행 흐름 + 출력 포맷 완성 블록 특수 규칙 Part A (Block 0~4) Block 4 [BONUS] : 시간이 남을 때만 진행한다 Block 3 완료 후 Part A 마무리 안내 → Part B 전환 안내 Part A에서 배운 MCP 지식이 Part B의 도구 연결(Block 7)에서 직접 활용된다 Part B (Block 5~10) Block 5 (스켈레톤 생성) : Phase A에서 Context Sync 개념 + 4가지 연결 방법 소개 + Explore로 프로젝트 탐색 + templates/context sync.md 기반 스켈레톤 생성 → Stop. Phase B에서 퀴즈. Block 6 (Connector → Slack) : Phase A에서 Connector 개념 설명 + Slack Connector 연결 안내 + 테스트 + 스킬 소스 1 채우기 → Stop. Phase B에서 퀴즈. Block 7 (mcp add → Notion) : Phase A에서 claude mcp add 설명 + AskUserQuestion으로 Notion 확인 + MCP 서버 등록 + 테스트 + 스킬 소스 2 채우기 → Stop. Phase B에서 퀴즈. Block 8 (Plugin → Linear) : Phase A에서 Plugin 개념 설명 + /plugin install linear + MCP 자동 등록 확인 + 테스트 + 스킬 소스 3 채우기 → Stop. Phase B에서 퀴즈. Block 9 (커뮤니티 Plugin → Google) : Phase A에서 Plugin 구조 분석 + AskUserQuestion으로 Calendar/Gmail 선택 + Explore로 Plugin 구조 탐색 + 설치 + 스킬 소스 4 채우기 → Stop. Phase B에서 퀴즈. Block 10 (병렬 수집 + Output + 마무리) : Phase A에서 AskUserQuestion으로 출력 형식 선택 + 실행 흐름/출력 포맷 완성 + 4개 소스 병렬 수집 실행 + 결과 확인 → Stop. Phase B에서 종합 퀴즈 + 마무리. AskUserQuestion 예외 블록 Block 이유 Block 6 Slack 사용 여부 확인 (회사 계정 제한 시 대안 안내) Block 7 Notion workspace 사용 여부 확인 Block 8 Linear 사용 여부 확인 (미사용 시 대안 Plugin 안내) Block 9 Google Calendar vs Gmail vs 둘 다 선택 Block 10 Output format 선택 Block 6 예외 규칙 Block 6의 Phase A는 AskUserQuestion을 사용 한다. Slack 사용 여부와 연결 가능 여부를 확인해야 한다. Slack 사용 시: 1. claude.ai/settings/connectors에서 Slack Connector 연결 2. /mcp 로 claude.ai 섹션에 등록 확인 3. 연결 테스트 후 스킬 소스 1 채우기 Slack 미사용 또는 회사 계정 제한 시 (Plan B): 1. 개인 Slack workspace나 AI Native Camp Slack으로 연결 2. Connector 연결 방식 자체를 체험하는 것이 핵심임을 안내 ⚠️ 보안 안내: 회사 Slack은 관리자 정책상 외부 앱 연결이 차단될 수 있다. 이 경우 개인 workspace를 사용한다. Block 7 예외 규칙 Block 7의 Phase A는 AskUserQuestion을 사용 한다. Notion 사용 여부를 확인해야 한다. 핵심 원칙: Claude가 설정을 대신 수행하고, 사용자는 결과를 확인한다. Notion 사용 시: 1. claude mcp add transport http notion https://mcp.notion.com/mcp 실행 2. /mcp 로 local 섹션에 등록 확인 3. 연결 테스트 후 스킬 소스 2 채우기 Notion 미사용 시 (Plan B): 1. scripts/mcp servers.py 를 사용하여 대체 MCP 서버 검색 2. 검색 결과에서 선택하여 claude mcp add 로 등록 Block 8 예외 규칙 Block 8의 Phase A는 AskUserQuestion을 사용 한다. Linear 사용 여부를 확인해야 한다. Linear 사용 시: 1. /plugin install linear 실행 2. /mcp 로 local 섹션에 Linear MCP 자동 등록 확인 3. 연결 테스트 후 스킬 소스 3 채우기 Linear 미사용 시 (Plan B): 1. /plugin 명령어로 설치 가능한 다른 공식 Plugin 목록 확인 2. 사용 중인 도구의 Plugin이 있으면 그것을 설치 3. Plugin이 없으면 Block 8은 skip하고 Block 9로 이동 가능 4. 핵심 : Plugin 설치 → MCP 자동 등록이라는 과정을 체험하는 것이 목표 ⚠️ Plugin 설치 후 Claude Code 재시작이 필요할 수 있다. MCP 연결이 안 보이면 Claude Code를 재시작한다. Block 9 예외 규칙 Block 9의 Phase A는 AskUserQuestion을 사용 한다. Google Calendar vs Gmail vs 둘 다를 선택해야 한다. Phase A 진행 순서: 1. references/block9 skill google.md 의 EXPLAIN 섹션을 읽고 Plugin 구조를 설명한다 2. /plugin marketplace add team attention/plugins for claude natives 실행 3. AskUserQuestion으로 Calendar/Gmail/둘 다/Skip 선택 4. Explore 에이전트로 Plugin 디렉토리 구조 탐색 + 설명 5. 선택한 도구 Plugin 설치 + 테스트 + 스킬 소스 4 채우기 → Stop Block 10 예외 규칙 Block 10의 Phase A는 AskUserQuestion을 사용 한다. Output format을 선택해야 한다. References 파일 맵 Part A: MCP 딥다이브 블록 파일 주제 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 [BONUS] references/block4 plugin mcp.md /plugin으로 MCP 확장 Part B: Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법) 블록 파일 주제 Block 5 references/block5 template creation.md Context Sync 개념 + Explore + 스켈레톤 생성 Block 6 references/block6 connector slack.md Connector로 Slack 연결 + 스킬 소스 1 채우기 Block 7 references/block7 mcp add notion.md claude mcp add 로 Notion 연결 + 스킬 소스 2 채우기 Block 8 references/block8 plugin linear.md /plugin install 로 Linear 연결 + 스킬 소스 3 채우기 Block 9 references/block9 skill google.md Plugin 구조 분석 + Google 연결 + 스킬 소스 4 채우기 Block 10 references/block10 finalize.md 병렬 수집 + Output 선택 + 최종 실행 + 마무리 파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은 EXPLAIN , EXECUTE , QUIZ 섹션으로 구성된다. Templates / Scripts 파일 맵 파일 용도 templates/context sync.md Context Sync 스킬 기본 템플릿 (Slack, Notion, Gmail, GCal 4종 포함) scripts/mcp servers.py GitHub에서 MCP 서버 검색 + README.md 파싱 + 설치 안내 Gmail/Calendar 등의 수집 스크립트는 Block 7에서 Claude가 사용자의 선택에 맞춰 직접 작성한다. 진행 규칙 한 번에 한 블록씩 진행한다 "다음", "skip", 블록 번호/이름으로 이동한다 BONUS 블록(Block 4)은 시간이 남을 때만 진행한다 Part A(Block 0~4) 완료 후 Part B(Block 5~10)로 자연스럽게 전환한다. Part A에서 배운 MCP 지식이 Part B의 도구 연결(Block 6~9)에서 직접 활용된다 Block 5에서 생성한 스켈레톤 스킬 파일의 STUB을 Block 6~9에서 하나씩 채운다. 각 블록에서 도구를 연결한 뒤 해당 소스 섹션을 실제 내용으로 교체한다 사용자 프로젝트의 .claude/skills/my context sync/ 디렉토리에 스킬을 생성한다 Block 6~9에서 각각 Connector, mcp add, Plugin, 커뮤니티 Plugin을 통해 다른 연결 방식을 실습한다 Explore 에이전트와 subagent 사용이 핵심이므로 적극 활용한다 Claude Code 관련 질문이 오면 claude code guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 curl 로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 시작 스킬 시작 시 먼저 최신 커리큘럼을 설치 한 뒤 블록을 선택한다. Step 1: 최신 스킬 설치 아래 명령어를 출력하고 Bash로 실행한다: 실행 결과를 간략히 안내한다 (예: "스킬이 최신 버전으로 설치되었습니다"). Step 2: 블록 선택 아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다. Part A: MCP 딥다이브 Block 주제 내용 0 MCP 개념 MCP가 뭔지, USB C 비유, 아키텍처 1 서버 추가 claude mcp add 로 실제 서버 연결 2 /mcp 탐색 연결된 서버와 도구 목록 확인 3 인기 서버 공식 목록에서 유용한 서버 설치 4 [BONUS] Plugin + MCP /plugin으로 MCP 포함 플러그인 설치 Part B: 나만의 Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법) Block 연결 방법 도구 내용 5 — 전체 Context Sync 개념 + 스켈레톤 생성 6 Connector Slack 브라우저 클릭으로 Slack 연결 7 claude mcp add Notion CLI 명령어로 Notion 연결 8 Plugin ( /plugin ) Linear 공식 Plugin으로 Linear 연결 9 커뮤니티 Plugin Google Plugin 구조 분석 + Google 연결 10 — 전체 병렬 수집 + Output + 최종 실행 시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.

day2-mcp-and-context-sync