filex — Claude Code MCP server: what it does, how to install
MCP server for Claude Code bridges the model with your self-hosted filex instance. It exposes local disks, S3 buckets, SFTP, WebDAV, FTP, and SMB shares to coding agents.
MIT ★ 106 updated 2026-11-16
Open on GitHubWhat filex does
The tool runs directly inside filex, a self-hosted Go file manager. Connected agents browse directories, read files, and transfer data across mounted storages via a unified virtual tree.
Underneath, filex handles storage drivers, folder encryption, trash retention, and identity through LDAP or OIDC. It allows agents to interact with files stored across diverse backends without separate cloud SDKs.
The integration requires an active filex deployment running either as a standalone binary or via the ghcr.io/brf-tech/filex:latest Docker container listening on port 5212.
What it helps with
- provide agents access to files on S3, SFTP, and SMB storage
- read and organize assets across unified server directories
- transfer archives between local disks and remote buckets
- inspect versioned documents stored inside private infrastructure
Example prompts for the agent
- List all files stored in the SFTP reports directory
- Fetch the contents of config.json from the S3 bucket
- Copy the exported dataset from the local storage to the SMB share
How to install filex
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http filex https://{host}/api/ai/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add filex --url https://{host}/api/ai/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"filex": {
"url": "https://{host}/api/ai/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"filex": {
"type": "http",
"url": "https://{host}/api/ai/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http filex https://{host}/api/ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about filex
How to install filex in Claude Code?
Run claude mcp add --transport http filex https://{host}/api/ai/mcp, substituting {host} with your actual instance address.
What does filex do?
It is a self-hosted file manager written in Go that mounts S3, SFTP, WebDAV, FTP, and SMB alongside local disks, exposing them over a native MCP endpoint.
What is required to run filex?
You need a running filex instance deployed via Docker or the release binary, plus network access to its /api/ai/mcp endpoint.