미분류 973 - naver.HOW data lake by AI

Claude 데스크톱 앱에서 로컬 파일시스템에 접근할 수 있도록 MCP(Model Context Protocol) 서버를 설정하는 방법을 안내합니다. 이 설정을 통해 Claude가 특정 디렉토리의 파일을 읽고 관리할 수 있게 됩니다.

필요 사항

Claude 데스크톱 앱 (최신 버전)
Node.js 및 npm이 설치된 환경 (MCP 서버 실행에 필요)
터미널 사용 기본 지식

설정 단계

1. 접근 허용할 디렉토리 생성하기

먼저 Claude가 접근할 디렉토리를 생성합니다. 이 예제에서는 홈 디렉토리 아래 src 폴더를 사용합니다.

mkdir -p ~/src

2. Claude 설정 파일 디렉토리 확인

Claude 설정 파일이 저장될 디렉토리를 확인합니다. macOS의 경우:

ls -la ~/Library/Application\ Support/Claude

만약 디렉토리가 존재하지 않는다면 생성합니다:

mkdir -p ~/Library/Application\ Support/Claude

3. MCP 서버 설정 파일 생성하기

다음 명령어로 설정 파일을 생성하고 텍스트 에디터로 엽니다:

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

4. 설정 파일에 내용 추가하기

아래 JSON 내용을 파일에 붙여넣습니다. username 부분은 본인의 macOS 사용자 이름으로 변경하세요:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/src"
      ]
    }
  }
}

예를 들어, 사용자 이름이 ‘junhoha’인 경우:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/junhoha/src"
      ]
    }
  }
}

5. 설정 저장 및 적용

텍스트 에디터에서 파일을 저장하고 닫습니다.

nano 에디터의 경우: Ctrl+O → Enter → Ctrl+X
vi/vim 에디터의 경우: :wq → Enter

6. Claude 데스크톱 앱 재시작

Claude 데스크톱 앱을 완전히 종료한 후 다시 실행합니다:

메뉴에서 Claude > 종료(Quit)
앱이 완전히 종료되었는지 확인
Claude 앱을 다시 실행

7. 설정 확인하기

Claude와의 대화에서 다음과 같이 입력하여 설정이 제대로 적용되었는지 확인합니다:

~/src에 무엇이 있나요?

문제 해결

설정이 제대로 적용되지 않는 경우 다음을 확인해보세요:

설정 파일의 JSON 형식이 올바른지 확인
경로가 정확한지 확인 (/Users/username/src)
Node.js와 npm이 설치되어 있는지 확인
앱을 완전히 재시작했는지 확인
로그 파일 확인 (~/Library/Logs/Claude/ 디렉토리)

추가 팁

MCP 서버를 통해 접근 가능한 다른 디렉토리도 추가할 수 있습니다 (보안상 필요한 디렉토리만 추가 권장)
테스트 파일을 ~/src 디렉토리에 추가하여 Claude가 접근할 수 있는지 확인해보세요
파일 내용을 확인하기 위한 명령어: ls -la ~/src나 cat ~/src/파일명

보안 고려사항

민감한 정보가 있는 디렉토리는 접근 허용하지 마세요
필요한 디렉토리만 선택적으로 접근 권한을 부여하세요

이 설정을 통해 Claude가 지정된 디렉토리의 파일에 접근할 수 있게 되어, 코드 리뷰, 파일 분석, 문서 작업 등에 더욱 효과적으로 도움을 받을 수 있습니다.

[카테고리:] 미분류

Claude MCP