도입

Filestash MCP plugin은 Filestash의 파일 관리 엔진을 MCP 인터페이스로 연결해 쓰기 위한 서버형 플러그인입니다. SFTP, S3, WebDAV처럼 서로 다른 원격 저장소를 개발 도구나 자동화 흐름에서 한 방식으로 다루고 싶을 때 활용하기 좋습니다.

Filestash 자체는 “Dropbox 같은 파일 관리자”에서 출발했지만, 현재는 FTP, SFTP, S3, SMB, WebDAV, IPFS 등 다양한 저장소 프로토콜을 다루는 파일 관리 플랫폼으로 확장되어 있습니다. 이 MCP 플러그인은 그 구조 안에서 MCP 접근을 담당하는 구성으로 보면 됩니다.

왜 좋은가 / 왜 유명한가

- 여러 저장소를 한 인터페이스로 다루는 데 강점이 있습니다.

공식 README는 Filestash가 FTP, SFTP, S3, SMB, WebDAV, IPFS와 그 외 다수의 저장소 프로토콜을 지원하는 파일 관리 플랫폼이라고 설명합니다.

- MCP가 공식 기능 축에 포함되어 있습니다.

README의 “Universal Access” 항목에서 Filestash는 데이터를 SFTP, S3, FTP, WebDAV, MCP, AS2 같은 프로토콜로 노출할 수 있다고 설명합니다.

- 플러그인 중심 구조라 확장성이 큽니다.

Filestash는 “근본적인 핵심 외에는 모두 플러그인”이라는 방향을 갖고 있으며, 필요한 기능을 플러그인으로 추가하거나 직접 만들 수 있는 구조를 강조합니다.

- 개발 자동화와 파일 작업 자동화에 잘 맞습니다.

원격 저장소 접근, 파일 관리, 워크플로 엔진, API·Gateway 구조가 함께 언급되어 있어 파일 기반 업무 자동화에 연결하기 좋습니다.

- MCP 서버 목록에서 자주 언급되는 자료입니다.

검색 요약 기준으로 Awesome Claude의 “Top MCP Servers” 검색 결과에 MCP 서버로 언급된 자료입니다.

무엇을 할 수 있나 / 무엇이 들어있나

Filestash MCP plugin 자체의 세부 명령이나 옵션은 제공된 README 발췌에 구체적으로 나오지 않습니다. 다만 공식 README에서 확인되는 Filestash 플랫폼의 핵심 기능은 다음과 같습니다.

- 다양한 저장소 프로토콜 접근

README에서 FTP, SFTP, S3, SMB, WebDAV, IPFS 등을 지원한다고 설명합니다. 검색 요약 기준으로는 SFTP, S3, FTP, SMB, NFS, WebDAV, GIT, FTPS, gcloud, Azure Blob, SharePoint 등도 지원 대상으로 언급됩니다.

- MCP를 통한 데이터 노출

“Universal Access” 항목에서 SFTP, S3, FTP, WebDAV, MCP, AS2 같은 프로토콜로 데이터를 노출할 수 있다고 설명합니다. 즉, MCP 클라이언트나 MCP를 지원하는 자동화 도구에서 Filestash가 연결한 저장소를 다루는 방식으로 활용할 수 있습니다.

- 플러그인 기반 아키텍처

필요한 기능만 붙여 쓰는 구조입니다. README는 “Plugin Driven Architecture”를 핵심 기능으로 소개하며, 생태계의 플러그인을 탐색하거나 직접 만들 수 있다고 설명합니다.

- 웹 클라이언트, 네이티브 드라이브 클라이언트, 게이트웨이 구조

Filestash는 웹 클라이언트만 제공하는 도구가 아니라, 파일 관리 엔진을 중심으로 웹 클라이언트, 네이티브 드라이브 클라이언트, 여러 프로토콜 게이트웨이를 둔 구조로 설명됩니다.

- 워크플로 엔진

파일에 발생하는 이벤트를 기준으로 작업을 연결할 수 있습니다. README 예시에는 Slack 또는 이메일 알림부터 MFT 파이프라인까지 자동화할 수 있다고 적혀 있습니다.

- 다양한 파일 앱

이미지, 과학 문서, 음악, GIS, 데이터 엔지니어링, 개발 관련 파일, 3D, biomedical, embroidery 등 여러 파일 형식을 다루는 앱 구성이 소개되어 있습니다.

- AI 기능

README에는 검색, 스마트 폴더, OCR을 위한 AI 기능이 언급되어 있습니다.

- 추가 파일 관리 기능

