Agent Mail Gateway — MCP-сервер для Claude Code: функции и запуск
Локальный почтовый шлюз в Docker для безопасного подключения ИИ-агентов к ящикам по IMAP и SMTP. Ограничивает контакты, отсекает инъекции и форматирует письма в Markdown.
Открыть на GitHubЧто делает Agent Mail Gateway
Сервис разворачивается в одном контейнере Docker и становится барьером между агентом и почтовым сервером. Вместо передачи постоянного пароля от ящика администратор генерирует отдельный ключ доступа к конкретному адресу. Входящие письма шлюз переводит из громоздкого HTML в компактный Markdown, поэтому тратится меньше токенов в контекстном окне.
Система контролирует входящую и исходящую почту. На входе отсекаются поддельные отправители без SPF или DKIM, проверяются файлы антивирусом ClamAV и блокируются попытки инъекций промптов в тексте и вложениях. Перед отправкой встроенные правила перехватывают дубликаты, пустые сообщения или фразы о прикреплённых файлах, если вложение забыли прикрепить. Дополнительно можно подключить правила на обычном языке или локальную языковую модель через Ollama для смысловой проверки черновика.
Подключать личный почтовый ящик нельзя: шлюз по умолчанию отправляет почту от неизвестных адресатов прямо в корзину. Для каждого агента выделяют персональный почтовый адрес.
Какие задачи решает
- Ограничить доступ ИИ-агента к почтовому серверу отдельным ящиком и белым списком разрешённых адресов
- Преобразовывать входящие сообщения из HTML в компактный Markdown для экономии контекста модели
- Блокировать отправку писем с забытыми файлами, пустым текстом или черновыми плейсхолдерами
- Принимать, обновлять и отправлять приглашения календаря для синхронизации встреч
- Фильтровать входящую корреспонденцию на предмет инъекций промптов, вирусов и маскированных вложений
Примеры запросов агенту
- Проверь новые входящие сообщения от разрешённых отправителей и покажи краткую сводку в Markdown.
- Подготовь ответ на последнее письмо по проекту, прикрепи отчёт
summary.csvи проверь текст перед отправкой. - Создай приглашение на созвон по релизу на завтра в 15:00 и разошли участникам команды.
Как установить Agent Mail Gateway
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Agent Mail Gateway
Как запустить Agent Mail Gateway?
Разверните контейнер через Docker Compose, взяв за основу файлы docker-compose.yml, config.yaml и .env. Затем подключите агент через интерфейс MCP по HTTP или через stdio-мост.
Зачем агенту отдельный шлюз вместо прямого доступа по IMAP и SMTP?
Прямая выдача пароля от почты позволяет агенту читать чужие письма и отправлять сообщения кому угодно, а атака через входящее письмо приведёт к утечке данных. Шлюз выдаёт агенту изолированный токен к единственному ящику и сверяет адресатов со списком разрешённых контактов.
Как шлюз защищает от ошибок при отправке писем?
Встроенные эвристики перехватывают пустые письма, дубликаты и упоминания файлов без вложений. При необходимости можно подключить локальную нейросеть или собственные текстовые правила для проверки содержимого.
