mailagent — плагин для Claude Code и Codex: временные инбоксы и OTP
Плагин mailagent даёт агенту временные почтовые ящики: принять письмо с кодом или magic link, проверить регистрацию и удалить инбокс.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install mailagent@awesome-codex-pluginsЧто делает 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