Paperless MCP

Поиск документов, чтение распознанного текста и скачивание оригиналов из Paperless.

Адрес подключения

Добавьте удалённый MCP-сервер с транспортом Streamable HTTP. Укажите адрес целиком, включая /mcp:

https://paperless-mcp.rubezh-net.ru/mcp

Добавьте адрес в свой MCP-клиент по инструкции ниже.
В открывшемся окне войдите в XAM под своей учётной записью Danil или Alex и подтвердите доступ клиенту.
После подключения проверьте список инструментов сервера.

Токен Paperless и ручная настройка заголовка Authorization не нужны.

ChatGPT в браузере

Откройте Settings → Security and login и включите Developer mode, если он доступен для вашего аккаунта.
Откройте ChatGPT Plugins, нажмите «+» и создайте подключение к https://paperless-mcp.rubezh-net.ru/mcp.
Установите созданное подключение и включите его в новом чате через меню инструментов.

Claude в браузере

Откройте Customize → Connectors → «+» → Add custom connector.
Укажите https://paperless-mcp.rubezh-net.ru/mcp, добавьте коннектор и нажмите Connect для входа в XAM.
В нужном чате включите его через «+» → Connectors.

В Team и Enterprise коннектор сначала добавляет владелец организации.

Codex

В терминале выполните:

codex mcp add paperless --url https://paperless-mcp.rubezh-net.ru/mcp
codex mcp login paperless
codex mcp list

В приложении Codex можно добавить тот же адрес через Settings → MCP servers → Add server → Streamable HTTP.

Claude Code

В терминале выполните:

claude mcp add --transport http --scope user paperless https://paperless-mcp.rubezh-net.ru/mcp

Затем откройте Claude Code, выполните /mcp и пройдите вход в XAM.

search_documents — поиск по тексту Paperless и семантическому индексу.
read_document — чтение OCR-текста документа.
download_original — получение исходного файла документа (до 50 MiB) в MCP-клиент.

Этот MCP не загружает, не изменяет и не удаляет документы. Для отправки файла прямо в Telegram бот Hermes использует отдельный внутренний инструмент.

Для меток, папок, переклассификации и других изменений подключите отдельный полномочный MCP:

https://paperless-mcp-control.rubezh-net.ru/mcp

В ChatGPT или Claude добавьте ещё один удалённый MCP-коннектор с этим адресом и именем Paperless Control. В Codex выполните codex mcp add paperless-control --url https://paperless-mcp-control.rubezh-net.ru/mcp, затем codex mcp login paperless-control.
Войдите в XAM под своей учётной записью и подтвердите доступ на странице согласия.

Этот адрес даёт полный доступ, включая изменение и удаление документов. Подробные инструкции для каждого клиента есть на странице Paperless Control.