MCP-сервер UniOne и Unisender Go
mcp-unione
MCP-сервер для транзакционной почты UniOne и Unisender Go с защитой от случайной отправки и офлайн-базой знаний по API
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может отправлять реальные письма получателям, но только после явного confirm_send=true
- Может удалять шаблоны, вебхуки, домены и записи в списках подавления
Установка
Ручная установка
uv sync && uv run mcp-unioneУстановка и запуск сервера по stdio из исходников.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает транзакционный веб-API UniOne (он же Unisender Go) 32 типизированными инструментами по десяти областям: отправка письма и запрос подписки, проверка адреса, шаблоны, вебхуки, списки подавления, проверка домена и DKIM, выгрузки событий, теги и проекты. Отдельно есть четыре инструмента документации: полнотекстовый поиск по встроенной базе знаний примерно на 4000 строк документации, получение живой страницы документации, расшифровка кода ошибки UniOne с причиной и решением и расшифровка статуса доставки письма. Главная защита: unione_send_email не отправляет письмо по умолчанию, а возвращает предпросмотр получателей, темы и движка, реальная отправка требует явного параметра confirm_send=true, а sandbox=true прогоняет письмо через тестовый домен без реальной доставки.
Для кого. Для разработчиков, которые настраивают транзакционную рассылку через UniOne или Unisender Go и хотят делать это безопасно через агента.
Подходит, если
- Нужно собрать и проверить письмо перед отправкой без риска реальной рассылки
- Нужно разобраться, почему письмо не дошло, по коду ошибки или статусу доставки
- Нужно настроить домен, DKIM, вебхуки или шаблоны без чтения полной документации UniOne
Не подходит, если
- Нет API-ключа UniOne, хотя инструменты документации и базы знаний работают и без него
- Нужна массовая маркетинговая рассылка по большим спискам: сервис и сервер сфокусированы на транзакционных письмах
Пример запроса к агенту
Собери транзакционное письмо о подтверждении заказа через UniOne и покажи предпросмотр, прежде чем отправлятьОграничения
Проект одного автора, но с хорошо развитой инженерией: релизы по semver, публикация образа в GitHub Container Registry и 67 тестов с замоканными HTTP-запросами. Отправка без пометки skip_unsubscribe добавляет футер отписки, который Gmail иногда трактует как маркетинг и уводит письмо во вкладку Промоакции. Опцию skip_unsubscribe сначала нужно включить в самом аккаунте UniOne.
Как отключить. Удалите запись unione из конфигурации MCP клиента или остановите контейнер Docker.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| UNIONE_API_KEY секрет | Ключ API UniOne, нужен только для реальных вызовов, инструменты документации работают без него. |
| UNIONE_REGION | Регион API: eu, us или global, по умолчанию eu. |
Проверка безопасности
- Может отправлять реальные письма получателям, но только после явного confirm_send=true
- Может удалять шаблоны, вебхуки, домены и записи в списках подавления
Коротко о README
README на английском подробно описывает быстрый старт через uv и Docker, конфигурацию переменных окружения с регионами API, защиту send guard с подробным объяснением футера отписки и его влияния на попадание в Промоакции, таблицы из 32 инструментов по десяти доменам, 20 ресурсов базы знаний и двух управляемых промптов, а также автоматизированный релизный процесс.
Частые вопросы
Может ли агент случайно отправить письмо?
Нет, unione_send_email без confirm_send=true только показывает предпросмотр и ничего не отправляет, это осознанная защита от случайной отправки.
Работают ли инструменты без API-ключа?
Да, поиск по базе знаний, чтение документации и расшифровка ошибок работают без ключа, он нужен только для реальных вызовов API.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub