비물
- Claude 데스크톱 앱 (설치 필요)
- Node.js (내 컴퓨터에 설치되어 있어야 npx 명령어를 사용할 수 있습니다.)
[실습] 로컬 파일시스템 MCP 서버 연결하기1단계: 설정 파일(Config) 열기 Claude 데스크톱 앱이 MCP 서버를 인식하려면 특정 경로에 있는 설정 파일(claude_desktop_config.json)을 수정해야 합니다. 아래 경로에 해당 파일이 있는지 확인하거나 새로 생성하세요.
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2단계: 연결 코드(JSON) 입력 설정 파일을 메모장이나 코드 에디터(VS Code 등)로 열고, 아래 코드를 그대로 붙여넣으세요. (주의: args의 마지막 부분인 경로 "C:\\Users\\..."는 실제 본인이 연결하고 싶은 폴더 경로로 수정해야 합니다.)
{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\User\\Documents\\MyProject" ] } } }
- 해석: "Claude야, filesystem이라는 이름의 서버를 켜줘. 이 서버는 npx를 통해 실행되고, 내 컴퓨터의 MyProject 폴더를 바라보고 있어."라는 뜻입니다.
3단계: 재시작 및 연결 확인
- Claude 데스크톱 앱을 완전히 껐다가 다시 실행합니다.
- 입력창 우측에 **'플러그(콘센트) 아이콘'**이 생겼는지 확인합니다.
- 채팅창에 이렇게 물어보세요.
"지금 연결된 폴더 안에 무슨 파일이 있어? 리스트를 보여주고 첫 번째 파일 내용을 요약해줘."
"지금 연결된 폴더 안에 무슨 파일이 있어? 리스트를 보여주고 첫 번째 파일 내용을 요약해줘."
4단계: 결과
Claude가 실제로 내 하드디스크에 있는 파일을 읽고 답변을 해준다면 MCP 서버 구축(PoC)에 성공하신 겁니다. | 