Sendmux Email MCP Server
официальныйSendmux — это API для почтовых ящиков и API для отправки электронной почты, предназначенные для AI-агентов.
Документация
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` инструментам, которые работают с одним почтовым ящиком.Режимы подключения
Используйте, когда ваш клиент может открыть поток OAuth MCP в браузере. Используйте, когда ваш агент по кодированию может запустить локальную команду на вашей машине. Используйте, когда клиенту нужен 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-клиента после авторизации, чтобы увидеть инструменты, доступные для этого подключения.Размещенные подключения показывают только инструменты, разрешенные выбранными продуктовыми областями, разрешениями и предоставленным доступом к почтовому ящику. Локальные серверы показывают инструменты для областей и ключей, которые вы предоставляете при запуске.