Claude Code & MCP 핸즈온

Claude 를 채팅창에서 쓰는 데 그치지 않고, 터미널 에이전트로 다루고 MCP 로 외부 세계와 연결하는 법을 배웁니다.

• Claude 생태계 지도: claude.ai · Desktop · Cowork · Code · Agent SDK 가 각각 어디에 쓰이는지
• Claude Code 설치 & Bedrock 인증: 터미널 에이전트를 내 머신에 (Windows 는 WSL2)
• 기본 동작법: 세션 명령 · 권한 모델 · CLAUDE.md 메모리 · Custom Commands
• MCP: 외부 도구·데이터를 붙이는 표준 프로토콜. 체험 → 이론 → 실습 순서로

• 데모 먼저: MCP 는 일단 한 번 붙여 보고(체험), 그다음 왜·어떻게(이론), 마지막에 본격 실습합니다.
• 모든 실습은 본인 터미널에서: 강사 화면 구경으로는 감각이 잡히지 않습니다.
• Bedrock 백엔드: 1·2일차와 동일한 Amazon Bedrock(us-east-1) 을 그대로 씁니다.
• 안전 기본값: 외부 연결은 읽기 전용 · 최소 권한 · 신뢰된 서버를 우선합니다.

항목	권장
터미널	macOS 는 iTerm2, Windows 는 Windows Terminal
에디터	Zed 또는 VS Code
Windows 사용자	WSL2 필수. Lab 02 에서 설치합니다
런타임	Node 최신 스테이블 버전. MCP 실습용으로 Docker 또는 Python 3.12+ & uv
AWS 자격증명	1·2일차와 동일 (Bedrock us-east-1)

배포된 00_check_day3_env.sh 를 bash 00_check_day3_env.sh 로 실행해 claude · Bedrock · node · uv · docker 가 모두 초록불인지 먼저 확인하세요.

랩	주제	만지는 것
Lab 01	Claude 생태계	생태계 지도 · CLI 에이전트 패턴 · 플랫폼 매트릭스
Lab 02	설치 & Bedrock 인증	설치 한 줄 · WSL2 · CLAUDE_CODE_USE_BEDROCK
Lab 03	기본 동작법	세션 명령 · 권한 모델 · CLAUDE.md · Custom Commands
Lab 04	MCP 체험	Playwright 브라우저 MCP 를 붙여 첫 동작 확인
Lab 05	MCP 이론 심화	Host · Client · Server · JSON-RPC · 보안
Lab 06	MCP 실습	DB(읽기 전용) 연결 · 내 MCP 서버 직접 제작

이 과정은 MCP 에 집중합니다. Skills · Plugins 같은 다른 확장은 Lab 01 생태계 지도에서 개념만 짚고 넘어갑니다.