Paperless-ngx — MCP-сервер для Claude Code: доступ к документам
Связывает ИИ-ассистента с вашим архивом Paperless-ngx: поиск, теги, загрузка и правка документов прямо из чата.
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Что делает 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 есть отдельная версия пакета [email protected]. Запускается через npx, есть образ Docker и расширение для Claude Desktop.
Какие задачи решает
- найти документы по тегу или фразе в тексте
- завести тег с нужным цветом и повесить его на пачку файлов
- перенести документы от одного корреспондента к другому
- снять пароль с PDF и сохранить открытую версию
- разобрать входящие и дождаться подтверждения перед записью
Примеры запросов агенту
- Покажи все документы с тегом «Счёт»
- Найди документы, где встречается «налоговая декларация»
- Создай тег «Квитанции» с цветом #FF0000
Как установить Paperless-ngx
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Paperless-ngx
Как установить Paperless-ngx MCP-сервер в Claude Code?
Выполните claude mcp add paperless-ngx-mcp -e PAPERLESS_URL=<PAPERLESS_URL> -e PAPERLESS_API_KEY=<PAPERLESS_API_KEY> -- npx -y paperless-ngx-mcp. Подставьте адрес своего инстанса и токен.
Что делает Paperless-ngx MCP-сервер?
Открывает ассистенту API Paperless-NGX: поиск и правка документов, теги, корреспонденты, рабочие процессы, почтовые правила, версии и корзина.
С какой версией Paperless-ngx он совместим?
С Paperless-ngx 3.2. Для Paperless 2.x нужен пакет [email protected].
