SuperMailbox · руководство по интеграции с CRM

Подключите SuperMailbox к CRM

Каждый пользователь CRM получает защищённое OAuth-подключение к выбранным почтовым ящикам. CRM сможет находить переписку с клиентами, показывать проверенный контекст писем и готовить или отправлять ответы через MCP-сервер SuperMailbox.

Как работает подключение

01

Подключите почту

Пользователь подключает Gmail, Outlook или другой поддерживаемый ящик к SuperMailbox. Вход у почтового провайдера — отдельный шаг, не OAuth CRM.

02

Авторизуйте CRM

CRM открывает OAuth SuperMailbox в браузере. Пользователь входит, проверяет название клиента и запрошенные права, затем подтверждает подключение.

03

Используйте MCP-инструменты

CRM обращается к удалённому MCP-серверу с токеном пользователя. Пользователь выбирает доступный ему ящик, а CRM работает в пределах выданных прав.

Параметры подключения

Используйте MCP-клиент или SDK с поддержкой удалённого Streamable HTTP и обнаружения OAuth. Клиент должен провести вход через браузер и передавать полученный токен с MCP-запросами.

URL MCP-сервера
https://api.supermailbox.app/mcp
Авторизация
OAuth 2.0 · Authorization Code · PKCE S256
Права доступа
openid email mail.accounts.read mail.messages.read mail.send

Запрашивайте только права, нужные вашему сценарию. CRM, которая читает переписку и отправляет ответы, может запросить:

Найдите письмо и проверьте переписку

  • Вызовите list_mail_accounts, чтобы пользователь выбрал доступный ящик. canSend — подсказка; право на отправку проверяется повторно при выполнении действия.
  • Ищите кандидатов с помощью search_emails или search_threads_by_recipient. Поиск по получателю возвращает только метаданные; загрузите выбранную переписку и проверьте её перед привязкой к записи CRM.
  • Результаты могут быть ограниченными или неполными. Учитывайте поля coverage и completeness: пустая неполная выдача не доказывает отсутствие писем.
  • Идентификаторы ящиков, писем и переписок непрозрачны и принадлежат правам текущего пользователя. Ищите и проверяйте их только в его подключении.

Готовьте и отправляйте ответы безопасно

  • До подтверждения отправки покажите в CRM выбранный ящик, получателя и текст ответа.
  • send_email и reply_to_email возвращают операцию в очереди. Проверяйте её через get_mail_action с тем же operation ID и нужными правами до окончательного статуса.
  • Ответ о постановке в очередь не подтверждает доставку. Если отправка завершилась неопределённо, проверьте ту же операцию; не запускайте повтор автоматически с новым ID.

Безопасность и управление доступом

  • Используйте поток OAuth authorization code с PKCE S256 через штатное обнаружение MCP-клиента. Храните секреты и токены на сервере, не передавайте их в браузерный код и логи.
  • Создавайте отдельное подключение для каждого пользователя CRM. Не передавайте токен или идентификаторы почты одного пользователя другому.
  • Запрашивайте mail.send, только если CRM отправляет письма. Пользователь может отозвать доступ CRM в настройках подключённых приложений SuperMailbox.