목록 · 개발·코드

Filesystem MCP

정해 준 폴더 안에서만 파일을 읽고 쓰고 옮깁니다. 허용할 폴더를 명령 뒤에 적어야 하고, 그 밖으로는 나가지 못합니다. MCP 를 만든 쪽의 기본 서버입니다.

도도리 AI연구소 · 최종 수정 2026년 9월 21일 · CC BY-NC 4.0

내 폴더 읽고 쓰기 MCP 설치하는 법

설정 파일에 세 줄을 넣으면 끝납니다. 터미널을 몰라도 됩니다.

1. 설정 파일을 엽니다.
   Windows%APPDATA%\Claude\claude_desktop_config.json복사

   macOS~/Library/Application Support/Claude/claude_desktop_config.json복사
   파일이 없으면 새로 만드십시오. 메모장이나 텍스트 편집기면 충분합니다.
2. 아래 내용을 붙여 넣고 저장합니다.

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/허용할/폴더"
         ]
       }
     }
   }

   전체 복사
   이미 mcpServers가 있다면 그 안쪽에 항목만 추가하십시오. 중괄호를 두 번 쓰면 오류가 납니다.
3. Claude 앱을 완전히 껐다가 다시 켭니다. 창만 닫으면 반영되지 않습니다. Windows는 작업 표시줄 아이콘에서 종료, macOS는 Cmd+Q로 완전히 끄십시오. 이 단계를 빠뜨려서 안 된다고 하는 경우가 가장 많습니다.

먼저 알아 둘 것

이런 일을 시킵니다

폴더째 정리시키기

파일 이름 규칙을 정해 주고 한 번에 바꾸게 합니다.

여러 파일에서 찾기

search_files 로 문구가 들어간 파일을 찾아 옵니다.

구조 훑기

directory_tree 로 폴더 구조를 받아 어디에 무엇이 있는지 파악시킵니다.

붙었는지 확인하기

설정을 마쳤으면 대화창에 이렇게 물어보십시오. 도구가 실제로 붙었으면 답이 돌아옵니다.

내 폴더 읽고 쓰기 MCP 안 될 때 확인할 것

허용 폴더를 반드시 적으십시오

명령 뒤에 경로를 안 적으면 아무 데도 못 봅니다. 반대로 상위 폴더를 적으면 그 아래가 전부 열립니다.

쓰기와 지우기가 됩니다

덮어쓰기와 옮기기가 실제로 반영됩니다. 중요한 폴더를 열기 전에 백업을 두십시오.

클로드 코드에는 이미 파일 도구가 있습니다

겹칩니다. 데스크톱 앱이나 다른 클라이언트에서 파일을 다루고 싶을 때 값이 납니다.

언제 쓰고, 언제 안 쓰나

클로드 데스크톱처럼 파일 도구가 없는 곳에서 내 폴더를 다루게 할 때 씁니다. 클로드 코드를 쓰신다면 이미 됩니다.

비슷한 것 중에 왜 이걸

클로드 코드에는 같은 일을 하는 도구가 처음부터 들어 있습니다. 이 서버는 그것이 없는 클라이언트를 위한 것입니다.

자주 묻는 것

내 폴더 읽고 쓰기 MCP(Filesystem) 는 어떻게 설치합니까?

주소가 아니라 명령으로 도는 서버입니다. 클로드 코드에서는 `claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem /허용할/폴더` 로 넣습니다. 클로드 데스크톱이라면 설정 파일의 mcpServers 에 같은 명령을 적으십시오. 저희가 이 명령으로 직접 띄워 도구가 응답하는 것까지 확인했습니다(2026-09-20).

내 폴더 읽고 쓰기 MCP(Filesystem) 연결이 안 될 때는 무엇을 봅니까?

2026년 9월 20일에 `npx -y @modelcontextprotocol/server-filesystem /tmp` 로 직접 띄워 확인했습니다. serverInfo 는 secure-filesystem-server 0.2.0 이었고 도구는 14개였습니다. read_file, write_file, edit_file, create_directory, list_directory, directory_tree, move_file, search_files, get_file_info, list_allowed_directories 등입니다. 명령 뒤에 경로를 안 적으면 아무 데도 못 봅니다. 반대로 상위 폴더를 적으면 그 아래가 전부 열립니다.

내 폴더 읽고 쓰기 MCP(Filesystem) 로 무엇을 할 수 있습니까?

이 장에 적어 둔 것은 폴더째 정리시키기, 여러 파일에서 찾기, 구조 훑기 입니다. 자세한 설명은 위쪽 쓰임새 칸에 있습니다.

개발·코드 도구를 고를 때

코드 생성·리팩터링·리뷰를 돕는 도구입니다. 사내 코드가 외부 서버로 전송되는 구조인지, 무료 요금제의 컨텍스트 길이 제한이 어디까지인지 확인하세요.

공식 사이트에서 계정 만들기

제휴 관계가 없는 일반 링크입니다.

별점과 댓글

이 MCP 서버을 써 보신 분의 별점(5점 만점)과 한마디입니다. 작성자는 아이디 앞 3자만 보입니다(예: wor****). 읽는 데는 제한이 없고, 남기는 것은 로그인한 회원만 됩니다. 한 사람이 한 번이며 다시 쓰면 앞의 것을 덮어씁니다.

함께 보면 좋은 도구

어느 단계에 무엇을 붙일지 모르겠다면 콘텐츠 제작 단계별 MCP 120종을 보십시오. 기획부터 성과 확인까지 여덟 단계로 갈라 두었습니다.