Filesystem MCP 서버 설정 — 클로드에 내 폴더·파일 연결하기 (2026)

Filesystem MCP 서버는 내 컴퓨터에서 지정한 폴더 안에 한해 클로드가 파일을 읽고 쓰게 해 주는 공식 레퍼런스 서버입니다. 설정이 간단해 처음 다뤄 보는 MCP 서버로 가장 많이 쓰입니다. 설치·연결·안전 설정을 정리합니다.

무엇을 하나

허용한 디렉터리 범위에서 파일 읽기·쓰기·검색·이동 같은 작업을 도구로 제공합니다. 핵심은 허용한 폴더만 접근한다는 점입니다 — 범위를 좁게 잡는 것이 안전의 기본입니다.

설치 — Claude Desktop (NPX)

Node.js가 설치돼 있어야 합니다. 설정 파일 claude_desktop_config.json에 아래처럼 등록합니다. 경로는 허용할 실제 폴더의 절대경로로 바꾸세요. 여러 폴더를 허용하려면 args에 경로를 계속 추가합니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

저장 후 Claude Desktop을 재시작하면 도구 목록에 filesystem 서버가 나타납니다.

Docker로 실행

NPX 대신 Docker로도 실행할 수 있습니다(공식 문서에 마운트 예시가 있습니다). 특정 폴더를 읽기 전용으로 묶고 싶다면 마운트 옵션에 ro를 붙입니다.

Claude Code에서

claude mcp add 명령으로 등록합니다 — 자세한 사용법은 Claude Code MCP 설정을 참고하세요.

접근 제어 (중요)

허용 폴더를 정하는 방법은 두 가지입니다 — (1) 위처럼 명령행 인자로 폴더를 지정, (2) MCP Roots로 지정(공식 문서가 권장하는 방식). 어느 쪽이든 비밀번호·금융 자료 같은 민감한 폴더는 넣지 마세요.

써보기

"Desktop의 메모.txt 읽어줘", "리포트 폴더에 요약을 summary.md로 저장해줘"처럼 요청하면, 클로드가 승인을 물은 뒤 해당 폴더에서 작업합니다.

안전하게 · 문제해결

파일 접근 권한이므로 범위를 최소로 두세요(MCP 커넥터 보안). 서버가 안 보이거나 오류가 나면 문제해결 가이드를 참고하세요.

다른 커넥터도 찾고 있다면 커넥터 디렉토리에서 자주 쓰는 커넥터를 용도별로 검색·필터해볼 수 있습니다.

관련 글

다른 서버는 용도별 추천 MCP 서버와 어디서 찾나, 전체 지도는 커넥터·MCP 카탈로그, 직접 만들려면 MCP 서버 직접 만들기를 보세요. 공식 출처는 Filesystem 서버 공식 저장소입니다.

작성·기준: 2026년 6월, 2026년 9월 9일 공식 저장소 재대조(npm 최신 2026.8.31 — 설정 형식·Roots 권장·Docker 읽기 전용 마운트 동일). 패키지명·옵션은 공식 저장소를 기준으로 했으며 버전에 따라 바뀔 수 있으니 실제 설정 시 공식 문서를 함께 확인해 주세요. 이 글은 비공식 안내입니다.