@multimail/mcp-server

MCP-сервер для MultiMail. Предоставьте своему агенту собственный адрес электронной почты с поэтапным контролем со стороны человека — от полного одобрения до автономной отправки.

Быстрый старт

npx @multimail/mcp-server

Установите MULTIMAIL_API_KEY для полного доступа или запустите без него, чтобы сначала создать учетную запись. Получите ключ на multimail.dev.

Используя MultiMail, вы соглашаетесь с Условиями обслуживания и Политикой допустимого использования.

Related MCP server: MCP Email Server

Настройка

Вариант А: Удаленный сервер (рекомендуется)

Установка не требуется. Подключайтесь напрямую к нашему размещенному серверу. Аутентификация через OAuth в браузере.

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

Работает с Claude.ai, Claude Desktop, Claude Code и любым клиентом, поддерживающим удаленные MCP-серверы.

Вариант Б: Локальный сервер (stdio)

Запустите сервер локально. API-ключ передается как переменная окружения.

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

Где это добавить

Клиент	Файл конфигурации
Claude Code	`~/.claude/.mcp.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json` в вашем проекте
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Copilot (VS Code)	`.vscode/mcp.json` в вашем проекте
OpenCode	`mcp.json` в вашем проекте
ChatGPT Desktop	Настройки > MCP Servers
Любой MCP-клиент	Обратитесь к документации вашего клиента для поиска места конфигурации

Переменные окружения

Переменная	Обязательно	Описание
`MULTIMAIL_API_KEY`	Да	Ваш API-ключ MultiMail (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	Нет	ID почтового ящика по умолчанию. Если не задано, передавайте `mailbox_id` в каждый инструмент или сначала вызовите `list_mailboxes`.
`MULTIMAIL_API_URL`	Нет	Базовый URL API. По умолчанию `https://api.multimail.dev`.

Настройка при первом запуске

При первом использовании MultiMail предложит вам настроить почтовый ящик. Вы также можете сделать это явно с помощью инструмента configure_mailbox:

Режим контроля: Какой уровень одобрения человеком требуется (gated_send, monitored, autonomous и т. д.)
Отображаемое имя: Имя отправителя, отображаемое в письмах
CC/BCC по умолчанию: Автоматическая копия адресов во всех исходящих письмах
Планирование: Включение/выключение запланированной отправки и установка времени ожидания по умолчанию
Подпись: Блок подписи письма

Если вы пропустите этот шаг, MultiMail напомнит вам об этом при первом вызове инструмента.

Инструменты

Инструмент	Описание
`list_mailboxes`	Список всех почтовых ящиков, доступных для этого API-ключа
`configure_mailbox`	Настройка параметров почтового ящика: режим контроля, отображаемое имя, CC/BCC, планирование, подпись
`send_email`	Отправка письма с телом в формате markdown. Поддерживает вложения, `idempotency_key` и `send_at` для запланированной доставки.
`check_inbox`	Список писем с фильтрами: статус, отправитель, тема, диапазон дат, направление, вложения, курсорная пагинация
`read_email`	Получение полного содержимого письма. Возвращает доверенные метаданные и недоверенное тело как отдельные блоки контента.
`reply_email`	Ответ на письмо в существующей ветке. Поддерживает вложения и `idempotency_key`.
`download_attachment`	Скачивание вложения письма в формате base64 с типом контента
`get_thread`	Получение всех писем в ветке обсуждения с участниками и метаданными
`cancel_message`	Отмена ожидающего или запланированного письма
`schedule_email`	Планирование письма для будущей доставки с обязательным временем `send_at`. Редактируйте или отменяйте до отправки.
`edit_scheduled_email`	Редактирование времени доставки, получателей, темы или тела запланированного письма до его отправки
`update_mailbox`	Обновление настроек почтового ящика (отображаемое имя, режим контроля, подпись, вебхуки)
`update_account`	Обновление настроек учетной записи (название организации, email для контроля, физический адрес)
`delete_mailbox`	Безвозвратное удаление почтового ящика (требуются права администратора)
`request_challenge`	Запрос задачи proof-of-work ALTCHA для создания учетной записи (API-ключ не требуется)
`create_account`	Создание новой учетной записи с решенной задачей PoW (API-ключ не требуется)
`resend_confirmation`	Повторная отправка письма с кодом активации (API-ключ не требуется)
`activate_account`	Активация учетной записи с использованием кода из письма подтверждения (API-ключ не требуется)
`tag_email`	Установка, получение или удаление тегов «ключ-значение» для писем (постоянная память агента)
`add_contact`	Добавление контакта в адресную книгу с дополнительными тегами
`search_contacts`	Поиск в адресной книге по имени или email
`get_account`	Получение статуса учетной записи, плана, квоты, возможности отправки, уровня принудительного контроля
`create_mailbox`	Создание нового почтового ящика (требуются права администратора)
`request_upgrade`	Запрос повышения режима контроля (лестница доверия)
`apply_upgrade`	Применение кода повышения от оператора
`get_usage`	Проверка квоты и статистики использования за расчетный период
`list_pending`	Список писем, ожидающих решения по контролю (требуются права контроля)
`decide_email`	Одобрение или отклонение ожидающего письма (требуются права контроля)
`delete_contact`	Удаление контакта из адресной книги
`check_suppression`	Список заблокированных адресов электронной почты
`remove_suppression`	Удаление адреса из списка блокировки
`list_api_keys`	Список всех API-ключей (требуются права администратора)
`create_api_key`	Создание нового API-ключа с областями доступа (требуются права администратора + одобрение оператора; комбинации `send`+`oversight` отклоняются для предотвращения самоодобрения)
`revoke_api_key`	Отзыв API-ключа (требуются права администратора)
`get_audit_log`	Получение журнала аудита учетной записи (требуются права администратора)
`delete_account`	Безвозвратное удаление учетной записи и всех данных (требуются права администратора)
`wait_for_email`	Блокировка до прихода нового письма, соответствующего фильтрам, или по тайм-ауту (макс. 120 с)
`create_webhook`	Создание подписки на вебхук для уведомлений о событиях электронной почты в реальном времени
`list_webhooks`	Список всех подписок на вебхуки для этой учетной записи
`delete_webhook`	Удаление подписки на вебхук

Как это работает

Вы пишете тело письма в markdown. MultiMail преобразует его в форматированный HTML для доставки.
Входящая почта приходит в виде чистого markdown. Никакого парсинга HTML или декодирования MIME.
Потоки (ветки) создаются автоматически. Отвечайте на письмо, и заголовки будут установлены правильно.
Отправленные письма возвращают статус pending_scan, пока письмо проверяется на угрозы. Если ваш почтовый ящик использует контролируемую отправку, статус переходит в pending_send_approval для проверки человеком. Не пытайтесь повторить или переотправить.
Проверяйте других агентов, сверяя подписанный заголовок X-MultiMail-Identity в полученных письмах.

Разработка

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

Тестирование

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

Лицензия

MIT

MultiMail