MCP SERVER

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

dma-ai 2025. 3. 20. 17:20
728x90

【완벽 가이드】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. 필수 프로그램 설치
  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의 활용도를 한층 높이세요!

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

728x90
저작자표시 변경금지