Claude Code MCP, Skills, 서브에이전트 차이와 최소 설정법
MCP는 외부 도구 연결, Skills는 반복 절차, 서브에이전트는 별도 컨텍스트의 전담 에이전트입니다. 공식 문서 기준 최소 설정과 샘플 스킬을 정리했습니다.
Claude Code의 확장 기능은 역할이 다릅니다. MCP는 외부 도구와 데이터를 연결하고, Skills는 반복 절차를 파일로 저장하며, 서브에이전트는 별도 컨텍스트의 전담 일꾼입니다. 플러그인은 이 구성을 묶어 배포합니다. 외부 시스템이 필요하면 MCP, 같은 절차를 반복하면 Skills, 큰 탐색을 메인 대화에서 빼고 싶으면 서브에이전트입니다.
비교
| 구분 | MCP | Skills | 서브에이전트 | 플러그인 |
|---|---|---|---|---|
| 하는 일 | 외부 도구·데이터 연결 | 절차와 지식을 파일로 저장 | 별도 컨텍스트의 전담 에이전트 | 위 구성과 훅을 묶어 설치 |
| 형태 | 서버 프로세스 또는 원격 URL | SKILL.md | .claude/agents/*.md | 마켓플레이스 또는 저장소 |
| 호출 | 필요할 때 도구로 | 설명에 맞으면 로드, /이름 | 위임 또는 지정 | 설치 후 각자 동작 |
| 비용 | 도구 목록이 컨텍스트에 들어갈 수 있음 | 호출될 때 본문 로드 | 메인 대화는 가벼워질 수 있으나 한도는 따로 씀 | 포함한 구성에 따름 |
Skills는 “어떻게 할지 적은 문서”, 서브에이전트는 “그 일을 대신 하는 별도 일꾼”입니다.
MCP
MCP 문서는 이슈 트래커, 데이터베이스, 브라우저 같은 외부 시스템을 함수처럼 호출하게 한다고 적습니다. 연결 전에 서버를 신뢰할 수 있는지 확인하라고 경고합니다.
원격 HTTP 서버 예:
claude mcp add --transport http <이름> <서버 URL>
로컬 stdio 서버는 -- 뒤에 실행 명령을 둡니다. 프로젝트 공유는 루트 .mcp.json입니다. 범위는 local(기본, 이 프로젝트·나만), project(.mcp.json으로 팀 공유), user(모든 프로젝트)입니다. 목록은 claude mcp list, 세션 안에서는 /mcp입니다.
서버를 많이 붙이면 도구 설명이 컨텍스트를 차지합니다. 지금 작업에 필요한 것만 켜십시오.
예시에 나오는 API 키·토큰은 자리 표시입니다. 실제 값으로 복사해 두지 마십시오.
Skills
Skills 문서는 SKILL.md 한 장으로 능력을 확장한다고 적습니다. CLAUDE.md와 달리 본문은 쓰일 때만 로드됩니다. 커스텀 슬래시 명령(.claude/commands/)은 Skills로 합쳐졌고, 기존 파일은 그대로 동작합니다.
위치: 프로젝트는 .claude/skills/<이름>/SKILL.md, 개인은 ~/.claude/skills/<이름>/SKILL.md.
---
name: meeting-notes
description: 회의 메모를 결정/할 일/미확인 사실로 나눈다. 회의록, 메모 정리 요청에 사용.
---
1. 원문을 세 섹션으로 나눈다.
2. 출처 없는 숫자는 확인이 필요한 사실에 둔다.
3. 외부 발송 문장을 만들지 않는다.
description이 자동 호출의 기준입니다. “글쓰기 도우미”처럼 막연하면 안 불립니다.
작은 예
회의록 원문 샘플을 위 스킬에 넣으면, 정리본 샘플처럼 세 섹션이 나와야 합니다. 허구 예시입니다. 시간 절감을 측정한 결과가 아닙니다.
서브에이전트
서브에이전트 문서는 메인 대화를 검색 결과로 채우지 않으려고 별도 창에서 일하게 한다고 적습니다. .claude/agents/<이름>.md입니다. /agents 대화형 마법사는 최근 버전에서 빠졌고, 파일을 직접 쓰거나 Claude에게 만들어 달라고 하면 됩니다.
---
name: code-reviewer
description: 변경된 코드를 리뷰한다. 커밋 전이나 PR 전에 사용.
tools: Read, Grep, Glob, Bash
model: sonnet
---
git diff를 읽고 버그·보안·빠진 테스트만 보고한다. 코드를 직접 고치지 않는다.
맞는 상황: 읽을 것이 많은 탐색, 서로 독립된 작업, 도구를 제한해야 하는 역할. 서브에이전트는 메인 대화 내용을 모릅니다. 필요한 맥락을 적어 넘기십시오. 병렬로 많이 돌리면 구독 한도가 빨리 줄어듭니다.
무엇을 쓸지
- 외부 시스템인가 → MCP
- 같은 지시를 세 번 이상 반복했는가 → Skills
- 메인 대화가 파일 내용으로 지저분해지는가 → 서브에이전트
- 이 구성을 나눠 줘야 하는가 → 플러그인
권하는 도입 순서: CLAUDE.md → Skills → MCP 한두 개 → 서브에이전트. 처음부터 네 가지를 세팅하면 관리만 늘어납니다.
흔한 실수
- MCP를 너무 많이 연결하기
- Skills 설명을 막연하게 쓰기
- 서브에이전트에 맥락 없이 위임하기
자주 묻는 질문
MCP 서버를 직접 만들어야 하나요?
아닙니다. 공식 또는 검증된 서버가 있는 서비스부터 붙입니다. 사내 시스템처럼 없을 때만 직접 만듭니다.
Skills와 CLAUDE.md는요?
CLAUDE.md는 매 세션 로드, Skills는 필요할 때 로드입니다. 항상 지킬 규칙은 CLAUDE.md, 긴 절차는 Skills입니다.
코딩을 몰라도 되나요?
Skills와 서브에이전트는 마크다운입니다. MCP는 명령 한 줄인 경우가 많습니다. 파일 작성이 어색하면 Claude Code에 초안을 시켜도 됩니다.