# Filelayer

MCP-сервер Filelayer отдаёт файлы по правам доступа и выдаёт ссылки с ограничением по времени и числу скачиваний. Решает, кто может прочитать или отозвать файл, и пишет это в журнал.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: filelayer
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/filelayer/filelayer/tree/HEAD/packages/core
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/filelayer

## Что делает

Filelayer — слой доступа к файлам поверх вашей базы Postgres и хранилища (S3, R2, B2 или локальная папка). Вы передаёте ID вызывающего пользователя, а сервер проверяет права, отдаёт байты с нужными заголовками и записывает событие в аудит-журнал в той же транзакции, где принято решение.

Внутри одна функция авторизации на все запросы: роли, сроки действия ссылок, лимиты скачиваний и отзыв доступа. Ссылку на файл можно выдать с паролем, сроком жизни и максимальным числом скачиваний, а затем отозвать — доступ прекращается на следующем запросе. Для отзыва доступа у конкретного человека нужен `unshare`, а не `revoke` одного grant id: `create()` не идемпотентен, и более ранний грант может остаться живым.

Filelayer не заменяет RLS в базе: прямой `SELECT` к его таблицам ничем не фильтруется, схема только запрещает межтенантные гранты и утечку прав через делегирование. Для публичных картинок с большим объёмом трафика или видео со сканированием лучше CDN — здесь каждый байт проходит через ваш сервер.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `DATABASE_URL`, `FILELAYER_AS`, `FILELAYER_ORG`, `FILELAYER_DATA_DIR`, `S3_ENDPOINT`, `S3_BUCKET`, `S3_REGION`, `S3_ACCESS_KEY_ID`, `S3_SECRET_ACCESS_KEY`, `FILELAYER_MCP_AGENT_LABEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- раздать приватный файл конкретному пользователю или организации
- выдать ссылку на файл с паролем, сроком действия и лимитом скачиваний
- отозвать уже выданную ссылку на файл
- вести журнал обращений к файлам, включая отказы в доступе
- ограничить число скачиваний одного файла

## Примеры запросов агенту
- Выдай пользователю `user_456` доступ к файлу `id` на час с лимитом три скачивания
- Отозви у `user_456` весь доступ к файлу через `unshare`
- Проверь, кто обращался к файлу `id` и какие запросы были отклонены

## Похожие
- [Willder](https://affpapa.org/nevibecode/mcp/willder.md) — MCP-сервер · ★ 12 у репозитория
- [sanctuary](https://affpapa.org/nevibecode/mcp/sanctuary.md) — MCP-сервер · ★ 10 у репозитория
- [auditing-aws-s3-bucket-permissions](https://affpapa.org/nevibecode/skills/auditing-aws-s3-bucket-permissions.md) — скилл · 307 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
