Поддержка MCP

Подключите вашего ИИ-помощника к Unbox

Используйте Model Context Protocol (MCP), чтобы доверенный ИИ-агент мог помогать вам с вашим доменным почтовым ящиком — искать письма, составлять ответы, отправлять почту и управлять спамом или корзиной — с теми же ограничениями и безопасностью, что и веб-приложение Unbox.

Обзор

Unbox MCP предназначен для владельцев личных аккаунтов, которые хотят использовать ИИ-помощника — в Cursor, Workbuddy, OpenClaw или любом другом MCP-совместимом хосте — для работы со своей хостинговой почтой. Это не API для разработчиков, предназначенный для создания приложений на Unbox; для транзакционной отправки с вашего домена обратитесь к документации по HTTP API.

ПротоколModel Context Protocol (MCP)

ОбластьЛичный почтовый ящик — чтение, поиск, ответ, отправка, спам и корзина

АутентификацияВход через браузер → кратковременная сессия

Что могут делать агенты

После входа ваш агент сможет использовать инструменты Unbox от вашего имени:

Чтение входящих и цепочек писем — Просмотр списка бесед, открытие цепочки и получение отдельных сообщений.
Поиск писем — Поиск сообщений в вашем почтовом ящике с помощью запросов на естественном языке.
Отправка и ответ — Создание нового письма или ответ в цепочке с ваших адресов Unbox, с учетом лимитов отправки вашего тарифа.
Организация — Пометить как спам, восстановить из спама, переместить в корзину или восстановить — по одному сообщению.

Массовая очистка спама или корзины, генерация ключей API и действия в командном рабочем пространстве недоступны через MCP в версии v1.

Как это работает

Ваш ИИ-клиент подключается к серверу Unbox MCP. Сервер вызывает API учетной записи Unbox, используя обычную веб-сессию — такую же, как при входе на unbox.im.

Добавьте Unbox в конфигурацию вашего MCP-клиента (см. раздел «Настройка» ниже).
Попросите агента войти в систему — он откроет ссылку в браузере, где вы подтвердите доступ с помощью вашей учетной записи Unbox.
После подключения попросите агента читать почту, составлять ответы или организовывать сообщения.

Вход

Unbox использует вход через браузер, чтобы вы всегда подтверждали доступ. Ваш агент запускает процесс с помощью инструментов входа, а затем вы завершаете вход в браузере:

Ваш агент вызывает unbox_login_start и показывает вам URL в браузере.
Откройте ссылку, войдите в Unbox при необходимости и скопируйте одноразовый код ссылки, отображаемый на странице.
Вставьте код обратно агенту (unbox_login_complete).
Ваша сессия остается активной в течение обычного периода веб-сессии Unbox — войдите снова по истечении срока.

URL для входа (справочно)

https://unbox.im/ru/auth/desktop/link?source=mcp

Сначала нужна учетная запись? Создайте Unbox ID, затем вернитесь, чтобы подключить агента.

Настройка

Добавьте Unbox как MCP-сервер в вашем ИИ-клиенте. Удаленный HTTP-транспорт — это самый простой способ подключения к облаку Unbox:

Удалённый HTTP (рекомендуется)

Направьте ваш MCP-клиент на конечную точку Unbox MCP. После добавления сервера используйте инструменты входа для аутентификации:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP может быть отключён в некоторых развёртываниях до включения оператором. Если подключение не удаётся, повторите попытку позже или обратитесь в поддержку.

Распространённые инструменты

После входа ваш агент может использовать такие инструменты, как:

unbox_login_start — открыть вход через браузер
unbox_login_complete — обменять код ссылки на сессию
unbox_list_threads — лента входящих
unbox_search_inbox — поиск сообщений
unbox_reply_to_email — ответить на сообщение
unbox_send_email — отправить новое письмо

Поддерживаемые клиенты

Любой MCP-совместимый хост агента может подключиться к Unbox. Мы тестируем и документируем:

Cursor — Добавьте Unbox в раздел MCP серверов в настройках Cursor, затем войдите через браузер.
Workbuddy — Настройте URL удалённого MCP-сервера, указывающий на Unbox, затем выполните аутентификацию с вашей учётной записью.
OpenClaw — Подключите OpenClaw к конечной точке Unbox MCP HTTP и завершите вход через браузер.

Безопасность

Вход через браузер — Вы входите через Unbox в своём браузере — агенты никогда не видят ваш пароль.
Только владелец аккаунта — Доступ к MCP ограничен владельцем личного аккаунта, а не участниками команды или общими рабочими пространствами.
Те же ограничения, что и в веб-приложении — Лимиты отправки, правила спама и транзакционная политика применяются к действиям агента так же, как и в интерфейсе входящих.
Нет массового удаления — Агенты не могут очищать спам, корзину или менять API-ключи через MCP в версии 1.

Создать бесплатный аккаунт Документация по транзакционному API