---
title: "Filesystem: Claude, Cursor, Codex 설정 · DotsAgent"
description: "시작할 때 지정한 디렉터리 안에서 로컬 파일을 읽고, 쓰고, 검색하고, 이동합니다. 13개 MCP 클라이언트에서 Filesystem을(를) 설정하세요."
url: https://dotsagent.io/ko/mcp/servers/filesystem
---

파일 · MCP Steering Group

# Filesystem 설정

시작할 때 지정한 디렉터리 안에서 로컬 파일을 읽고, 쓰고, 검색하고, 이동합니다.

- **게시자**: MCP Steering Group 공식
- **로컬 실행**: `npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir`
- **전송 방식**: stdio
- **인증**: 없음. 인수 또는 roots를 통해 전달된 디렉터리로 접근이 제한됩니다.
- **접근 가능한 항목**: 허용된 디렉터리 내의 파일을 읽고 씁니다.
- **라이선스**: MIT (existing) / Apache-2.0 (new contributions)
- **소스**: [github.com/modelcontextprotocol/servers/tree/main/src/filesystem](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)
- **상태**: 활성

## 설치

이 서버는 클라이언트의 자식 프로세스로 내 컴퓨터에서 실행됩니다. 명령에서 사용하는 런타임이 필요합니다. 예를 들어 npx에는 Node.js, uvx에는 uv, Docker에는 Docker가 필요합니다. Environment에 나열된 변수도 준비해야 합니다.

### Claude Code

`shell`

```
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir
```

### Cursor

`.cursor/mcp.json`

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

### Codex

`~/.codex/config.toml`

```
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
```

[다른 클라이언트용 설정 →](https://dotsagent.io/ko/mcp/config#add=filesystem)

에이전트는 허용된 디렉터리 내의 파일을 덮어쓰거나 이동할 수 있으므로, 필요한 디렉터리만 지정하세요.

## 출처

1. [github.com](https://github.com/modelcontextprotocol/servers)/modelcontextprotocol/servers
2. [modelcontextprotocol.io](https://modelcontextprotocol.io/docs/develop/connect-local-servers)/docs/develop/connect-local-servers

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일