Использование PaperOffice с Claude, ChatGPT, Grok и Cursor (MCP): полное руководство

Что делает коннектор

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

  1. В claude.ai откройте Настройки → Connectors.
  2. Выберите Добавить пользовательский коннектор, введите имя PaperOffice и URL-адрес https://mcp.paperoffice.ai/claude. Оставьте поля Client ID и Secret пустыми; вход по OAuth начнется автоматически.
  3. Выберите Подключить и войдите в систему с помощью своей учетной записи PaperOffice. Ознакомьтесь с запрошенным доступом и подтвердите его.
  4. В чате включите инструменты 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 с помощью токена

  1. Войдите в приложение PaperOffice и откройте Аккаунт → API.
  2. Создайте токен пользователя или используйте групповой токен от вашего администратора. Вы можете просматривать и копировать токен на странице API в любое время; храните его в безопасности.
  3. Добавьте сервер в файл mcp.json Cursor с URL-адресом https://mcp.paperoffice.ai/cursor и токеном в заголовке Authorization как bearer token.
  4. Перезапустите Cursor или перезагрузите серверы MCP.

Никогда не коммитьте файл mcp.json с реальным токеном в репозиторий. Секретные ключи и публичные ключи REST API заблокированы для MCP.

Разрешения: ассистент никогда не получает больше прав, чем Вы

Ассистент работает с разрешениями вошедшего в систему пользователя PaperOffice. Членство в рабочем пространстве, роли, общие папки, правила хранения (WORM) и юридические удержания применяются без изменений. Пользователь с правами только на чтение в PaperOffice остается пользователем с правами только на чтение и в ассистенте.

Каждый инструмент имеет название и указывает, только ли он читает данные или изменяет их. Ассистент использует эти подсказки, чтобы спросить Вас перед тем, как совершить действие. Удаление, очистка корзины и отправка запросов на подпись помечены как деструктивные действия, поэтому ожидайте вопроса с подтверждением. Удаленные документы сначала попадают в корзину PaperOffice и могут быть восстановлены в приложении.

Настройки аккаунта, биллинг, управление пользователями и создание API-ключей недоступны через коннектор. Они остаются в приложении PaperOffice.

Поток данных: что видит ассистент и что получает PaperOffice

  1. Вы пишете запрос в ассистенте.
  2. Ассистент решает, какой инструмент PaperOffice вызвать, и отправляет параметры, например поисковый запрос или идентификатор документа, на сервер MCP PaperOffice.
  3. PaperOffice выполняет вызов с Вашими разрешениями и возвращает результат, например текст одного документа или список имен файлов.
  4. Результат становится частью Вашего разговора с ассистентом и обрабатывается в соответствии с условиями провайдера ассистента.

PaperOffice не получает Вашу историю чата, Ваши запросы или ответы ассистента. На сервер попадает только сам вызов инструмента: имя инструмента, параметры, время и пользователь. PaperOffice самостоятельно не загружает документы в провайдера ассистента; провайдер получает только то, о чем попросил ассистент.

Каждый вызов инструмента записывается с указанием времени, пользователя и Credits. Администраторы видят вызовы в разделе API и разработка → Использование API.

Биллинг

Каждый вызов инструмента через коннектор оплачивается в Credits, точно так же, как соответствующий вызов API. Отдельной подписки на коннектор нет. Некоторые запросы статуса и проверки работоспособности не тарифицируются; подробности указаны в документации API. Когда средства Credits исчерпываются, вызовы отклоняются с четким сообщением; ничего не удаляется. Подробнее в руководстве по биллингу и Credits: Биллинг и Credits в PaperOffice AI.

Отозвать доступ

  1. В ассистенте удалите или отключите коннектор PaperOffice. Ассистент немедленно перестает его использовать; разговоры, которые уже содержат результаты PaperOffice, сохраняют этот текст.
  2. В PaperOffice откройте Аккаунт → API. Подключения ассистента отображаются в списке токенов с значком MCP. Удалите токен этого подключения там же.
  3. Для 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.