Filesystem MCP 실습: 허용 폴더 하나로 파일 읽기부터 시험하기

MCP 연결·활용 / 제한된 폴더 시험

AI가 로컬 파일을 읽거나 수정해야 할 때 Filesystem MCP를 사용할 수 있습니다. 핵심 설정은 서버 설치보다 어느 폴더를 허용할지 정하는 일입니다. 처음에는 가상 실습 폴더 하나만 연결해 보는 편이 이해하기 쉽습니다.

무엇을 할 수 있고, 왜 범위가 중요한가?

공식 예제 서버는 파일 읽기·쓰기, 디렉터리 생성·목록 조회, 파일 이동·검색 등의 도구를 제공합니다. 서버는 실행 인수나 MCP Roots로 허용한 디렉터리 안에서 작업합니다. 허용 범위를 넓게 잡을수록 AI가 접근 가능한 자료도 늘어납니다. 집 전체 경로를 주는 대신, 실습용 폴더를 하나 정해 시작하세요.

Windows 실습 폴더로 연결하기

예를 들어 E:\MCP-Demo 안에 sample.txt를 만든 뒤 Codex CLI에서 아래처럼 연결할 수 있습니다. 경로는 자신의 실습 폴더로 바꾸세요. 폴더가 실제로 존재해야 합니다. -- 뒤는 서버를 실행할 명령입니다.

codex mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem E:\MCP-Demo
codex mcp list

Claude Code를 사용한다면 해당 클라이언트의 MCP 추가 명령에 같은 npx -y @modelcontextprotocol/server-filesystem과 허용 폴더 경로를 넣습니다. 공식 README는 클라이언트가 Roots를 지원할 때 동적으로 허용 폴더를 전달하는 방법도 설명합니다. 어떤 방식이 적용됐는지 list_allowed_directories 결과로 확인하세요.

읽기부터 시험하고 수정은 미리보기

허용된 폴더 목록을 먼저 보여줘.
그다음 E:\MCP-Demo\sample.txt를 읽고 한 문장으로 설명해줘.
파일은 수정하지 마.

재현 시험에서는 허용 목록에 시험 폴더가 표시되고 그 안의 한 줄 텍스트를 읽었습니다. 파일을 바꾸는 작업이 필요하면 edit_file의 dryRun으로 차이를 먼저 보는 절차가 공식 문서에 나옵니다. 원본 백업과 변경 내역을 확인한 뒤 적용하는 습관이 중요합니다.

실무에서 쓸 수 있는 예와 주의점

회의록 파일 여러 개에서 담당자를 찾거나, 공개 가능한 마크다운 문서의 제목을 통일하는 작업에 맞습니다. 개인 사진 전체, 고객 자료, 비밀번호가 들어 있는 폴더를 통째로 허용하면 위험합니다. 허용 폴더가 하나도 없고 클라이언트가 Roots도 보내지 않으면 서버 초기화가 실패할 수 있습니다. 이때는 경로 존재 여부와 허용 폴더 목록부터 점검하세요.

Codex 자체에도 파일을 읽고 편집하는 기능이 있으므로, 이미 같은 작업이 된다면 Filesystem MCP를 중복으로 연결할 필요가 없을 수 있습니다. 다른 MCP 클라이언트에서 동일한 폴더 범위 규칙을 사용하고 싶을 때 비교해 보세요.

근거: Filesystem MCP 공식 README와 제한된 폴더에서의 직접 호출 결과.