# Paperless-ngx

Связывает ИИ-ассистента с вашим архивом Paperless-ngx: поиск, теги, загрузка и правка документов прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Автор: cubinet-code
- Лицензия: ISC · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cubinet-code/paperless-ngx-mcp
- Обновлён: 2026-09-30
- HTML: https://affpapa.org/nevibecode/mcp/paperless-ngx

## Что делает

Сервер отдаёт ассистенту REST API Paperless-NGX. Через него можно искать документы, разбирать теги и корреспондентов, заводить типы документов и пользовательские поля, работать с рабочими процессами, почтовыми правилами, версиями, заметками и корзиной.

Опасные операции требуют подтверждения: у каждого инструмента `delete_*`, у `empty_trash`, `merge_documents_as_versions` и массового удаления есть параметр `confirm: true`. Массовые правки по всем подходящим документам отказываются от фильтров, которые Paperless молча проигнорировал бы. Промпт `triage_inbox` сначала предлагает изменения и ждёт вашего согласия, и только потом пишет.

Нужны два параметра: `PAPERLESS_URL` и `PAPERLESS_API_KEY`. Токен берётся в профиле пользователя в самом Paperless. Сервер рассчитан на Paperless-ngx 3.2, для ветки 2.x есть отдельная версия пакета `paperless-ngx-mcp@3.1.1`. Запускается через `npx`, есть образ Docker и расширение для Claude Desktop.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PAPERLESS_URL`, `PAPERLESS_API_KEY`, `PAPERLESS_PUBLIC_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env PAPERLESS_URL=<PAPERLESS_URL> --env PAPERLESS_API_KEY=<PAPERLESS_API_KEY> --env PAPERLESS_PUBLIC_URL=<PAPERLESS_PUBLIC_URL> --transport stdio paperless-ngx -- npx -y paperless-ngx-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add paperless-ngx --env PAPERLESS_URL=<PAPERLESS_URL> --env PAPERLESS_API_KEY=<PAPERLESS_API_KEY> --env PAPERLESS_PUBLIC_URL=<PAPERLESS_PUBLIC_URL> -- npx -y paperless-ngx-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "paperless-ngx": {
            "command": "npx",
            "args": [
                "-y",
                "paperless-ngx-mcp"
            ],
            "env": {
                "PAPERLESS_URL": "<PAPERLESS_URL>",
                "PAPERLESS_API_KEY": "<PAPERLESS_API_KEY>",
                "PAPERLESS_PUBLIC_URL": "<PAPERLESS_PUBLIC_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "paperless-ngx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "paperless-ngx-mcp"
            ],
            "env": {
                "PAPERLESS_URL": "<PAPERLESS_URL>",
                "PAPERLESS_API_KEY": "<PAPERLESS_API_KEY>",
                "PAPERLESS_PUBLIC_URL": "<PAPERLESS_PUBLIC_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e PAPERLESS_URL=<PAPERLESS_URL> -e PAPERLESS_API_KEY=<PAPERLESS_API_KEY> -e PAPERLESS_PUBLIC_URL=<PAPERLESS_PUBLIC_URL> paperless-ngx npx -y paperless-ngx-mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Покажи все документы с тегом «Счёт»
- Найди документы, где встречается «налоговая декларация»
- Создай тег «Квитанции» с цветом #FF0000

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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