AI에 내 일하는 방식을 붙이는 법: 스킬과 MCP, 원화 검사 스킬을 직접 만들어봤어요

AI한테 매번 같은 설명을 붙여넣고 있다면, 그 설명을 AI 쪽에 붙여둘 때가 됐어요. Claude Code 기준으로 AI에 기능을 붙이는 방법은 크게 세 가지예요. 저희 사이트 규칙인 "달러 옆에 원화 쓰기"를 검사하는 스킬을 직접 만들어 붙여봤어요.

세 가지 방법

스킬: 일하는 방법을 적어둔 설명서예요. 같은 지침이나 체크리스트를 자꾸 붙여넣을 때 써요
MCP: AI가 다른 서비스에 손을 뻗게 해줘요. Notion이나 이슈 트래커 내용을 복사해 붙이고 있을 때 써요
플러그인: 스킬, MCP, 설정을 한 상자에 묶어 팀에 나눠줄 때 써요

AI에 기능을 붙이는 세 가지 방법. 스킬은 업무 설명서로 같은 지침을 자꾸 붙여넣을 때, MCP는 손으로 다른 서비스 내용을 복사해 붙일 때, 플러그인은 묶음 상자로 팀에 한꺼번에 나눠줄 때 써요

스킬은 폴더 하나면 돼요

프로젝트의 .claude/skills/won-check/ 폴더에 SKILL.md를 만들었어요. 내 모든 프로젝트에서 쓰려면 ~/.claude/skills/에 두면 돼요.

---
name: won-check
description: >
  달러 금액에 원화가 같이
  적혔는지 검사해요. 글을
  검토할 때 쓰세요.
allowed-tools: Bash(python3 *)
---
 
1. 이 스킬 폴더의
   scripts/find_usd.py를
   python3로 실행해요.
2. 찾은 줄마다 고친 문장을
   제안해요. 1달러=1,400원,
   "15달러(약 2만 1천원)"처럼.
3. 없으면 "문제 없음"만 써요.

description이 제일 중요해요. Claude는 평소엔 이 설명만 들고 있다가, 일이 맞아 보이면 그때 본문을 읽어요
같은 폴더의 scripts/find_usd.py는 달러 금액 뒤에 '원'이 없으면 줄 번호를 알려주는 9줄짜리 파이썬이에요. 스크립트는 읽히지 않고 실행만 돼요
/won-check draft.md처럼 직접 부를 수도 있어요

붙이기 전과 후, 직접 돌려봤어요

달러 금액 4개 중 3개에 원화가 빠진 6줄짜리 글로 시험했어요. 모델은 Sonnet, Claude Code 2.1.296이에요.

조건	결과
스킬 없이 3번	매번 빠진 곳을 짚었지만, 함께 낸 지적이 5–7개로 매번 달랐어요
스킬 붙이고 4번	4번 모두 스킬을 스스로 불러 스크립트를 돌렸고, 3곳을 같은 형식으로 고쳤어요
`/won-check`로 직접	똑같이 3곳을 찾았어요

시간은 한 번에 8–13초, 값은 20–80원 정도로 스킬이 있든 없든 비슷했어요. 짧은 글이라 스킬 없이도 잘 잡았어요. 스킬의 장점은 더 똑똑해지는 게 아니라 매번 같은 기준과 형식으로 답한다는 거예요.

자동 실행에선 허락이 하나 더 필요해요

claude -p처럼 사람이 없는 자동 실행에서는 스킬을 부르는 것 자체를 허락해야 했어요. 처음에 --allowedTools Read만 줬더니 스킬 호출이 막혔는데, AI는 "스킬에 오류가 났다"며 직접 읽고 답을 냈어요. 답은 그럴듯해서 실패한 줄 모르고 넘어가기 쉬워요. Skill을 허락 목록에 넣으니 제대로 돌았어요.

claude -p "draft.md 검토해줘" \
  --allowedTools Read Skill

MCP로 다른 서비스 붙이기

MCP는 명령 한 줄로 붙여요. 예를 들어 Notion은 이렇게 연결하고, Claude Code 안에서 /mcp로 로그인해요.

claude mcp add --transport http \
  notion https://mcp.notion.com/mcp

기본은 나만 쓰는 설정이에요. --scope project를 붙이면 프로젝트의 .mcp.json에 저장돼 팀이 같이 써요
토큰 같은 비밀 값은 .mcp.json에 직접 쓰지 말고 환경 변수로 넘기세요
믿을 수 없는 서버는 붙이지 마세요. 외부 글을 가져오는 서버는 AI를 속이는 문장이 섞여 들어올 수 있어요
MCP는 공개 규격이라 GitHub Copilot, Codex 같은 다른 도구에서도 써요

이번엔 MCP 서버를 직접 붙여보진 않았고, 위 내용은 공식 문서 기준이에요. 직접 AI 프로그램을 만들 때 어디까지 만들어야 하는지는 하네스 기사에 정리했어요.

짚어둘 것

스킬 실험은 제가 직접 돌린 결과예요. 시간과 값은 Claude Code가 집계한 값이라 기본 지시문까지 포함돼 있고, 캐시 상태에 따라 달라져요. 환율은 1달러 1,400원 기준이에요
스킬 폴더 위치, allowed-tools 문법, MCP 명령은 Claude Code 공식 문서와 claude mcp add --help로 확인했어요
다른 도구의 MCP 지원은 각 회사 문서 기준이고, 직접 써보진 않았어요

여러분은 AI한테 어떤 설명을 제일 자주 붙여넣어요? 카톡 오픈채팅 ⚡ AI랑 코딩하는 사람들에서 이야기 나눠요.

참고