Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Mailtrap одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Работайте с аккаунтом Mailtrap из любого AI-агента: отправка транзакционных, массовых и пакетных писем, тесты в Email Sandbox с отчётами о спаме и HTML, управление доменами отправки, списком подавления и шаблонами, отслеживание каждого письма в журнале, статистика отправок, контакты, списки и кампании Email Marketing. Один API-токен; необратимые удаления выключены при установке.
Попробуй спросить
Примеры промптов для Mailtrap
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Mailtrap, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Mailtrap + ChatGPT
Работайте с аккаунтом Mailtrap из любого AI-агента: отправка транзакционных, массовых и пакетных писем, тесты в Email Sandbox с отчётами о спаме и HTML, управление доменами отправки, списком подавления и шаблонами, отслеживание каждого письма в журнале, статистика отправок, контакты, списки и кампании Email Marketing. Один API-токен; необратимые удаления выключены при установке.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
MAILTRAP_API_TOKEN
Шаг 1 — Получите учётные данные
Настройка занимает около 3 минут. Нужен аккаунт Mailtrap.
- В Mailtrap откройте Settings, API Tokens (https://mailtrap.io/api-tokens) и создайте токен. Дайте ему доступ к доменам отправки (для отправки, статистики, журнала и списка подавления), к sandbox или проектам (для Email Sandbox) и, если пользуетесь, к Email Marketing. Для изменения списка подавления нужен доступ администратора.
- Вставьте его в
MAILTRAP_API_TOKEN. Токен передаётся какAuthorization: Bearer <token>и не истекает, пока вы его не сбросите. - Установите коннектор и запустите
mailtrap_list_accounts: он покажет аккаунт с вашим уровнем доступа (1000 owner, 100 admin, 10 viewer) и подтвердит токен. Токен принадлежит одному аккаунту, и каждый вызов работает с ним, поэтому id аккаунта не нужен. - Для реальной отправки нужен подтверждённый домен отправки (
mailtrap_list_sending_domains); Email Sandbox работает и без него.
Mailtrap обслуживает разделы с разных хостов, и коннектор сам выбирает нужный для каждого инструмента: https://mailtrap.io для управления и отчётов, https://send.api.mailtrap.io для транзакционной отправки, https://bulk.api.mailtrap.io для потока Bulk и https://sandbox.api.mailtrap.io для тестовой отправки в sandbox.
Отправка: mailtrap_send_email отправляет одно транзакционное письмо до 1000 получателям, mailtrap_send_batch_emails до 500 разных писем за один вызов (не больше 50 МБ). Маркетинговые и другие массовые письма идут через поток Bulk с помощью mailtrap_send_bulk_email и mailtrap_send_bulk_batch_emails, который отделяет рекламный трафик от транзакционного. Содержимое это text, html или оба, либо сохранённый шаблон: template_uuid (uuid из mailtrap_list_templates, а не числовой id) с template_variables, тогда без subject, text, html и category. from_email должен быть на подтверждённом домене отправки; to, cc и bcc это списки {"email", "name"}; вложения передаются в Base64 в content. Каждое письмо попадает в настоящие ящики, поэтому ИИ показывает получателей, отправителя, тему и содержимое и ждёт вашего «да». Отправка возвращает message_ids, по одному на получателя. Пакетные вызовы отвечают 200, даже если отдельные письма не прошли: ИИ проверяет success и errors каждой записи в responses.
Email Sandbox: mailtrap_send_sandbox_email отправляет тестовое письмо, которое перехватывается в sandbox и никогда не доставляется; это безопасный способ опробовать шаблон или новый текст. Затем ИИ читает перехваченные письма (mailtrap_list_sandbox_messages, mailtrap_get_sandbox_message), тело в виде текста, HTML для предпросмотра, исходного HTML или сырого MIME, заголовки, вложения, отчёт SpamAssassin с оценкой и сработавшими правилами и проверку HTML, которая показывает, какие элементы и CSS-свойства не поддерживают какие почтовые клиенты. Он также выводит проекты и sandbox и создаёт sandbox; SMTP-учётные данные ни в одном ответе не возвращаются.
Домены и доставляемость: список и детали доменов отправки с DNS-записями для публикации (SPF, DKIM, DMARC, return path) и их проверкой, добавление домена и отправка инструкций по DNS по email тому, кто управляет DNS. Подавленные адреса (жёсткий отказ, отписка, жалоба на спам, ручной импорт) выводятся вместе с письмом, которое к этому привело; mailtrap_create_suppression прекращает отправку на адрес. Для одного письма mailtrap_list_email_logs фильтрует по получателю, статусу, событиям, категории и времени отправки, а mailtrap_get_email_log показывает события доставки, открытия, клика и отказа с ответом провайдера. mailtrap_get_sending_stats даёт итоги за период, mailtrap_get_sending_stats_grouped разбивает их по домену, категории, почтовому провайдеру или дням, а mailtrap_get_billing_usage показывает расход относительно тарифа.
Шаблоны: список, чтение, создание и изменение шаблонов. Переменные используют Handlebars, например {{user_name}}; письма, отправленные после изменения, используют новую версию.
Email Marketing: контакты со статусом, списками и полями (создание, чтение и изменение по id или email; собственные события вроде purchase для автоматизаций и сегментов; импорт до 50 000 контактов с сопоставлением по email и отслеживанием через mailtrap_get_contact_import), списки контактов и поля контактов (merge-теги, которые служат ключами в fields). Кампании: mailtrap_create_campaign всегда создаёт черновик, mailtrap_update_campaign меняет черновик, mailtrap_schedule_campaign назначает время не более чем на месяц вперёд, mailtrap_start_campaign отправляет сразу, mailtrap_cancel_campaign возвращает запланированную кампанию в черновик, а mailtrap_get_campaign_stats показывает результаты. Планирование и запуск отправляют письма всей аудитории: ИИ сначала согласует с вами кампанию, аудиторию и время. Добавляйте только контакты, согласившиеся получать письма, а чтобы перестать писать кому-то, отпишите его (unsubscribed: true), а не удаляйте.
Выключены при установке: mailtrap_delete_suppression (адрес снова начинает получать письма), mailtrap_clean_sandbox (удаляет все письма в sandbox) и mailtrap_delete_contact. Они необратимы, поэтому администратор рабочего пространства включает их, когда они нужны команде.
Форматы данных: id доменов, sandbox, писем, шаблонов, списков и кампаний это целые числа; контакты, записи подавления и письма в журнале используют UUID. Время в формате ISO 8601 в UTC. Показатели в статистике это доли (0.25 = 25 %), даты статистики в формате YYYY-MM-DD.
Постраничный вывод: контакты передают pagination.next_token как token, пока он не станет null; кампании используют token как номер страницы из pagination.next_token. Журнал писем передаёт next_page_cursor как search_after. Записи подавления приходят по 1000 на страницу, с id последней записи в last_id. Письма в sandbox приходят по 30 на страницу, через page или id последнего письма в last_id.
Лимиты: 150 запросов за 10 секунд на токен; контакты 200 в минуту, статистика и список подавления 10 в минуту, список журнала писем 60 в минуту на аккаунт.
Частые ошибки: 401 Incorrect API token означает неверный токен или отсутствие доступа к этому домену или sandbox. 403 это недостающее право: измените токен в Settings, API Tokens. 404 это неизвестный id. 422 это неверный ввод с причиной в errors, например отправитель не на подтверждённом домене или кампания, которая уже не черновик. 429 это лимит запросов: подождите и повторите.
Коннектор не удаляет домены отправки, sandbox, шаблоны и кампании и не возвращает SMTP-учётные данные sandbox.
Шаг 2 — Установите адаптер
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Шаг 3 — Добавьте коннектор в ChatGPT
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.
- Перейди на chatgpt.com/plugins, нажми +, затем Add custom MCP server.
- Введи название, например Name:
Mailtrap. - В разделе Connection укажи в поле Server URL адрес
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDи оставь Authentication на OAuth. - Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
- Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.
Доступные инструменты
| Tool | What it does |
|---|---|
mailtrap_list_accounts | Mailtrap accounts the API token can reach, with id, name and access_levels (1000 owner, 100 admin, 10 viewer) |
mailtrap_get_billing_usage | Usage of the current billing cycle: plan names and sent or stored message counts against their limits for Email Sending, Email Sandbox and… |
mailtrap_send_email | Send one transactional email through the Email API (send.api.mailtrap.io): to up to 1000 recipients, with text and/or HTML, or from a… |
mailtrap_send_batch_emails | Send up to 500 different transactional emails in one call (send.api.mailtrap.io/api/batch): shared fields in base, one entry per message in… |
mailtrap_send_bulk_email | Send one marketing or bulk email through the Bulk stream (bulk.api.mailtrap.io), which keeps promotional traffic apart from transactional… |
mailtrap_send_bulk_batch_emails | Send up to 500 different bulk (marketing) emails in one call through the Bulk stream (bulk.api.mailtrap.io/api/batch) |
mailtrap_list_sending_domains | Sending domains of the account with their id, DNS verification and compliance status and tracking settings |
mailtrap_get_sending_domain | One sending domain with the DNS records to publish (SPF, DKIM, DMARC, return path) and whether each is verified, plus compliance status and… |
mailtrap_create_sending_domain | Add a sending domain |
mailtrap_send_domain_setup_instructions | Email the DNS setup instructions of a sending domain to someone, e.g. the person who manages DNS |
mailtrap_list_suppressions | Addresses Mailtrap no longer sends to (hard bounce, unsubscription, spam complaint, manual import), up to 1000 per call, with the message… |
mailtrap_create_suppression | Stop sending to an address on one domain and stream |
mailtrap_delete_suppression | Remove a suppression so the address receives email again |
mailtrap_get_sending_stats | Sending totals for a date range: delivery, bounce, open, click and spam counts and rates, optionally limited to domains, streams… |
mailtrap_get_sending_stats_grouped | The same sending stats split by sending domain, category, recipient mailbox provider or day |
mailtrap_list_email_logs | Sent messages of the account, newest first, with status, recipient, subject, category, opens and clicks |
mailtrap_get_email_log | One sent message with its delivery events (delivery, open, click, bounce with the provider response), custom variables, template and a link… |
mailtrap_list_sandbox_projects | Email Sandbox projects with the sandboxes (test inboxes) in each |
mailtrap_list_sandboxes | All sandboxes (test inboxes) with id, name, project, message and unread counts and the sandbox email address |
mailtrap_get_sandbox | One sandbox: name, project, message counts, size limits, SMTP host and ports and its email address |
mailtrap_list_sandbox_messages | Messages caught in a sandbox, newest first, 30 per page: id, subject, sender, recipient, sent time, size and read state (SMTP details and… |
mailtrap_get_sandbox_message | One sandbox message: sender, recipient, subject, size, SMTP details and blacklist report summary |
mailtrap_get_sandbox_message_body | The body of a sandbox message: txt (plain text), html (sanitized for preview), htmlsource (the HTML as sent) or raw (the whole MIME message) |
mailtrap_get_sandbox_message_headers | The mail headers of a sandbox message (From, To, Subject, Message-ID, List-Unsubscribe, ...) |
mailtrap_get_sandbox_spam_report | SpamAssassin report of a sandbox message: total score, threshold and the rules that matched |
mailtrap_get_sandbox_html_analysis | HTML check of a sandbox message: which elements and CSS properties are unsupported by which email clients, with an overall support score |
mailtrap_list_sandbox_attachments | Attachments of a sandbox message with filename, content type, size and download path |
mailtrap_send_sandbox_email | Send a test email into a sandbox (sandbox.api.mailtrap.io): it is caught there and never reaches the recipients, so it is safe for trying… |
mailtrap_create_sandbox | Create a sandbox (test inbox) in a project; the answer carries its id and email address, SMTP credentials left out |
mailtrap_clean_sandbox | Delete every message in a sandbox |
mailtrap_list_contacts | Email Marketing contacts, 25 per page by default (at most 50), with id, email, status, list ids and fields |
mailtrap_get_contact | One contact by id or email: status, lists, fields and timestamps |
mailtrap_create_contact | Add a contact, optionally with fields (by merge tag) and lists |
mailtrap_update_contact | Change a contact: email, fields, list membership or subscription status |
mailtrap_delete_contact | Delete a contact for good, e.g. on an erasure request |
mailtrap_create_contact_event | Record a custom event for a contact (e.g. purchase, trial_started) with parameters, for automations and segments |
mailtrap_list_contact_lists | Contact lists with id and name; search filters by the start of the name |
mailtrap_create_contact_list | Create an Email Marketing contact list; add contacts with list_ids or list_ids_included afterwards |
mailtrap_list_contact_fields | Contact fields with id, name, data type and the merge tag used in contact fields and templates |
mailtrap_import_contacts | Create or update up to 50,000 contacts in one asynchronous import, matched by email |
mailtrap_get_contact_import | Status of a contact import (created, started, finished, failed) with the counts of created and updated contacts and those over the plan… |
mailtrap_list_templates | Email templates of the account with id, uuid (used to send), name, category and subject |
mailtrap_get_template | One email template with subject, HTML and text body (Handlebars variables such as {{user_name}}) |
mailtrap_create_template | Create an email template |
mailtrap_update_template | Change an email template; only the fields you pass change |
mailtrap_list_campaigns | Email Marketing campaigns, newest first, with id, name, state and schedule |
mailtrap_get_campaign | One campaign: state, sender, audience lists and segments, delivery mode, template and schedule |
mailtrap_get_campaign_stats | Results of a campaign: delivered, opened, clicked, bounced, spam and unsubscribed counts and rates, optionally for a date window |
mailtrap_create_campaign | Create a campaign as a draft: sender, audience, subject and design |
mailtrap_update_campaign | Change a draft campaign; only the fields you pass change |
mailtrap_schedule_campaign | Schedule a draft campaign to go out at a set time, at most one month ahead |
mailtrap_start_campaign | Start sending a draft campaign now to its whole audience |
mailtrap_cancel_campaign | Cancel a scheduled campaign before it goes out; it goes back to draft and can be edited again |
Примеры запросов
- «Доставлено ли сегодня утром подтверждение заказа на [email protected]? Покажи его события.»
- «Отправь этот новый приветственный шаблон в наш тестовый sandbox и скажи оценку спама и у каких почтовых клиентов проблемы с HTML.»
- «Какими были на прошлой неделе наши показатели доставки, отказов и спама по почтовым провайдерам?»
- «Какие DNS-записи нашего домена отправки ещё не подтверждены?»
- «Создай черновик кампании для списка Клиенты с шаблоном Рассылка ноябрь и покажи аудиторию, прежде чем планировать.»
FAQ
Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
- Подключить к Microsoft Copilot
Это руководство помогло?