К основному содержанию
плагин CX Codex

mailagent — плагин для Claude Code и Codex: временные инбоксы и OTP

Плагин mailagent даёт агенту временные почтовые ящики: принять письмо с кодом или magic link, проверить регистрацию и удалить инбокс.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mailagent@awesome-codex-plugins
Открыть на GitHub

Что делает mailagent

Плагин подключает к агенту MCP-сервер MailAgent. Тот открывает временный ящик, ждёт письмо и вытаскивает из него код подтверждения или ссылку. Регистрация на тестовом стенде проходит без ручной пересылки писем: агент сам подставляет адрес в форму и дочитывает ответ.

Внутри бандла лежит скрипт scripts/run-mailagent-mcp.sh, который поднимает stdio-пакет @mailagent/[email protected] через npx, и шаблон .env.example. Секреты кладут в .env, адрес API по умолчанию https://api.webmailagent.com. Всего в сервере 23 инструмента, для проверки подключения хватит codex mcp list: в списке должны появиться mailagent_plan_next, mailagent_verify_signup и mailagent_create_inbox.

Для работы нужен MAILAGENT_API_KEY — в .env или в окружении родительского процесса. Без ключа сервер не авторизуется, а сам ключ не стоит логировать и вставлять в чат.

Какие задачи решает

  • прочитать код из письма при регистрации на тестовом стенде
  • поймать magic link и открыть его без ручного копирования
  • прогнать сценарий signup, не трогая настоящий почтовый ящик
  • дождаться письма по теме, а не листать весь инбокс
  • удалить временный ящик после теста

Примеры запросов агенту

  • Создай инбокс через mailagent_create_inbox с меткой signup-test и сервисом staging, потом подставь адрес в форму регистрации.
  • Дождись письма с темой Verify your email через mailagent_wait_and_extract и достань из него otp.
  • Удали ящик через mailagent_delete_inbox, когда регистрация пройдёт.

Как установить mailagent

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mailagent@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о mailagent

Как установить mailagent в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем поставьте плагин: /plugin install mailagent@awesome-codex-plugins.

Что делает mailagent?

Даёт агенту временные ящики: создать инбокс, дождаться письма с кодом или magic link, вытащить нужное и удалить ящик. Есть отдельный вызов mailagent_verify_signup, который ждёт и извлекает за один шаг.

Что нужно, чтобы MCP-сервер заработал?

Ключ MAILAGENT_API_KEY в .env или в окружении родительского процесса; адрес API по умолчанию https://api.webmailagent.com. Вместо локального подпроцесса можно подключиться к удалённому серверу по OAuth с короткоживущим токеном mat_.

Исходный текст

MailAgent · MIT
# MailAgent Codex Plugin

MailAgent gives Codex temporary inboxes for signup QA, OTP emails, and magic links.

## Setup

```bash
cp .env.example .env
chmod +x scripts/run-mailagent-mcp.sh
```

Put secrets in `.env` (gitignored). `MAILAGENT_API_URL` defaults to `https://api.webmailagent.com`.
`MAILAGENT_API_KEY` may also come from the parent process environment. Do not log or paste the key.

```dotenv
MAILAGENT_API_URL=https://api.webmailagent.com
MAILAGENT_API_KEY=ma_or_mak_replace_me
```

## Check MCP

The plugin launches the published npm stdio package via `scripts/run-mailagent-mcp.sh`:

```bash
codex mcp list
```

Expected: `mailagent` server with `mailagent_plan_next`, `mailagent_verify_signup`, and `mailagent_create_inbox`.

## Verify signup flow

1. If unsure, call `mailagent_plan_next` and follow `nextTool` / `nextPayload`.
2. `mailagent_create_inbox` with `label` and `service`.
3. Submit returned `address` in the signup form.
4. `mailagent_wait_and_extract` with `inboxId` and `subjectContains`.
5. Use `otp` or `primaryLink` to finish signup.
6. `mailagent_delete_inbox` for cleanup.

If the form is already submitted, use `mailagent_verify_signup` to wait and extract in one call.

## Remote MCP (OAuth)

