개념·비교 실습 예시

먼저 하려는 일을 동사 중심으로 풀어 쓴다. 동사마다 "외부에서 데이터를 가져오는가" 아니면 "정해진 규칙대로 가공/작성하는가"를 표시하면 경계가 드러난다.

작업: Notion 회의록을 [가져와서] 주간 리포트를 [작성한다]
  - 가져온다  → 외부 SaaS(Notion)에 실시간 접근  → 연결 문제
  - 작성한다  → 회사 리포트 형식·말투·섹션 규칙 적용 → 절차 문제

Notion처럼 Claude 바깥에 있는 시스템에서 데이터를 실시간으로 읽어 오는 일은 표준 연결 프로토콜인 MCP의 몫이다. Notion MCP 서버가 tools/call로 페이지를 조회해 그 내용을 컨텍스트로 넘겨준다. 외부 인증(OAuth 등)과 API 호출이 끼면 거의 항상 MCP다.

# Notion 연동은 MCP 서버를 등록해 처리
claude mcp add --transport http notion https://mcp.notion.com/mcp

가져온 회의록을 "우리 회사 주간 리포트는 이런 섹션 순서, 이런 말투, 이런 길이"라는 조직 고유의 규칙으로 다듬는 일은 외부 연결이 필요 없다. 이렇게 반복되는 절차와 전문성은 SKILL.md 한 폴더에 담아 두는 Skill로 푼다.

.claude/skills/weekly-report/SKILL.md
  ├─ frontmatter: name, description("주간 리포트를 작성할 때 사용")
  └─ 본문: 섹션 순서 · 말투 · 분량 · 예시 템플릿

"Jira에서 이번 스프린트 이슈를 가져와 줘" 같이 Claude 외부의 SaaS·DB·API에 실시간 접근해야 하는 일. 인증과 네트워크 호출이 필수이므로 표준 연결 프로토콜인 MCP가 정답이다. 외부 의존이 있는 순간 Skill 단독으로는 풀 수 없다.

판정: MCP
근거: 외부 시스템 실시간 조회 + 인증 필요 → 연결 계층

"우리 회사 보도자료는 항상 이 구조, 이 톤으로 써 줘" 같이 조직 고유의 절차·전문성을 주입하는 일. 외부 데이터가 필요 없고 마크다운 지침으로 자기완결되므로 Skill이 정답이다. description에 "보도자료를 작성할 때"라는 트리거를 명시하는 게 핵심.

판정: Skill
근거: 외부 연결 없음 + 반복되는 작성 규칙·전문성 패키징 → 절차 계층

"이 사내 데이터 연동을 Claude Code뿐 아니라 Cursor, VS Code에서도 똑같이 쓰고 싶다"는 요구. MCP는 오픈 표준이라 여러 클라이언트가 같은 서버를 공유할 수 있다. 반면 Skill은 Anthropic 제품 전용이라 여러 클라이언트 간 재사용이 불가능하다 — 이 점이 결정적 분기점이다.

판정: MCP
근거: 여러 클라이언트가 동일 서버 재사용 → 표준화·이식성은 MCP만 가능

"검증된 데이터 정리용 파이썬 스크립트를 묶어 두고 정해진 순서로 돌리게 하고 싶다"는 요구. 스크립트·리소스를 한 폴더에 번들하고 점진 공개로 필요할 때만 읽게 하는 것은 Skill의 전형이다. 스크립트는 코드 전체가 아니라 실행 출력만 컨텍스트로 들어와 토큰도 아낀다.

판정: Skill
근거: 자기완결 스크립트·리소스 번들 + 외부 의존 없음 → 절차 계층

"Salesforce에서 고객 데이터를 뽑아 회사 표준 PPTX 보고서로 만들어 줘"처럼 외부 조회와 정형 산출물 생성이 함께 있는 일. 조회는 MCP, 형식·규칙은 Skill이 맡아 조합하는 것이 가장 깔끔하다. 한쪽으로 무리하게 욱여넣지 않는 게 요령이다.

판정: MCP + Skill
근거: 외부 조회(MCP) + 조직 형식 적용·문서 생성(Skill) → 책임 분리

고객 데이터의 출처인 Salesforce는 외부 SaaS이므로 MCP로 연결한다. 원격 HTTP 트랜스포트와 OAuth 인증으로 등록하면 tools/call을 통해 실시간으로 분기 매출·계약 데이터를 조회할 수 있다. 데이터 스키마가 바뀌어도 이 서버만 손보면 된다.

claude mcp add --transport http salesforce https://example-sf-mcp/mcp
# 등록 확인
claude mcp get salesforce

"분기 리포트는 어떤 섹션을, 어떤 순서로, 어떤 차트와 함께"라는 회사 고유 형식을 Skill로 정의한다. 이 Skill의 본문은 PPTX 생성 절차를 안내하되, 실제 슬라이드 변환은 Anthropic 기본 pptx 스킬에 위임한다. 형식 정책이 바뀌면 이 폴더만 고치면 된다.

.claude/skills/quarterly-report/SKILL.md
---
name: quarterly-report
description: 분기 영업 리포트를 PPTX로 만들 때 사용. 회사 표준 섹션·차트 규칙 적용.
---
# 본문: 표지 → 요약 → 매출 추이 → 핵심 계약 → 리스크 순서, pptx 스킬로 렌더

사용자가 분기 리포트를 요청하면 description 트리거로 리포트 Skill이 켜지고, 그 절차가 "최신 데이터가 필요하다"는 지점에서 Salesforce MCP tool을 호출한다. 받아 온 데이터를 회사 형식 규칙으로 구성한 뒤 pptx 스킬이 최종 파일을 만든다.

# 사용자 요청 한 줄로 전체 흐름이 작동
"2026년 2분기 영업 리포트를 표준 양식으로 만들어 줘"