Claude Code 완전 가이드: Part 6 - MCP, HOOKS, AGENTS

1. MCP (Model Context Protocol): 외부 환경 연동

Claude가 외부 API 및 서비스와 직접 통신하게 해주는 프로토콜입니다.

• 주요 실무 활용 및 설치
  • 브라우저 자동화 (Playwright): claude mcp add -s user playwright npx @playwright/mcp@latest (로그인 폼 테스트, 스크린샷 캡처 등)
  • DB 직접 쿼리 (Supabase): claude mcp add -s user supabase npx @supabase/mcp@latest (자연어로 SQL 실행 및 데이터 집계)
  • 웹 크롤링 (Firecrawl): claude mcp add -s user firecrawl npx @firecrawl/mcp@latest (특정 URL 데이터 추출 및 파일 저장)
• 성능 최적화 주의사항
  • 활성화된 MCP는 컨텍스트 윈도우를 차지합니다.
  • 권장: MCP 서버 10개 미만, 활성 도구 80개 미만 유지.
  • 사용하지 않는 MCP는 /mcp 명령어로 즉시 비활성화하세요.

---

2. Hooks: 셸 명령어 기반 규칙 강제

특정 이벤트 발생 시 지정된 셸 명령어를 자동으로 실행하여 AI의 동작을 결정론적으로 제어합니다.

• 주요 Hook 종류
  • PreToolUse: 도구 실행 전 (위험 명령어 사전 차단)
  • PostToolUse: 도구 실행 후 (로그 기록, 외부 시스템 알림)
  • PermissionRequest: 권한 요청 시 (특정 조건 자동 승인/거부)

---

3. Skills: 상황 맞춤형 재사용 지식 모듈

특정 상황에서 Claude가 자동으로 호출하거나, 사용자가 수동으로 호출할 수 있는 지식 조각입니다.

• 활용 방식: ~/.claude/skills/ 경로에 .md 파일로 포맷과 호출 예시를 정의해두면, AI가 문맥을 파악해 해당 스킬(예: 번역 링크 자동 생성, 사내 위키 검색 등)을 자동 적용합니다.

---

4. Agents: 목적 특화 서브에이전트

메인 Claude가 작업을 위임할 수 있는 독립적인 특화 AI 프로세스입니다.

• 특징: 에이전트별 독립된 200k 컨텍스트 윈도우 할당, 병렬 작업 가능.
• 실무 활용 시나리오
  • TDD 전담 에이전트: 구현된 함수를 넘기면 테스트 케이스 설계 및 테스트 코드 자동 작성.
  • 보안 감사 에이전트: 전체 코드베이스를 대상으로 SQL 인젝션, XSS, 하드코딩 취약점만 집중 스캔 후 보고서 반환.

---

5. Plugins: 기능 패키징 및 배포

설정해둔 Hooks, Skills, Agents, MCP 서버를 단일 패키지로 묶어 팀원들과 공유하거나 설치할 수 있습니다.

• 설치 명령어: /plugin search [검색어], /plugin install [패키지명]