For Streamable HTTP without a local subprocess, see
[OAuth IdP docs](https://webmailagent.com/docs/oauth-idp.html) and use `https://api.webmailagent.com/mcp`
with a short-lived `mat_` bearer token.

This bundle keeps stdio MCP via `npx -y -p @mailagent/[email protected] mailagent-mcp`.

## Install from GitHub marketplace

```bash
codex plugin marketplace add Alex0nder/MailAgent
codex plugin add mailagent@mailagent
```

Docs: https://webmailagent.com/docs/codex.html

© MailAgent · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Тесты и QA» →
mailsocket mailsocket MCP-сервер mailsocket предоставляет ИИ-агентам временные почтовые ящики и блокирует выполнение, пока во входящие не придёт одноразовый пароль или ссылка для входа. CX Codex +1 ★ 1звёзд репо ZeroDrop zerodrop-dev ZeroDrop — MCP-сервер для Claude Code: создаёт временные почтовые ящики и извлекает из писем OTP-коды и magic links. Проверка регистрации и авторизации приложения через ИИ-агента. CX Codex +1 ★ 1звёзд репо mcp openagentemail MCP-сервер mcp даёт агентам почтовые адреса, ловит письма с кодами подтверждения и передаёт задачи между процессами через OpenAgentEmail. CX Codex +1 ★ 56звёзд репо SendKuy sendkuy Даёт агенту инструменты для отправки WhatsApp, SMS и писем, проверки OTP-кодов и запуска кампаний через аккаунт SendKuy. CX Codex +1 ★ 1звёзд репо email-render-builder aaron-he-zhu Скилл email-render-builder для агентов, который собирает адаптивный HTML email-письма из готового креатива и проверяет рендер в Gmail, Outlook, Apple Mail и на мобильных. Текст письма он не пишет — это задача email-creative-builder. CX Codex +1 1 200установок firecrawl-qa firecrawl Скилл firecrawl-qa прогоняет развёрнутый сайт через Firecrawl и собирает QA-отчёт: ссылки, формы, мобильная вёрстка, консольные ошибки. Пригодится перед релизом и после деплоя. CX Codex +1 31 700установок

Из того же набора391

Весь набор →
ml-pipeline Плагин ml-pipeline проводит ML-задачу через строгий 16-шаговый процесс: от проверки данных до оценки модели. Он нужен, когда агент начинает обучение слишком рано. CX Codex ★ 1 596звёзд репо memoire Плагин memoire даёт агенту память о вашей дизайн-системе: проверяет интерфейс, достаёт токены Tailwind из готовой вёрстки и ведёт работу с реестром shadcn. CX Codex ★ 1 596звёзд репо codex-multiple-env Плагин codex-multiple-env изолирует профили аккаунтов и воркспейсов ChatGPT для Codex CLI в каталогах CODEX_HOME. Позволяет переключать учётные записи без постоянного выхода из системы. CX Codex ★ 1 596звёзд репо mcp-md-reader Плагин mcp-md-reader для Claude Code и Codex находит нужные разделы Markdown и читает их выборочно. Помогает работать с большими файлами и хранилищами заметок. CX Codex ★ 1 596звёзд репо magents Плагин magents связывает сессии Codex, Claude и Cursor через общую шину MCP. Помогает передавать контекст и запускать задачи без ручного копирования. CX Codex ★ 1 596звёзд репо maestro Плагин maestro для Claude Code отправляет один запрос нескольким локальным CLI-моделям, поручает выбранной модели-судье сравнить ответы, а синтезатору — собрать общий итог. CX Codex ★ 1 596звёзд репо lvtd-skills Плагин lvtd-skills для Claude Code и Codex собирает готовые скиллы по Django, htmx, Rust, документации, SEO, тракшену и книгам — по одному файлу SKILL.md на тему. CX Codex ★ 1 596звёзд репо krypton Плагин krypton для Claude Code и Codex превращает запрос на разработку в план с ответственными, решением о переходе и критериями приёмки. Подключайте его для новой функции, исправления, рефакторинга, миграции или архитектурной задачи. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой