개념확장 3종
무엇을 어디에 담을 것인가
규칙과 능력을 주는 방법은 하나가 아닙니다. 항상 알아야 할 사실, 외부 시스템 연결, 가끔 필요한 절차, 반드시 지켜야 할 통제는 각각 다른 곳에 담아야 합니다.
| 도구 | 담는 것 | 로드 시점 | 강제력 |
|---|---|---|---|
| CLAUDE.md | 항상 알아야 할 사실 | 세션 시작 시 항상 | 맥락 — 확률적 |
| MCP | 외부 시스템 연결 | 서버가 붙어 있는 동안 | 도구 — 실제 동작 |
| 스킬 | 절차적 작업 | 호출될 때만 | 맥락 — 확률적 |
| 훅 | 반드시 지킬 통제 | 도구 호출 시 자동 | 코드 — 100% 확정 |
MCP무엇인가
외부 도구를 Claude에 붙이기
MCP(Model Context Protocol)는 Claude를 외부 시스템에 연결하는 공개 표준입니다. 지라 이슈를 복사해 붙여넣고, 결과를 다시 옮겨 적던 일을 Claude가 직접 합니다.
붙일 때를 아는 법같은 도구에서 데이터를 복사해 채팅에 붙여넣고 있다면 — 그게 MCP로 연결할 신호입니다.
| 연결 대상 | 할 수 있게 되는 일 |
|---|---|
| 이슈 트래커 | "ENG-4521에 적힌 기능을 구현하고 PR 올려줘" |
| 모니터링 | "어제 오류가 늘어난 원인을 지표에서 찾아줘" |
| 데이터베이스 | "이 기능을 쓴 사용자 10명을 뽑아줘" |
| 문서 사이트 | "훅 설정하는 법을 공식 문서에서 찾아줘" |
실습연결하기
서버 하나 붙여보기
아래는 Claude Code 공식 문서를 검색·조회하는 읽기 전용 서버입니다. 붙여두면 추측 대신 실제 문서를 읽고 답합니다.
claude mcp add --transport http claude-docs https://code.claude.com/docs/mcp
| 부분 | 뜻 |
|---|---|
| mcp add | 서버를 등록 |
| --transport http | 원격 HTTP 서버로 연결. 내 PC에서 프로세스를 띄우는 방식은 stdio |
| claude-docs | 내가 정하는 이름. 이후 목록과 도구 이름에 붙습니다 |
| https://… | 서버 주소 |
등록됐는지 확인하고, 세션 안에서는 /mcp로 봅니다.
claude mcp list
저장 위치는 --scope로 정합니다 — 생략하면 나만, project는 .mcp.json에 저장돼 팀과 공유, user는 내 모든 프로젝트에 적용됩니다.
claude mcp add --scope project --transport http claude-docs https://code.claude.com/docs/mcp
신뢰MCP 서버의 도구는 내 데이터를 읽고 외부로 보낼 수 있습니다. 출처가 분명한 서버만 추가하고, 팀 공유(project)로 넣을 때는 더 신중하세요.
- MCP가 필요한 순간을 복사·붙여넣기로 판별할 수 있다
- 서버를 하나 연결하고 claude mcp list로 확인했다
- --scope 세 가지의 차이를 안다
클로드코드 시작하기트랙 B · 개발자