Sendmux Email MCP
официальныйSendmux — это API для почтовых ящиков и API для отправки электронной почты, предназначенные для AI-агентов.
Что можно делать с Sendmux Email MCP?
- Поиск документации Sendmux — Попросите ИИ найти руководства или ссылки на API с помощью
search_sendmuxиз Doc Search MCP. - Управление почтовыми ящиками — Получите список предоставленных почтовых ящиков с помощью
mailbox_list_granted_mailboxes, затем выполняйте поиск, чтение или сортировку писем в конкретном почтовом ящике. - Отправка транзакционных писем — Отправляйте одиночные или массовые письма через интерфейс отправки после авторизации соединения с правом отправки.
- Администрирование ресурсов команды — Управляйте доменами, почтовыми ящиками, учетными записями отправки, журналами, метриками, биллингом и вебхуками через интерфейс управления.
- Запуск локального MCP-сервера — Запустите пакет
sendmux-mcpлокально с ключами API для конкретных интерфейсов почтовых ящиков, управления или инструментов отправки.
Документация
MCP
Подключите инструменты ИИ к документации и продуктовым инструментам Sendmux.
Sendmux имеет два MCP-подключения. Используйте Doc Search MCP, когда хотите, чтобы инструмент ИИ искал в документации Sendmux. Используйте MCP, когда хотите, чтобы агент работал с инструментами Sendmux, которые вы авторизуете.
| Подключение | Используется для | Сервер |
|---|---|---|
| Doc Search MCP | Поиск в руководствах и справочниках API Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Использование инструментов управления, почтовых ящиков и отправки. | https://mcp.sendmux.ai/mcp или локальный пакет sendmux-mcp |
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 предоставляет те продуктовые поверхности, которые вы разрешаете.
| Поверхность | Используется для | Доступ |
|---|---|---|
| Почтовый ящик | Поиск, чтение, организация и отправка из разрешенных почтовых ящиков. | Размещенное разрешение с доступом к почтовому ящику, ключ smx_mbx_ или локально ограниченный токен smx_agent_ |
| Управление | Управление ресурсами команды, такими как домены, почтовые ящики, учетные записи отправки, логи, метрики, биллинг и вебхуки. | Размещенное разрешение с доступом к управлению или локально ключ smx_root_ |
| Отправка | Отправка одиночных или массовых писем. | Размещенное разрешение с доступом к отправке, ключ smx_mbx_ или локально одобренный владельцем токен ресурса отправки smx_agent_ |
Размещенный MCP используется по умолчанию, когда ваш клиент поддерживает удаленный MCP с браузерной OAuth. Это сохраняет Sendmux в потоке авторизации, исключает передачу ручных ключей API агентам и показывает только инструменты, разрешенные разрешением.
| Настройка | Значение |
|---|---|
| URL сервера | https://mcp.sendmux.ai/mcp |
| Сервер авторизации | https://app.sendmux.ai |
| Проверка работоспособности | https://mcp.sendmux.ai/health |
Используйте коллекцию Postman, когда хотите протестировать MCP-запросы из Postman:
При подключении Sendmux попросит вас выбрать команду, продуктовые поверхности и доступ к почтовым ящикам, где это применимо. Токены доступа недолговечны. Токены обновления меняются при использовании и могут действовать до 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
Сервер проверяет префиксы ключей перед запуском. Для управления требуется smx_root_. Отправка принимает ключ smx_mbx_ с возможностью отправки или одобренный владельцем токен ресурса отправки smx_agent_. Почтовый ящик принимает ключ 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 почтового ящика | `SENDMUX_MAILBOX_API_KEY` | Нет | | Ключ API управления | `SENDMUX_MANAGEMENT_API_KEY` | Нет | | Ключ API отправки | `SENDMUX_SENDING_API_KEY` | Нет | | Базовый URL API управления и почтового ящика | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Базовый URL API отправки | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Транспорт | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Хост HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Порт HTTP | `SENDMUX_MCP_PORT` | `8765` | | Путь HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Токен носителя HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Обязательно для HTTP | | Разрешенные источники браузера | `SENDMUX_MCP_ALLOWED_ORIGINS` | Нет источников браузера | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```Обнаружение инструментов
Имена инструментов генерируются из текущих общедоступных поверхностей API. Откройте выбор инструментов вашего MCP-клиента после авторизации, чтобы увидеть инструменты, доступные для этого подключения.Размещенные подключения показывают только инструменты, разрешенные выбранными продуктовыми поверхностями, разрешениями и разрешением на почтовый ящик. Локальные серверы показывают инструменты для поверхностей и ключей, которые вы предоставляете при запуске.