Что делает коннектор
MCP (Model Context Protocol) — это открытый стандарт, через который ИИ-ассистент использует инструменты другой системы. PaperOffice предоставляет для этого удаленный сервер MCP. После подключения ассистент, такой как Claude, может работать с документами в ваших рабочих пространствах PaperOffice: искать, читать, суммировать, извлекать данные, загружать, переименовывать, перемещать, запрашивать подписи и запускать рабочие процессы, всегда соблюдая Ваши разрешения в PaperOffice.
Ничего устанавливать не нужно. Ассистент подключается по URL-адресу, Вы входите в систему с помощью учетной записи PaperOffice, и инструменты PaperOffice появляются внутри чата.
Поддерживаемые ассистенты и URL-адреса коннекторов
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, вход через OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, вход через OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, вход через OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, с помощью личного токена пользователя или группового токена.
Профили указывают на один и тот же сервер и различаются только набором доступных инструментов.
Что Вам понадобится
- Учетная запись PaperOffice как минимум с одним рабочим пространством.
- Credits на учетной записи. Вызовы инструментов оплачиваются так же, как API-вызовы.
- Тарифный план ассистента, позволяющий использовать коннекторы, например Claude Pro, Max, Team или Enterprise. В тарифах Team и Enterprise администратору может потребоваться сначала включить коннектор.
Подключение Claude
- В claude.ai откройте Настройки → Connectors.
- Выберите Добавить пользовательский коннектор, введите имя PaperOffice и URL-адрес
https://mcp.paperoffice.ai/claude. Оставьте поля Client ID и Secret пустыми; вход по OAuth начнется автоматически. - Выберите Подключить и войдите в систему с помощью своей учетной записи PaperOffice. Ознакомьтесь с запрошенным доступом и подтвердите его.
- В чате включите инструменты PaperOffice для текущего разговора.
Claude Desktop использует тот же список коннекторов, что и claude.ai. В Claude Code добавьте сервер с помощью команды claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude и завершите вход с помощью /mcp.
Первая проверка: спросите «К каким рабочим пространствам PaperOffice у меня есть доступ?» Claude должен вывести список ваших рабочих пространств.
Подключение ChatGPT и Grok
ChatGPT: откройте Настройки → Connectors, добавьте пользовательский коннектор с именем PaperOffice, URL https://mcp.paperoffice.ai/chatgpt и аутентификацией OAuth, затем подключитесь и войдите в систему. В зависимости от вашего тарифного плана может потребоваться включить режим разработчика для пользовательских коннекторов. Профиль ChatGPT представляет собой тщательно отобранную подборку инструментов; например, он не содержит инструментов для подписи и рабочих процессов.
Grok: откройте grok.com/connectors, создайте пользовательский коннектор с URL https://mcp.paperoffice.ai/grok и войдите в систему, используя свой аккаунт PaperOffice при первом подключении. Профиль Grok также является тщательно отобранной подборкой инструментов.
Подключение Cursor с помощью токена
- Войдите в приложение PaperOffice и откройте Аккаунт → API.
- Создайте токен пользователя или используйте групповой токен от вашего администратора. Вы можете просматривать и копировать токен на странице API в любое время; храните его в безопасности.
- Добавьте сервер в файл mcp.json Cursor с URL-адресом
https://mcp.paperoffice.ai/cursorи токеном в заголовке Authorization как bearer token. - Перезапустите Cursor или перезагрузите серверы MCP.
Никогда не коммитьте файл mcp.json с реальным токеном в репозиторий. Секретные ключи и публичные ключи REST API заблокированы для MCP.
Разрешения: ассистент никогда не получает больше прав, чем Вы
Ассистент работает с разрешениями вошедшего в систему пользователя PaperOffice. Членство в рабочем пространстве, роли, общие папки, правила хранения (WORM) и юридические удержания применяются без изменений. Пользователь с правами только на чтение в PaperOffice остается пользователем с правами только на чтение и в ассистенте.
Каждый инструмент имеет название и указывает, только ли он читает данные или изменяет их. Ассистент использует эти подсказки, чтобы спросить Вас перед тем, как совершить действие. Удаление, очистка корзины и отправка запросов на подпись помечены как деструктивные действия, поэтому ожидайте вопроса с подтверждением. Удаленные документы сначала попадают в корзину PaperOffice и могут быть восстановлены в приложении.
Настройки аккаунта, биллинг, управление пользователями и создание API-ключей недоступны через коннектор. Они остаются в приложении PaperOffice.
Поток данных: что видит ассистент и что получает PaperOffice
- Вы пишете запрос в ассистенте.
- Ассистент решает, какой инструмент PaperOffice вызвать, и отправляет параметры, например поисковый запрос или идентификатор документа, на сервер MCP PaperOffice.
- PaperOffice выполняет вызов с Вашими разрешениями и возвращает результат, например текст одного документа или список имен файлов.
- Результат становится частью Вашего разговора с ассистентом и обрабатывается в соответствии с условиями провайдера ассистента.
PaperOffice не получает Вашу историю чата, Ваши запросы или ответы ассистента. На сервер попадает только сам вызов инструмента: имя инструмента, параметры, время и пользователь. PaperOffice самостоятельно не загружает документы в провайдера ассистента; провайдер получает только то, о чем попросил ассистент.
Каждый вызов инструмента записывается с указанием времени, пользователя и Credits. Администраторы видят вызовы в разделе API и разработка → Использование API.
Биллинг
Каждый вызов инструмента через коннектор оплачивается в Credits, точно так же, как соответствующий вызов API. Отдельной подписки на коннектор нет. Некоторые запросы статуса и проверки работоспособности не тарифицируются; подробности указаны в документации API. Когда средства Credits исчерпываются, вызовы отклоняются с четким сообщением; ничего не удаляется. Подробнее в руководстве по биллингу и Credits: Биллинг и Credits в PaperOffice AI.
Отозвать доступ
- В ассистенте удалите или отключите коннектор PaperOffice. Ассистент немедленно перестает его использовать; разговоры, которые уже содержат результаты PaperOffice, сохраняют этот текст.
- В PaperOffice откройте Аккаунт → API. Подключения ассистента отображаются в списке токенов с значком MCP. Удалите токен этого подключения там же.
- Для Cursor обновите или удалите токен на той же странице.
Отозвать доступ не означает удаление каких-либо данных.
Устранение неполадок
- Окно входа не открывается: разрешите всплывающие окна для ассистента и попробуйте окно инкогнито в браузере. В планах Team или Enterprise спросите администратора, включен ли коннектор.
- Подключено, но инструменты PaperOffice не отображаются: включите инструменты для разговора или начните новый разговор.
- «Unauthorized» (Не авторизован) во время вызова инструмента: соединение было отозвано или истекло. Подключитесь снова. С токеном проверьте, является ли он токеном пользователя или группы.
- Ассистент не находит документы: сначала запросите список рабочих пространств. У подключенного пользователя может не быть доступа к ожидаемому рабочему пространству. Недавно загруженным документам требуется время, пока обработка не завершится.
- Недостаточно Credits: пополните баланс в приложении PaperOffice или включите автопополнение.
Все еще возникли проблемы? Откройте тикет в поддержку с указанием ассистента и плана, точного сообщения, времени с часовым поясом и, если возможно, скриншота без персональных данных.
Рекомендация для ИТ-команд
- Домены для разрешения: mcp.paperoffice.ai, api.paperoffice.ai и app.paperoffice.ai. Весь трафик использует HTTPS; входящее соединение к Вашей сети не требуется.
- Начните с пилотного проекта: одно рабочее пространство и роли только на чтение. Включите роли на запись для каждого рабочего пространства после завершения пилота.
- Регулярно проверяйте использование API в течение первых недель.
Часто задаваемые вопросы
- Нужно ли мне что-то устанавливать? Нет. Ассистент подключается к URL.
- Может ли ассистент видеть все мои документы? Только те, которые доступны Вашему пользователю PaperOffice.
- Читает ли PaperOffice мои чаты? Нет. До PaperOffice доходят только вызовы инструментов.
- Нужна ли отдельная подписка для коннектора? Нет. Вызовы тарифицируются в Credits так же, как API-вызовы.
- Как завершить доступ? Удалите коннектор в ассистенте и удалите токен подключения в разделе Аккаунт → API.