Filelayer — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер Filelayer отдаёт файлы по правам доступа и выдаёт ссылки с ограничением по времени и числу скачиваний. Решает, кто может прочитать или отозвать файл, и пишет это в журнал.
Apache-2.0 обновлён 2026-10-21
claude mcp add core -e DATABASE_URL=<DATABASE_URL> -e FILELAYER_AS=<FILELAYER_AS> -e FILELAYER_ORG=<FILELAYER_ORG> -e S3_ACCESS_KEY_ID=<S3_ACCESS_KEY_ID> -e S3_SECRET_ACCESS_KEY=<S3_SECRET_ACCESS_KEY> -- npx -y @filelayer/coreЧто делает Filelayer
Filelayer — слой доступа к файлам поверх вашей базы Postgres и хранилища (S3, R2, B2 или локальная папка). Вы передаёте ID вызывающего пользователя, а сервер проверяет права, отдаёт байты с нужными заголовками и записывает событие в аудит-журнал в той же транзакции, где принято решение.
Внутри одна функция авторизации на все запросы: роли, сроки действия ссылок, лимиты скачиваний и отзыв доступа. Ссылку на файл можно выдать с паролем, сроком жизни и максимальным числом скачиваний, а затем отозвать — доступ прекращается на следующем запросе. Для отзыва доступа у конкретного человека нужен unshare, а не revoke одного grant id: create() не идемпотентен, и более ранний грант может остаться живым.
Filelayer не заменяет RLS в базе: прямой SELECT к его таблицам ничем не фильтруется, схема только запрещает межтенантные гранты и утечку прав через делегирование. Для публичных картинок с большим объёмом трафика или видео со сканированием лучше CDN — здесь каждый байт проходит через ваш сервер.
Какие задачи решает
- раздать приватный файл конкретному пользователю или организации
- выдать ссылку на файл с паролем, сроком действия и лимитом скачиваний
- отозвать уже выданную ссылку на файл
- вести журнал обращений к файлам, включая отказы в доступе
- ограничить число скачиваний одного файла
Примеры запросов агенту
- Выдай пользователю
user_456доступ к файлуidна час с лимитом три скачивания - Отозви у
user_456весь доступ к файлу черезunshare - Проверь, кто обращался к файлу
idи какие запросы были отклонены
Как установить Filelayer
Командой платформы
claude mcp add core -e DATABASE_URL=<DATABASE_URL> -e FILELAYER_AS=<FILELAYER_AS> -e FILELAYER_ORG=<FILELAYER_ORG> -e S3_ACCESS_KEY_ID=<S3_ACCESS_KEY_ID> -e S3_SECRET_ACCESS_KEY=<S3_SECRET_ACCESS_KEY> -- npx -y @filelayer/coreВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
codex mcp add core --env DATABASE_URL=<DATABASE_URL> --env FILELAYER_AS=<FILELAYER_AS> --env FILELAYER_ORG=<FILELAYER_ORG> --env FILELAYER_DATA_DIR=<FILELAYER_DATA_DIR> --env S3_ENDPOINT=<S3_ENDPOINT> -- npx -y @filelayer/coreВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"core": {
"command": "npx",
"args": [
"-y",
"@filelayer/core"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"FILELAYER_AS": "<FILELAYER_AS>",
"FILELAYER_ORG": "<FILELAYER_ORG>",
"FILELAYER_DATA_DIR": "<FILELAYER_DATA_DIR>",
"S3_ENDPOINT": "<S3_ENDPOINT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"core": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@filelayer/core"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"FILELAYER_AS": "<FILELAYER_AS>",
"FILELAYER_ORG": "<FILELAYER_ORG>",
"FILELAYER_DATA_DIR": "<FILELAYER_DATA_DIR>",
"S3_ENDPOINT": "<S3_ENDPOINT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e FILELAYER_AS=<FILELAYER_AS> -e FILELAYER_ORG=<FILELAYER_ORG> -e FILELAYER_DATA_DIR=<FILELAYER_DATA_DIR> -e S3_ENDPOINT=<S3_ENDPOINT> core npx -y @filelayer/coreВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Filelayer
Как установить Filelayer в Claude Code?
Выполните `claude mcp add core -e DATABASE_URL=<DATABASE_URL> -e FILELAYER_AS=<FILELAYER_AS> -e FILELAYER_ORG=<FILELAYER_ORG> -e S3_ACCESS_KEY_ID=<S3_ACCESS_KEY_ID> -e S3_SECRET_ACCESS_KEY=<S3_SECRET_ACCESS_KEY> -- npx -y @filelayer/core`.
Что делает Filelayer?
Он решает, может ли вызывающий прочитать, скачать или отозвать конкретный файл, отдаёт байты с нужными заголовками и пишет событие доступа в журнал. Также создаёт ссылки с паролем, сроком жизни и лимитом скачиваний.
Нужна ли база данных для работы Filelayer?
Да, схема из девяти таблиц разворачивается в вашем Postgres, а байты файлов хранятся в S3, R2, B2 или локальной папке через единый адаптер.