Claude에 로컬 파일 연결하는 법 — Filesystem MCP 설정부터 문서 요약·파일 정리까지
제 바탕화면은 솔직히 말하면… 전쟁터예요. 😅 "나중에 정리하지" 하고 던져둔 파일들, 이름도 제각각인 보고서들, 버전별로 쌓인 문서들이 뒤엉켜 있어요. 분명히 저장해뒀는데 막상 필요할 때 어디 있는지 몰라서 5분씩 찾아 헤매는 일이 한두 번이 아니었고요.
그런데 Filesystem MCP 서버를 Claude Desktop에 연결하고 나서 이 상황이 꽤 달라졌어요. "다운로드 폴더에서 지난달 보고서 찾아줘", "이 폴더 안 파일들 목록 정리해줘", "계약서 초안 파일 읽고 핵심 조건만 요약해줘" — 이런 걸 말로 그냥 시키면 되니까요. 오늘은 이 Filesystem MCP 서버를 설정하고 활용하는 법을 완전히 정리해 드릴게요! 🗂️
Filesystem MCP 서버로 뭘 할 수 있나요? 📂
Filesystem MCP 서버는 Claude가 내가 허용한 특정 폴더 안의 파일들을 직접 읽고 탐색할 수 있게 해주는 MCP 서버예요. 클라우드 연동이 필요 없고, 인터넷을 통해 파일이 외부로 나가는 것도 아니에요. 완전히 내 PC 안에서 로컬로 작동하는 방식이라 보안 걱정도 덜해요.
한 가지 미리 알아두면 좋은 점이 있어요. Filesystem MCP 서버는 기본적으로 텍스트 기반 파일에 특히 강해요. txt, md, csv, json, html, 코드 파일 등을 직접 읽을 수 있고, PDF나 docx처럼 바이너리 형식의 파일은 내용 읽기보다는 파일명이나 폴더 구조 파악에 주로 쓰이는 편이에요.
Filesystem MCP 주요 기능 한눈에 보기
| 기능 | 설명 | 활용 예시 |
|---|---|---|
| 파일 읽기 | 텍스트 기반 파일 내용 조회 | "이 마크다운 파일 내용 요약해줘" |
| 디렉토리 탐색 | 폴더 구조 및 파일 목록 조회 | "프로젝트 폴더 구조 파악해줘" |
| 파일 검색 | 이름 패턴으로 파일 탐색 | "report 포함된 파일 다 찾아줘" |
| 파일 쓰기 | 새 파일 생성 및 내용 저장 | "요약 결과를 txt 파일로 저장해줘" |
| 파일 이동·복사 | 파일 위치 변경 및 복제 | "2023 파일들 archive 폴더로 이동해줘" |
Filesystem MCP 서버는 내가 설정에서 지정한 폴더 범위 안에서만 동작해요. 그 범위 밖의 파일에는 접근 자체가 불가능하므로, 처음부터 허용 폴더를 신중하게 정해두는 게 핵심이에요.
STEP 1 — 허용 폴더 미리 설계하기 🗺️
설정 파일을 건드리기 전에 딱 한 가지를 먼저 정해야 해요. "Claude가 어느 폴더까지 볼 수 있게 할 것인가?" 이 결정이 보안의 핵심이에요. 처음 설정할 때 욕심내서 너무 넓게 열어두면 나중에 후회할 수 있어요.
📋 폴더 범위 설계 가이드
- 추천 ✅ — 업무 전용 폴더:
~/Documents/Work처럼 특정 용도 폴더만 지정. 필요한 것만 열어두는 최소 권한 원칙. - 추천 ✅ — 프로젝트 단위 폴더: 현재 작업 중인 프로젝트 폴더만 지정해 두고, 끝나면 다른 폴더로 교체하는 방식.
- 주의 ⚠️ — 홈 디렉토리 전체:
~/혹은C:\Users\이름전체를 여는 건 비밀번호·개인정보 파일까지 노출될 수 있어서 권장하지 않아요. - 금지 🚫 — 루트 디렉토리:
/또는C:\— 시스템 파일까지 열리게 되니 절대 지정하지 마세요.
저 같은 경우엔 ~/Documents/AI-workspace 라는 폴더를 하나 새로 만들었어요. Claude와 함께 작업할 파일들을 여기에 모아두는 거예요. 이렇게 하면 범위가 명확하고 관리도 훨씬 쉬워요!
STEP 2 — 설정 파일에 Filesystem MCP 추가하기 ⚙️
허용 폴더가 정해졌다면 이제 claude_desktop_config.json 파일을 열어서 Filesystem MCP 서버를 추가할 차례예요. 파일 위치는 macOS는 ~/Library/Application Support/Claude/, Windows는 %APPDATA%\Claude\ 안에 있어요.
📝 macOS 설정 예시
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/홍길동/Documents/AI-workspace"
]
}
}
}
👆 마지막 경로를 STEP 1에서 결정한 실제 폴더 경로로 바꿔주세요.
📝 Windows 설정 예시
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\홍길동\\Documents\\AI-workspace"
]
}
}
}
👆 Windows는 역슬래시를 반드시 이중(\\\\ )으로 써야 해요! 이게 가장 흔한 실수예요.
args 배열에 폴더 경로를 여러 개 나란히 추가하면 돼요. 예를 들어 Documents와 Desktop 두 곳을 동시에 허용하려면:
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/이름/Documents", "/Users/이름/Desktop"]이렇게 뒤에 경로를 계속 추가해주면 됩니다!
설정 파일 저장 후 Claude Desktop을 완전히 종료했다가 재실행하면 채팅창에 🔨 망치 아이콘이 나타나요. 아이콘을 눌러 Filesystem 관련 툴이 목록에 보이면 연결 성공이에요! 🎉
설정 후 망치 아이콘이 보이지 않는다면 JSON 문법 오류를 먼저 확인하세요. jsonlint.com에 설정 내용을 붙여넣으면 오류 위치를 바로 찾을 수 있어요. 쉼표 하나, 따옴표 하나가 빠져도 전체가 작동하지 않아요.
실전 활용 — 이런 식으로 써보세요! 🚀
연결만 해두면 뭘 할 수 있는지, 제가 실제로 가장 많이 쓰는 활용 패턴 다섯 가지를 소개할게요. 말 그대로 "이런 말을 Claude에게 하면 된다"는 형식으로요!
📄 활용 1 — 문서 빠른 요약
긴 보고서나 회의록을 읽어야 할 때:
→ Claude가 파일을 직접 열어 읽고 핵심을 뽑아줘요. 수십 페이지 문서도 1분 안에 정리 완료!
🔍 활용 2 — 파일 검색 & 목록 정리
어디 있는지 모르는 파일을 찾을 때:
→ 파일 탐색기를 뒤지지 않아도 돼요. 원하는 키워드로 Claude에게 말하면 바로 목록이 나와요.
🗃️ 활용 3 — 폴더 구조 파악 & 정리 계획
오래된 프로젝트 폴더를 정리해야 할 때:
→ 폴더 전체를 탐색해 현황을 파악하고, 어떻게 정리하면 좋을지 제안까지 받을 수 있어요.
✍️ 활용 4 — 여러 파일 내용 비교 분석
버전별 문서 차이를 빠르게 비교할 때:
→ 두 파일을 동시에 읽어 차이점을 분석해줘요. 문서 버전 관리에 아주 유용해요!
💾 활용 5 — 분석 결과를 파일로 저장
Claude가 정리해준 결과물을 파일로 남기고 싶을 때:
→ 대화 결과를 그대로 내 PC 파일로 저장해줘요. 복사·붙여넣기 없이 바로 문서화 가능!
핵심 내용 정리 📝
오늘 내용을 다시 한번 간추려 볼게요!
- 허용 폴더 설계 먼저: 루트나 홈 전체 대신, 목적에 맞는 특정 폴더만 지정하는 최소 권한 원칙을 지켜요.
- 설정 파일 추가: claude_desktop_config.json의 args에 허용 폴더 경로를 입력. Windows는 역슬래시 이중 표기 필수.
- 완전 재시작 후 확인: 망치 아이콘과 Filesystem 툴 목록으로 연결 성공 여부 확인.
- 문서 요약·파일 검색·폴더 정리: 말로 시키면 Claude가 직접 폴더를 열어서 처리해줘요.
- 결과 파일 저장까지: 분석·요약 결과를 내 PC 파일로 바로 저장할 수 있어요.
Filesystem MCP 서버 핵심 요약 카드
자주 묻는 질문 ❓
파일 하나 찾겠다고 탐색기를 뒤지고, 긴 문서를 처음부터 끝까지 읽으면서 핵심을 찾던 시간들이 이제 꽤 많이 줄었어요. 뭐랄까, AI에게 "이 폴더 좀 봐줘"라고 말하는 게 이렇게 자연스러워질 줄은 몰랐어요. 😄 처음엔 작은 테스트 폴더 하나부터 연결해보고, 익숙해지면 조금씩 범위를 넓혀가는 방식으로 시작하시길 추천드려요. 써보고 어떠셨는지 댓글로 공유해 주시면 저도 너무 궁금하고 반가울 것 같아요! 🗂️