Sendmux Email MCP
официальныйSendmux — это API для почтовых ящиков и API для отправки электронной почты, предназначенные для AI-агентов.
Что можно делать с Sendmux Email MCP?
- Поиск документации Sendmux — Попросите вашего ИИ-ассистента найти руководства и справочники API Sendmux через
search_sendmux. - Управление почтовыми ящиками — Поручите вашему ИИ-ассистенту искать, читать, организовывать и отправлять электронные письма из предоставленных почтовых ящиков с помощью поверхности Mailbox.
- Контроль ресурсов команды — Направьте вашего ИИ-ассистента на управление доменами, почтовыми ящиками, учетными записями отправки, журналами, метриками, биллингом и вебхуками через поверхность Management.
- Отправка электронных писем — Дайте указание вашему ИИ-ассистенту отправлять одиночные или массовые письма с помощью инструментов поверхности Sending.
Документация
MCP
Подключите AI-инструменты к документации Sendmux и продуктовым инструментам.
У Sendmux есть два MCP-подключения. Используйте Doc Search MCP, когда нужно, чтобы AI-инструмент искал в документации Sendmux. Используйте MCP, когда нужно, чтобы агент работал с инструментами Sendmux, которые вы авторизуете.
| Подключение | Для чего использовать | Сервер |
|---|---|---|
| Doc Search MCP | Поиск по руководствам Sendmux и API-справочникам. | https://sendmux.ai/docs/mcp |
| MCP | Использование инструментов Management, Mailbox и Sending. | https://mcp.sendmux.ai/mcp или локальный пакет sendmux-mcp |
Информация
MCP предоставляет курируемый набор инструментов для агентов, а не все конечные точки API. Используйте SDK, CLI или API-справочник, когда нужен полный охват конечных точек.
Doc Search MCP
Doc Search MCP предоставляет search_sendmux.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP предоставляет доступ к продуктовым поверхностям, которые вы разрешаете.
| Поверхность | Для чего использовать | Доступ |
|---|---|---|
| Mailbox | Поиск, чтение, организация и отправка с разрешённых почтовых ящиков. | Хостируемый грант с доступом к Mailbox, ключ smx_mbx_ или ограниченный токен smx_agent_ локально |
| Management | Управление ресурсами команды: доменами, почтовыми ящиками, аккаунтами отправки, журналами, метриками, биллингом и вебхуками. | Хостируемый грант с доступом к Management или ключ smx_root_ локально |
| Sending | Отправка одиночных или массовых писем. | Хостируемый грант с доступом к Sending, ключ smx_mbx_ или одобренный владельцем токен smx_agent_ для ресурса Sending локально |
Хостируемый MCP используется по умолчанию, когда ваш клиент поддерживает удалённый MCP с браузерной OAuth-авторизацией. Он сохраняет Sendmux в процессе авторизации, избегает распространения ручных API-ключей среди агентов и показывает только те инструменты, которые разрешены грантом.
Информация
Идентификатор пакета:
sendmux-mcpВерсия пакета:
2.1.2Хостируемый ресурс:
https://mcp.sendmux.ai/mcpХостируемый транспорт: Streamable HTTP
Количество курируемых инструментов: 54
Сертифицированные версии протокола:
2025-11-25,2026-07-28Принимаемые во время выполнения версии протокола:
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28. Принятие во время выполнения обеспечивает совместимость; оно не сертифицирует каждую версию.
| Настройка | Значение |
|---|---|
| URL сервера | https://mcp.sendmux.ai/mcp |
| Сервер авторизации | https://app.sendmux.ai |
| Проверка работоспособности | https://mcp.sendmux.ai/health |
Используйте коллекцию Postman, когда хотите протестировать MCP-запросы из Postman:
При подключении Sendmux попросит вас выбрать команду, продуктовые поверхности и, где применимо, доступ к почтовым ящикам. Токены доступа недолговечны. Refresh-токены ротируются при использовании и могут действовать до 30 дней, если подключение не разорвано и не истёк срок действия.
Примечание
Если вы предоставляете доступ более чем к одному почтовому ящику, начинайте рабочие процессы с почтовыми ящиками с
mailbox_list_granted_mailboxesи передавайте возвращённыйmailbox_idинструментам, которые работают с одним почтовым ящиком.
Режимы подключения
Используйте, когда ваш клиент может открыть браузерный MCP OAuth-поток. Используйте, когда ваш кодирующий агент может запустить локальную команду на вашей машине. Используйте, когда клиенту нужен URL, но вы сами запускаете MCP-пакет.Локальный пакет
Установите локальный пакет из PyPI:
pip install sendmux-mcp
Запустите одну поверхность:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Запустите все продуктовые поверхности:
SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp
Сервер проверяет префиксы ключей перед запуском. Management требует smx_root_. Sending принимает ключ smx_mbx_ с правом отправки или одобренный владельцем токен smx_agent_ для ресурса Sending. Mailbox принимает ключ smx_mbx_ или ограниченный токен smx_agent_.
Приватный HTTP
Режим HTTP полезен, когда ваш MCP-клиент подключается к URL сервера, но вы хотите запускать пакет самостоятельно.
SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765
Конечная точка по умолчанию — /mcp. /health возвращает выбранные поверхности. Режим HTTP требует SENDMUX_MCP_HTTP_BEARER_TOKEN, если вы явно не запустите его с --allow-unauthenticated-http.
Справочник по конфигурации
| Настройка | Переменная окружения | По умолчанию | | - | - | - | | Поверхности инструментов | `SENDMUX_MCP_SURFACES` | Требуется для `sendmux-mcp` | | Резервный API-ключ | `SENDMUX_API_KEY` | Нет | | API-ключ Mailbox | `SENDMUX_MAILBOX_API_KEY` | Нет | | API-ключ Management | `SENDMUX_MANAGEMENT_API_KEY` | Нет | | API-ключ Sending | `SENDMUX_SENDING_API_KEY` | Нет | | Базовый URL API Management и Mailbox | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Базовый URL API Sending | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Бюджет времени на повторы, в секундах | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Не задан | | Транспорт | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTP-хост | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP-порт | `SENDMUX_MCP_PORT` | `8765` | | HTTP-путь | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP bearer-токен | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Требуется для HTTP | | Разрешённые браузерные источники | `SENDMUX_MCP_ALLOWED_ORIGINS` | Нет браузерных источников | ```bash theme={null} SENDMUX_MCP_SURFACES=mailbox,management,sending \ SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \ SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \ SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \ sendmux-mcp ```Обнаружение инструментов
Имена инструментов генерируются из текущих публичных API-поверхностей. Откройте выбор инструментов вашего MCP-клиента после авторизации, чтобы увидеть инструменты, доступные для этого подключения.Хостируемые подключения показывают только инструменты, разрешённые выбранными продуктовыми поверхностями, правами и грантом на почтовые ящики. Локальные серверы показывают инструменты для поверхностей и ключей, которые вы предоставляете при запуске.