EngageLab Agent Email MCP Server

Английский | 简体中文

Отправляйте, получайте и отвечайте на электронные письма от AI-агентов — через Model Context Protocol.

Каждый агент получает собственный почтовый ящик: реальный адрес, который отправляет и получает, с разговорами, сгруппированными в цепочки, чтобы у вашего агента был контекст. Работает с Claude Desktop, Claude Code, Cursor, Cowork и любым MCP-совместимым клиентом.

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

Зачем

Большинство почтовых API работают только на отправку. Агентам, которым нужно вести переписку по электронной почте — поддержка, планирование, согласования — нужен входящий ящик.

• Отправка и получение — агент владеет выделенным почтовым ящиком, а не прикрученным вебхуком для парсинга

• Работа с цепочками — ответы группируются в разговоры, поэтому агент видит полную историю

• Песочница — тестируйте сценарии агента, не отправляя письма реальным людям

• Одна переменная окружения — никаких OAuth-танцев для локального использования; регион определяется по ключу

Инструменты

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

1. Получите секретный ключ. Создайте аккаунт EngageLab и сгенерируйте ключ в консоли (формат sk_sg_xxx — префикс выбирает регион). Или используйте CLI: engagelab-email-cli login создаст его через браузер.

2. Создайте почтовый ящик. В консоли создайте почтовый ящик для вашего агента (общий поддомен создаётся мгновенно; для собственных доменов требуется проверка DNS). Программное создание почтовых ящиков в планах — см. Устранение неполадок, если list_mailboxes возвращает пустой список.

3. Зарегистрируйте сервер.

Claude Desktop — добавьте JSON-блок выше в claude_desktop_config.json.

Claude Code:

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

Затем спросите вашего агента:

Перечислите мои почтовые ящики, затем отправьте письмо с первого на bob@example.com с сообщением, что счёт одобрен.

Типичный цикл агента для бота поддержки:

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

Конфигурация

Ограничения: до 10 вложений / 10 МБ на сообщение (в схеме инструмента — в base64).

Устранение неполадок

• list_mailboxes возвращает пустой список — в вашем аккаунте ещё нет почтового ящика. Создайте его в консоли EngageLab (см. шаг 2 в «Быстром старте»). Агенты пока не могут создавать почтовые ящики самостоятельно.

• 401 / code 100101 — секретный ключ неверен или отозван. Проверьте ENGAGELAB_EMAIL_SECRET_KEY и что префикс региона ключа (sk_sg_ / sk_tr_) соответствует используемой конечной точке.

• Не удалось определить базовый URL API — префикс региона ключа не распознан. Укажите ENGAGELAB_EMAIL_BASE_URL явно.

• Ответ отображается как новый разговор — используйте reply_email (а не send_email), чтобы заголовки In-Reply-To и цепочки сохранялись.

Дорожная карта

• Хостинг MCP (OAuth) для удалённого использования без настройки

• Программное создание почтовых ящиков через секретный ключ

• Webhook-уведомления (без опроса) для check_new_messages

• Ссылки на вложения по URL (без base64 в контексте)

Запуск из исходного кода

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

Связанные проекты

• EngageLab Agent Email CLI — те же почтовые ящики из терминала, вывод --json для агентов

• EngageLab Node SDK / Python SDK — отправка писем из кода

Лицензия

MIT