14편까지 따라오셨다면 Claude Code가 파일을 읽고 수정하는 건 이미 해보셨을 겁니다. 그런데 "내 구글 캘린더 일정을 AI가 확인해주면 좋겠는데", "특정 폴더의 파일만 AI한테 보여주고 싶은데" 같은 생각이 드셨을 수 있습니다. 그 연결 통로가 바로 MCP입니다.
MCP가 뭔가요? (30초 복습)
MCP는 Model Context Protocol의 약자입니다. 이름이 어려워 보이지만 하는 일은 단순합니다. AI와 외부 서비스 사이의 통역사 역할입니다.
스마트폰 비유로 설명하면 이렇습니다. 스마트폰(Claude Code)이 블루투스 이어폰(외부 서비스)과 대화하려면 블루투스라는 통신 규약이 필요합니다. MCP가 바로 그 블루투스입니다. Claude Code와 외부 서비스가 서로 대화할 수 있게 만들어주는 규약이에요.
| 스마트폰 세계 | Claude Code 세계 |
|---|---|
| 블루투스 (통신 규약) | MCP (Model Context Protocol) |
| 블루투스 이어폰, 스피커 등 (기기) | MCP 서버 (파일 시스템, 캘린더, DB 등) |
| 블루투스 설정 화면에서 기기 페어링 | settings.json 파일에서 MCP 서버 등록 |
| 페어링 완료 후 음악 재생 | 등록 완료 후 자연어로 명령 |
더 자세한 개념 설명은 MCP가 뭔가요? 글에서 확인할 수 있습니다. 이 글에서는 실제 설정 방법에 집중합니다.
MCP 서버 설정하는 법
MCP 서버를 연결하는 방법은 settings.json이라는 설정 파일을 수정하는 겁니다. 이 파일에 "어떤 서버를 쓸 것인지" 적어주면 Claude Code가 알아서 연결합니다.
설정 파일 위치 두 가지
| 위치 | 경로 | 적용 범위 |
|---|---|---|
| 사용자 전체 (글로벌) | ~/.claude/settings.json |
내 컴퓨터에서 Claude Code를 쓸 때 항상 적용 |
| 프로젝트별 | .claude/settings.json (프로젝트 폴더 안) |
해당 프로젝트에서만 적용 |
처음이라면 사용자 전체 설정(~/.claude/settings.json)에 추가하는 걸 추천합니다. 어떤 프로젝트를 열든 항상 사용할 수 있으니까요.
프로젝트 폴더 안의
.claude/settings.json에 MCP 설정을 넣으면 Git으로 버전 관리가 됩니다. 팀원과 같은 MCP 환경을 공유하고 싶을 때 유용합니다.
설정 파일 형식
settings.json 안에 "mcpServers"라는 항목을 추가합니다. 형식은 이렇습니다.
각 항목이 뭔지 풀어보면 이렇습니다.
- "서버이름" — 내가 알아볼 수 있는 이름. 자유롭게 정하면 됩니다.
- "command" — MCP 서버를 실행하는 명령어.
- "args" — 명령어에 전달할 추가 정보 (어떤 폴더를 연결할지 등).
실습: 파일 시스템 MCP 서버 연결하기
가장 이해하기 쉬운 예시로 시작합니다. 내 컴퓨터의 특정 폴더를 Claude Code에 연결하는 겁니다. 예를 들어 "문서 폴더 안의 파일들을 AI가 읽고 정리해줬으면 좋겠다"는 상황입니다.
1 settings.json 파일 열기
사용자 설정 파일을 엽니다. 경로는 ~/.claude/settings.json입니다.
파일이 아직 없다면 새로 만들면 됩니다. 이미 있다면 기존 내용에 "mcpServers" 항목을 추가합니다.
2 MCP 서버 설정 추가하기
파일 시스템 MCP 서버를 등록합니다. 아래 내용을 settings.json에 넣습니다.
/Users/내이름/Documents 부분을 실제 연결하고 싶은 폴더 경로로 바꿔주세요. Windows라면 C:/Users/내이름/Documents 형태입니다.
3 Claude Code 재시작
설정을 저장한 후 Claude Code를 다시 시작합니다. MCP 서버는 Claude Code가 시작될 때 로드됩니다.
4 연결 확인하기
Claude Code 안에서 /mcp를 입력합니다.
현재 연결된 MCP 서버 목록이 표시됩니다. 방금 추가한 "my-files"가 보이면 성공입니다.
5 사용해보기
자연어로 바로 써볼 수 있습니다.
Claude Code가 MCP 서버를 통해 해당 폴더의 파일 목록을 읽어와서 보여줍니다.
Node.js 패키지를 실행하는 명령어입니다.
npx -y는 "해당 패키지를 자동으로 다운로드해서 실행해줘"라는 뜻입니다. Node.js가 설치되어 있어야 동작합니다. 3편(설치 가이드)에서 Node.js 설치를 다뤘으니 참고하세요.
어떤 MCP 서버가 있나요?
파일 시스템 외에도 다양한 MCP 서버가 커뮤니티에서 만들어지고 있습니다. 비개발자 입장에서 쓸모를 느낄 수 있는 방향으로 정리했습니다.
| 용도 | 연결 대상 | 할 수 있는 일 |
|---|---|---|
| 파일 관리 | 내 컴퓨터 폴더 | 특정 폴더의 파일 읽기, 정리, 검색 |
| 일정 관리 | Google Calendar 등 | 일정 확인, 추가, 수정 |
| 데이터베이스 | PostgreSQL, SQLite 등 | 데이터 조회, 분석, 보고서 생성 |
| 클라우드 저장소 | Google Drive 등 | 클라우드 파일 검색, 읽기 |
| 메신저 | Slack 등 | 메시지 읽기, 보내기 |
| 이메일 | Gmail 등 | 이메일 검색, 초안 작성 |
MCP 서버는 계속 늘어나고 있습니다. 설정 방식은 모두 동일합니다. settings.json의 "mcpServers" 안에 서버 정보를 추가하면 끝입니다.
파일 시스템 서버는 폴더 경로만 적으면 되지만, Google Calendar 같은 서비스는 API 인증(OAuth) 과정이 필요합니다. 각 서버의 안내 문서를 따라가면 됩니다. 어렵게 느껴진다면 파일 시스템 서버부터 시작하는 걸 추천합니다.
여러 MCP 서버를 동시에 쓰는 법
MCP 서버는 하나만 쓸 수 있는 게 아닙니다. settings.json에 여러 개를 나란히 적으면 됩니다.
블루투스 이어폰과 블루투스 스피커를 동시에 페어링하는 것과 같습니다. 각각 다른 이름을 붙여주면 Claude Code가 상황에 맞는 서버를 자동으로 골라 사용합니다.
실전 활용 예시:
"Documents 폴더에서 회의록 파일 찾아서 내용 요약해줘" — 파일 시스템 MCP 사용
"데이터베이스에서 이번 달 매출 합계 구해줘" — 데이터베이스 MCP 사용
어떤 MCP 서버를 사용할지는 Claude Code가 질문 내용을 보고 자동으로 판단합니다.
자주 묻는 질문 (FAQ)
Q. MCP 서버를 설치하면 내 파일이 외부로 유출되나요?
MCP 서버는 내 컴퓨터에서 로컬로 실행됩니다. Claude Code와 MCP 서버 사이의 통신은 내 컴퓨터 안에서 이루어지기 때문에, 파일이 외부 서버로 전송되는 건 아닙니다. 다만 Claude Code가 파일 내용을 읽어서 AI 모델에 전달하는 과정에서 Anthropic 서버와 통신은 발생합니다. 민감한 파일은 연결 폴더에서 제외하는 게 좋습니다.
Q. settings.json을 잘못 수정하면 Claude Code가 망가지나요?
JSON 형식이 깨지면 (예: 쉼표를 빠뜨리거나, 중괄호를 안 닫거나) Claude Code가 설정을 읽지 못할 수 있습니다. 그래도 Claude Code 자체가 망가지는 건 아닙니다. 설정 파일을 수정하기 전에 원본을 백업해두면 안심입니다. 문제가 생기면 원본으로 되돌리면 됩니다.
Q. /mcp 명령어를 쳤는데 아무것도 안 나와요.
settings.json에 MCP 서버를 아직 등록하지 않았거나, 파일 경로가 잘못된 경우입니다. 설정 파일 위치(~/.claude/settings.json)와 JSON 형식을 다시 확인해보세요. 수정 후에는 반드시 Claude Code를 재시작해야 적용됩니다.
정리하며
관점 한 스푼: MCP를 처음 접하면 "설정 파일을 직접 수정해야 한다고?" 하면서 겁이 날 수 있습니다. 그런데 한 발짝 물러서 보면, 우리가 하는 일은 settings.json에 "이 서비스를 연결해줘"라고 적어주는 것뿐입니다. 와이파이 비밀번호를 입력하는 것과 크게 다르지 않습니다. 한번 연결해두면 그 다음부터는 말만 하면 됩니다. "파일 찾아줘", "일정 확인해줘" 이런 식으로요. AI가 내 도구들과 연결되는 순간, 단순한 대화 상대에서 진짜 비서로 바뀝니다. 첫 연결은 파일 시스템 서버 하나로 시작해보세요. 그게 가장 쉽고, 가장 확실하게 체감됩니다.
다음 편에서는 AI가 위험한 일을 못하게 막는 권한 설정법을 다룹니다
16편 보러 가기 →
참고 자료
· Anthropic Claude Code 공식 문서 — docs.anthropic.com
· Model Context Protocol 공식 사이트 — modelcontextprotocol.io
댓글
댓글 쓰기