DashaMail

DashaMail MCP Server

MCP-сервер сервиса email-маркетинга DashaMail: даёт ИИ-агенту доступ к аккаунту — адресные базы, рассылки, отчёты, шаблоны, автоматизации, сегменты, транзакционные письма, вебхуки и входящая почта.

Сервер удалённый, разворачивать ничего не нужно.

Адрес	https://mcp.dashamail.ru/
Транспорт	Streamable HTTP, протокол MCP 2025-06-18
Авторизация	OAuth 2.1 + PKCE + динамическая регистрация клиента, либо API-ключ
Инструментов	107 (список)
В реестре	ru.dashamail/mcp
Документация	https://dashamail.ru/api/mcp/

Исходный код сервера закрыт — репозиторий нужен для описания и обратной связи. Ошибки и пожелания: issues или [email protected].

Подключение

Нужен аккаунт DashaMail — зарегистрироваться. Бесплатного тарифа достаточно, чтобы подключиться и посмотреть.

Claude

Settings → Connectors → Add custom connector, адрес https://mcp.dashamail.ru/. Откроется экран согласия DashaMail, где вы выбираете, какие разделы аккаунта доступны агенту.

Cursor, VS Code и другие клиенты

{
  "mcpServers": {
    "dashamail": {
      "url": "https://mcp.dashamail.ru/"
    }
  }
}

Клиент сам зарегистрируется по OAuth. Если клиент OAuth не умеет, передайте API-ключ заголовком:

{
  "mcpServers": {
    "dashamail": {
      "url": "https://mcp.dashamail.ru/",
      "headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
    }
  }
}

Что важно знать

Сначала черновик. Создание рассылки никогда не запускает отправку — для этого есть отдельные инструменты campaigns_schedule и campaigns_send_now. Так агент не разошлёт письма, «помогая» с черновиком.

Подтверждение перед отправкой. У двенадцати инструментов, которые отправляют письма или удаляют данные, проставлен destructiveHint — клиент спрашивает подтверждение перед каждым вызовом. Чтение идёт без вопросов.

Права выбираете вы. На экране согласия видно, какие разделы аккаунта запрашивает клиент; выбор меняется потом в кабинете. Токен ограничен выбранным.

Чужой текст помечен. Ответ подписчика на рассылку и значение поля из формы — это данные, а не указания агенту. У инструментов, которые такой текст возвращают, это написано в описании; флаг ?no_ugc=1 убирает его из ответов совсем.

Справочники отдельно от инструментов. Сервер отдаёт пять ресурсов MCP (dashamail://docs/metrics, docs/segments, docs/personalization, docs/errors, account/summary): формулы метрик, формат условий отбора, подстановки в письме, коды ошибок и состояние аккаунта. Клиент прикладывает их к разговору целиком, вместо того чтобы агент вычитывал одно и то же из описания каждого инструмента.

Файл и проверка — прямо из разговора. imports_start принимает файл содержимым — CSV текстом, остальное в base64, — так что базу, собранную в переписке, не нужно выкладывать по ссылке. campaigns_test с member_email заполняет подстановки данными выбранного подписчика: персональный вариант письма проверяется до запуска.

Отчёт карточкой. В клиентах с поддержкой MCP Apps — например, в Claude — reports_dashboard показывает итоги рассылки интерактивной карточкой прямо в переписке: доставка, открытия, клики, отписки, график по часам за первые трое суток, почтовые домены и ссылки; на полном экране переключаются последние рассылки. Доли считаются от доставленных, как в отчёте кабинета. Остальные клиенты получают ту же сводку текстом.

Три параметра для сужения:

Параметр	Что делает
?readonly=1	убирает все изменяющие инструменты, остаётся только чтение
?toolset=core	короткий набор (~40) для клиентов с малым контекстом
?no_ugc=1	ответы без текста, написанного посторонними

Например: https://mcp.dashamail.ru/?readonly=1&toolset=core

可以做什么

• 汇总并清理地址库，在发送前检查其健康状况；
• 按主题或发件人设置 A/B 测试，24 小时后分析结果，找出胜出版本并发送给其余用户；
• 根据简报起草邮件，安排发送时间，然后分析报告——按域名、链接、地理位置和设备查看打开、点击、退信和退订情况；
• 查明客户为何未收到事务性邮件；
• 无需打开管理后台，即可比较不同时间段和渠道。

链接

• MCP 服务文档
• 功能页面
• REST API v2
• Smithery 目录中的服务
• 个人数据处理政策 (English)

许可证

MIT — 适用于此仓库的内容：说明、工具列表和服务清单。不适用于 MCP 服务和 DashaMail 服务：它们的代码是闭源的，且不会在此发布。

---

English

DashaMail 的 MCP 服务（DashaMail 是一家服务俄罗斯企业的电子邮件营销服务）。它让 AI Agent 能够访问账户：订阅者列表及其成员、营销活动、报告、模板、自动化、事务性邮件、细分、对话、Webhook 和入站路由——共 107 个工具。

该服务是远程服务，地址为 https://mcp.dashamail.ru/，使用 Streamable HTTP。身份验证采用 OAuth 2.1、PKCE 和动态客户端注册；也支持在 Authorization 标头中使用 API 密钥。需要 DashaMail 账户。

该服务的设计以草稿为先：创建营销活动不会发送邮件。发送、安排发送时间和删除操作都带有 destructiveHint，因此客户端会在每次调用前请求确认；只读工具则无需提示即可运行。用户可在授权页面选择权限范围，之后也可更改。?readonly=1 会移除所有写入工具，?toolset=core 会提供适用于小型上下文窗口的精简工具集，而 ?no_ugc=1 会移除外部人员撰写的文本——订阅者填写的字段值和收到的邮件——这些内容在工具描述中会被标记为数据，而非指令。

除工具外，该服务还提供五种 MCP 资源：指标定义及其计算基准、细分条件格式、合并标签和条件区块、错误代码，以及账户快照。这样，客户端可以一次性附加参考资料，无需 Agent 从每个工具的描述中反复读取。

imports_start 接受文件内容作为输入（CSV 使用文本，其他格式使用 base64），因此，在对话中整理出的列表无需公开链接；campaigns_test 使用 member_email 时，会从选定的订阅者填充合并标签，因此可以在发送前检查个性化邮件版本。

在支持 MCP Apps 的客户端（例如 Claude）中，reports_dashboard 会将营销活动报告渲染为对话中的交互式卡片：展示送达、打开、点击、退订情况，首三天的逐小时图表、邮件域名和链接，以及全屏模式下用于切换近期营销活动的切换器。比率以已送达邮件为基数，与 DashaMail 仪表板报告中的口径相同。其他客户端会以文本形式显示相同的摘要。

服务源代码为闭源；此仓库包含说明，也是提交问题的地方。工具列表：TOOLS.md。支持邮箱：[email protected]。

此仓库的内容——说明、工具列表和服务清单——以 MIT 许可证 发布。MCP 服务和 DashaMail 服务不适用该许可证。