Подключили B2B email‑платформу к голосовым ассистентам через MCP. Архитектура, код, где ломается
Как LDM использует MCP‑сервер, чтобы один API обслуживал как веб‑дашборд, так и голосовые навыки, и какие узкие места обнаружились в полевых тестах.
Голосовые ассистенты обещают «руки‑свободные» операции, но в B2B‑почтовых платформах часто приходится поддерживать два набора API: один для веб‑интерфейса, второй – для внешних агентов. Дублирование кода, разные схемы аутентификации и разрозненная бизнес‑логика делают интеграцию дорогой и ошибко‑устойчивой.
В статье показано, как LDM (Live Direct Marketing) объединила эти слои через MCP‑сервер, сохранив единую поверхность /api/* и решив проблему синхронности, а также раскрыты реальные «поломки», обнаруженные на выставке VODEXPO 2026.
Ключевое решение – «UI = MCP». Все эндпоинты (как веб‑дешборд, так и голосовые навыки) находятся под одним префиксом /api/* и защищаются HybridAuthGuard. Guard умеет распознавать два типа токенов: сессионный cookie для браузера и Bearer‑ключ формата ldm_pk_* для MCP‑агентов. После проверки токена запрос попадает в тот же контроллер, один набор scope‑чеков и одна бизнес‑логика.
Каждая возможность (email:send, crm:read, dialogs:write и т.д.) описана в /.well-known/agent-card.json и привязывается к набору scope‑ов. При выдаче Bearer‑ключа можно ограничить навыку только теми действиями, которые действительно нужны (например, только отправка писем и чтение диалогов).
HybridAuthGuard позволяет обслуживать и веб‑пользователей, и голосовые навыки одной кодовой базой, что избавляет от создания отдельного agent‑API и упрощает поддержку.
Типичные проблемы при голосовой интеграции
- Ограниченная точность распознавания
Имена брендов («Apple», «Acme») часто транскрибируются неверно, что приводит к ошибочным запросам.
- Сложные фильтры в реальном времени
Многопараметрические запросы (например, «компании Москва + 50–500 сотрудников + e‑commerce») тяжело описать в голосе без UI‑поддержки.
- Обновление OAuth‑токенов
Смена пароля в Яндекс‑аккаунте приводит к потере привязки и требует переавторизации.
- Латентность цепочки
STT → Claude → MCP → API → TTS занимает 4–8 секунд, что приемлемо для рассылок, но ощущается в диалоговом UX.
Пошаговый сценарий голосовой рассылки (пример VODEXPO 2026)
- 011️⃣ Выбор сегмента
GET /api/contacts?tagId=landscape-designers&subscribed=1&pageSize=500 → 247 контактов
- 022️⃣ Выбор креатива
GET /api/creatives?search=каталог+водоёмы&latest=1 → creativeId
- 033️⃣ Создание задачи рассылки
POST /api/tasks {methodId:2, creativeId:'…', contactListId:'ad‑hoc', accountId:'…'} → taskId, статус DRAFT
- 044️⃣ Самоутверждение задачи (scope: mailing:write)
POST /api/mailing/{taskId}/approve {note:'Voice‑approved, VODEXPO booth'}
- 055️⃣ Старт рассылки
POST /api/tasks/{taskId}/start → статус ACTIVE
Web UI vs Voice Agent
Web UI
- Полный набор scope‑ов (`*`)
- Низкая латентность (<200 мс)
- Поддержка сложных фильтров и визуального редактирования креативов
Voice Agent
- Ограниченный набор scope‑ов (email:send, dialogs:read …)
- Латентность 4–8 с
- Подходит для быстрых брифингов, запуска готовых рассылок и проверки статусов
Ключевые метрики VODEXPO‑рассылки
Отправлено контактов
247
Доставлено в Inbox
231
Попало в Spam
4
В ожидании проверки
12
Объединение UI и MCP в едином API позволило LDM быстро добавить голосовой канал без дублирования кода и с чётким контролем прав доступа. Реальный кейс VODEXPO показал, что голосовые команды работают надёжно для простых сценариев (брифинг, запуск готовой рассылки, проверка статуса), но сталкиваются с ограничениями в сложных фильтрах, точности распознавания и латентности.
Если вы планируете расширить свои B2B‑инструменты голосовым интерфейсом, начните с построения единой API‑поверхности, чётко определите scope‑ы и добавьте подтверждения для критичных действий. А для повышения стабильности уже сейчас стоит внедрить автоматическое обновление OAuth‑токенов и упрощённые ответы в TTS.
Готовы попробовать голосовое управление в своей email‑платформе? Свяжитесь с командой DIL LEAD — мы поможем построить MCP‑слой и подготовить кастомный навык под ваш бизнес.
Хотите обсудить свою нишу?
Напишите менеджеру DIL LEAD или подпишитесь на Telegram-канал.