버전 관리, 감사 로그, 공개 사이트, 백신, 할당량, 채팅, Chromecast 지원, 온디맨드 비디오 트랜스코딩, 공유 링크를 네트워크 드라이브로 마운트하는 기능 등이 README에 예시로 언급됩니다.

설치와 사용법

제공된 README 발췌에는 Filestash MCP plugin을 설치하는 구체적인 명령어, MCP 클라이언트 설정 블록, 실행 옵션이 포함되어 있지 않습니다. 따라서 아래처럼 임의의 `npm install`, `docker run`, `uvx`, `npx` 명령을 만들어 쓰면 안 됩니다.

제공된 공식 README 발췌에서 확인된 설치 명령: 없음
제공된 공식 README 발췌에서 확인된 MCP 설정 블록: 없음
제공된 공식 README 발췌에서 확인된 실행 명령: 없음

공식 README에서 확인되는 설치 안내는 다음 한 가지입니다. Filestash 설치는 공식 Getting Started 문서로 이동하라고 안내되어 있습니다.

To install Filestash, head to the Getting started guide.
If you want to leverage plugins, head over to the inventory.

실제 시작 순서는 이렇게 잡으면 됩니다.

1. Filestash 본체를 먼저 설치합니다.

설치 명령은 이 글에 제공된 README 발췌 안에 없으므로, Filestash 공식 Getting Started 문서를 확인해야 합니다.

2. Filestash의 플러그인 구조를 확인합니다.

MCP 플러그인은 GitHub 저장소 내 다음 경로에 있습니다.

server/plugin/plg_handler_mcp

3. 연결하려는 원격 저장소를 Filestash에서 사용할 수 있게 구성합니다.

예를 들어 팀에서 SFTP 서버와 S3 버킷을 함께 쓰고 있다면, Filestash가 해당 저장소에 접근하도록 설정한 뒤 MCP 인터페이스를 통해 파일 작업 자동화에 연결하는 흐름으로 접근할 수 있습니다.

4. MCP를 지원하는 클라이언트 또는 자동화 도구에서 Filestash MCP 인터페이스를 붙여 사용합니다.

구체적인 클라이언트 설정 JSON이나 실행 커맨드는 제공된 원문에 없으므로, 반드시 플러그인 경로의 최신 문서와 Filestash 공식 문서를 함께 확인해야 합니다.

실제 활용 예시는 다음과 같습니다.

- 개발 자동화

SFTP 서버에 올라온 로그 파일이나 산출물을 MCP를 통해 조회하고, 필요한 파일을 읽어 분석 흐름에 연결합니다.

- 여러 저장소 통합 탐색

S3, WebDAV, SMB처럼 팀마다 흩어진 저장소를 Filestash 쪽에 연결해 두고, MCP 기반 도구에서 동일한 방식으로 파일을 찾고 다룹니다.

- 파일 이벤트 기반 자동화

Filestash의 워크플로 엔진 설명에 따르면 파일 이벤트에 액션을 연결할 수 있습니다. 이를 알림, 전송, 처리 파이프라인과 조합하면 반복적인 파일 관리 작업을 줄일 수 있습니다.

주의할 점

- 설치 명령은 반드시 공식 문서에서 확인해야 합니다.

제공된 README 발췌에는 MCP 플러그인 설치 명령이나 MCP 클라이언트 설정 예시가 없습니다. 인터넷 글에 있는 임의 명령을 그대로 복사하기보다 GitHub 경로와 공식 Getting Started 문서를 기준으로 확인하는 편이 안전합니다.

- 원격 저장소 권한 관리가 중요합니다.

SFTP, S3, WebDAV, SMB 같은 저장소를 MCP로 연결하면 자동화 도구가 파일에 접근할 수 있습니다. 읽기 전용 계정, 최소 권한, 접근 로그, 감사 기능을 함께 고려해야 합니다.

- 지원 저장소와 실제 사용 가능 범위는 환경에 따라 달라질 수 있습니다.

README는 다양한 프로토콜과 게이트웨이를 설명하지만, 조직의 인증 방식, 네트워크 정책, 플러그인 활성화 여부에 따라 바로 연결되지 않을 수 있습니다.

출처와 다운로드

GitHub 저장소의 Filestash MCP plugin 경로는 아래에서 확인할 수 있습니다.

https://github.com/mickael-kerjean/filestash/tree/master/server/plugin/plg_handler_mcp

Filestash 공식 문서와 Getting Started 안내는 GitHub README에서 연결되는 공식 문서를 함께 확인하면 됩니다. 게시글 하단 첨부파일로도 관련 자료를 받을 수 있습니다.