Подключите SuperMailbox к CRM
Каждый пользователь CRM получает защищённое OAuth-подключение к выбранным почтовым ящикам. CRM сможет находить переписку с клиентами, показывать проверенный контекст писем и готовить или отправлять ответы через MCP-сервер SuperMailbox.
Как работает подключение
Подключите почту
Пользователь подключает Gmail, Outlook или другой поддерживаемый ящик к SuperMailbox. Вход у почтового провайдера — отдельный шаг, не OAuth CRM.
Авторизуйте CRM
CRM открывает OAuth SuperMailbox в браузере. Пользователь входит, проверяет название клиента и запрошенные права, затем подтверждает подключение.
Используйте 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.

