【완벽 가이드】Claude for Desktop에서 파일 시스템 접근 기능 설정하기

【완벽 가이드】Claude for Desktop에서 파일 시스템 접근 기능 설정하기

안녕하세요! 이번 글에서는 Claude for Desktop에서 Model Context Protocol(MCP)을 사용하여 파일 시스템 접근 기능을 추가하는 방법을 자세히 안내해 드리겠습니다. 이 기능을 활용하면 Claude가 여러분의 허가를 받아 파일을 읽고, 쓰고, 이동하며 검색할 수 있어 업무 효율성이 크게 향상됩니다.

목차

1. 개요 및 주요 기능
2. 사전 준비 사항
3. 설정 방법 - 단계별 가이드
4. 기능 활용 예시
5. 안전성 및 주의사항
6. 자주 발생하는 문제 해결 방법
7. FAQ

개요 및 주요 기능

Model Context Protocol(MCP)은 Claude for Desktop에 파일 시스템 접근 기능을 추가하여 다음과 같은 작업을 가능하게 합니다:

• 지정된 폴더에서 파일 읽기
• 특정 위치에 새 파일 생성 및 저장
• 파일 이동 및 정리
• 조건에 맞는 파일 검색

이 기능은 문서 작성, 파일 정리, 데이터 검색 등 다양한 작업에서 Claude의 활용도를 높이는 데 매우 유용합니다.

사전 준비 사항

시작하기 전에 다음 사항을 확인해주세요:

1. 지원 운영체제 확인
   • ✅ macOS - 지원됨
   • ✅ Windows - 지원됨
   • ❌ Linux - 지원되지 않음
2. 필수 프로그램 설치
   • Claude for Desktop 설치
   • Node.js 설치 (npm 포함)
3. Node.js 설치 확인 방법명령어를 실행하여 버전 정보가
   • 출력되면: 설치되어 있음
   • 오류가 발생하면: Node.js 설치 필요
4. node --version

설정 방법 - 단계별 가이드

1️⃣ 설정 파일 찾기

운영체제에 따라 다음 경로에서 설정 파일을 찾습니다:

운영체제 설정 파일 경로

macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

2️⃣ 설정 파일 수정하기

1. 텍스트 에디터(메모장, VS Code 등)로 파일을 엽니다.
2. 다음 JSON 코드로 파일 내용을 완전히 교체합니다:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/사용자명/Desktop", "/Users/사용자명/Downloads"]
    }
  }
}

중요: 사용자명 부분을 실제 컴퓨터 사용자 계정명으로 변경하세요!

3️⃣ 경로 설정 팁

• macOS 예시: /Users/kim/Desktop, /Users/park/Documents
• Windows 예시: /Users/kim/Desktop 또는 C:/Users/kim/Desktop
• 경로 구분자는 슬래시(/) 사용 (Windows에서도 권장)
• 접근 허용할 폴더만 추가하세요 (보안을 위해 필요한 폴더만 지정)

4️⃣ Claude for Desktop 재시작

설정 파일을 저장한 후 Claude for Desktop을 완전히 종료하고 다시 실행합니다.

5️⃣ 설정 성공 확인

설정이 성공적으로 적용되면:

• 입력창 오른쪽 하단에 망치 아이콘(🔨)이 나타납니다.
• 이 아이콘은 파일 시스템 MCP 서버가 활성화되었음을 의미합니다.

기능 활용 예시

설정이 완료되면 다음과 같은 명령어로 Claude의 파일 시스템 접근 기능을 활용할 수 있습니다:

📝 파일 저장

내 데스크톱에 '할일목록.txt'라는 파일을 만들고 오늘 할 일을 정리해줘.

📋 파일 목록 확인

다운로드 폴더에 있는 PDF 파일만 찾아서 목록으로 보여줘.

🗂️ 파일 정리

데스크톱의 모든 이미지 파일을 'Images'라는 새 폴더로 정리해줘.

📊 데이터 분석

데스크톱에 있는 'sales_data.csv' 파일을 읽어서 월별 매출 추이를 분석해줘.

안전성 및 주의사항

파일 시스템 접근은 보안에 민감한 기능이므로 다음 사항에 주의하세요:

1. 사용자 승인 필수
   • 모든 파일 시스템 작업은 사용자의 명시적 승인이 필요합니다.
   • Claude가 파일 작업을 시도할 때 승인 창이 표시됩니다.
2. 권한 제한
   • 설정 파일에 지정한 폴더에만 접근할 수 있습니다.
   • 시스템 폴더나 중요 폴더는 접근 권한을 부여하지 마세요.
3. 신뢰할 수 있는 명령어만 사용
   • 모든 작업은 사용자 계정 권한으로 실행됩니다.
   • 파일 삭제나 이동은 신중히 요청하세요.

자주 발생하는 문제 해결 방법

망치 아이콘이 나타나지 않는 경우

1. Node.js 설치 확인
2. node --version npm --version
3. 설정 파일 문법 검사
   • JSON 형식이 올바른지 확인 (따옴표, 쉼표 등)
   • JSON Validator에서 검증해보세요
4. 경로 오류 확인
   • 경로에 특수 문자나 공백이 있는지 확인
   • 사용자명이 정확한지 확인

파일 접근이 거부되는 경우

1. 설정 파일에 경로가 포함되어 있는지 확인
   • 접근하려는 폴더가 args 배열에 명시되어 있어야 함
2. 권한 확인
   • 해당 폴더에 대한 읽기/쓰기 권한이 있는지 확인
3. 재시작 시도
   • Claude for Desktop을 완전히 종료 후 재시작

FAQ

Q: 다른 폴더도 접근할 수 있게 추가할 수 있나요?

A: 네, 설정 파일의 args 배열에 추가 경로를 넣으면 됩니다. 예를 들어:

"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/사용자명/Desktop", "/Users/사용자명/Documents", "/Users/사용자명/Pictures"]

Q: 하위 폴더도 자동으로 접근 가능한가요?

A: 네, 상위 폴더에 접근 권한을 부여하면 하위 폴더도 접근할 수 있습니다.

Q: Linux에서도 사용 가능한가요?

A: 아니요, 현재 Claude for Desktop은 Linux를 지원하지 않습니다.

Q: Claude가 내 모든 파일에 접근할 수 있나요?

A: 아니요, 설정 파일에 명시적으로 지정한 폴더에만 접근할 수 있으며, 모든 작업은 사용자의 승인이 필요합니다.

마무리

Claude for Desktop에 파일 시스템 접근 기능을 추가하면 파일 관리, 데이터 분석, 문서 작성 등 다양한 작업을 더욱 효율적으로 수행할 수 있습니다. 이 기능을 안전하게 활용하여 Claude의 활용도를 한층 높이세요!

설정 중 문제가 발생하면 공식 문제 해결 가이드를 참조하거나 댓글로 질문해 주세요. 도움이 필요하시면 언제든지 문의해 주세요!