Как подключить Postmark к ChatGPT через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Postmark, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Postmark + ChatGPT

Транзакционные и массовые письма Postmark для одного сервера: отправка одиночных, пакетных и шаблонных писем, управление шаблонами, поиск отправленных и входящих сообщений с открытиями, кликами и отказами, статистика отправок, управление подавлениями, message streams и вебхуками. С необязательным токеном аккаунта он также читает серверы, домены и подписи отправителей.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

POSTMARK_SERVER_TOKEN (необязательно: POSTMARK_ACCOUNT_TOKEN)

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Postmark с сервером.

1. В Postmark откройте сервер, затем API Tokens, и скопируйте Server API token в POSTMARK_SERVER_TOKEN. Он передаётся в заголовке X-Postmark-Server-Token и даёт доступ только к этому серверу.
2. Необязательно: для инструментов аккаунта (postmark_list_servers, postmark_get_server_by_id, postmark_list_domains, postmark_get_domain, postmark_verify_domain_dkim, postmark_verify_domain_return_path, postmark_list_sender_signatures, postmark_get_sender_signature) владелец или администратор аккаунта копирует Account API token из Account, API Tokens в POSTMARK_ACCOUNT_TOKEN. Он передаётся как X-Postmark-Account-Token только в этих инструментах. Без него они отвечают 401; все остальные инструменты работают.
3. Установите коннектор и запустите postmark_get_server: он покажет настройки сервера и подтвердит токен.

Оба токена выглядят как UUID (8-4-4-4-12 шестнадцатеричных символов).

Отправка: postmark_send_email отправляет одно письмо до 50 получателям с темой, HTML- и/или текстовым телом, тегом, метаданными, трекингом и вложениями. postmark_send_batch отправляет до 500 разных писем за один вызов. postmark_send_email_with_template и postmark_send_batch_with_templates используют сохранённый шаблон (TemplateId или TemplateAlias) с TemplateModel из переменных. From должен быть подтверждённой подписью отправителя или адресом на проверенном домене. Новые аккаунты остаются в тестовом режиме, пока Postmark их не одобрит, и могут отправлять только на адреса своего домена. Транзакционные письма идут через stream outbound (по умолчанию); массовые и маркетинговые письма должны идти через stream типа Broadcasts (MessageStream), который берёт на себя отписку. Каждая отправка попадает в настоящие ящики, поэтому ИИ показывает получателей, тему и содержимое и ждёт вашего «да». Пакетные вызовы отвечают 200, даже если отдельные письма не прошли: ИИ проверяет ErrorCode (0 = принято) и Message каждого результата.

Шаблоны: postmark_list_templates, postmark_get_template, postmark_validate_template (проверяет синтаксис и рендерит превью с тестовой моделью, ничего не сохраняя), postmark_create_template и postmark_update_template. Переменные используют Mustachio, например {{name}}; Layout оборачивает стандартные шаблоны через {{{@content}}}.

Что случилось с письмом:

• Отправленные письма ищутся через postmark_search_outbound_messages по получателю, отправителю, тегу, теме, статусу, stream, дате или одному полю метаданных, входящие через postmark_search_inbound_messages. postmark_retry_inbound_message повторно отправляет неудавшееся входящее сообщение на входящий вебхук.
• postmark_get_outbound_message или postmark_get_inbound_message показывает подробности, а для отправленных писем и хронологию MessageEvents (Delivered, Bounced, Opened, LinkClicked, SubscriptionChanged).
• Открытия и клики: postmark_list_message_opens, postmark_get_message_opens, postmark_list_message_clicks, postmark_get_message_clicks, с почтовым клиентом, браузером, ОС, платформой и местоположением.
• Отказы: postmark_get_delivery_stats, postmark_list_bounces, postmark_get_bounce и postmark_get_bounce_dump (сырой ответ SMTP, хранится 30 дней). postmark_activate_bounce снова активирует адрес, если CanActivate равно true.
• Подавления по stream: postmark_list_suppressions и postmark_create_suppressions (до 50 адресов за вызов).

Статистика: postmark_get_outbound_overview даёт итоги и доли за период (отправлено, отказы, жалобы на спам, открытия, уникальные открытия, письма с трекингом, клики по ссылкам). postmark_get_outbound_stats с metric даёт дневные значения отправок, отказов, спама, трекинга, открытий, кликов, платформ, почтовых клиентов, браузеров или местоположений.

Настройка сервера: postmark_get_server; message streams через postmark_list_message_streams, postmark_get_message_stream, postmark_create_message_stream (не более 10 streams на сервер, из них один Inbound), postmark_update_message_stream и postmark_unarchive_message_stream; вебхуки через postmark_list_webhooks, postmark_get_webhook, postmark_create_webhook и postmark_update_webhook. С токеном аккаунта ИИ также выводит серверы, домены и подписи отправителей, показывает DNS-записи, нужные домену, и просит Postmark проверить DKIM и Return-Path после того, как вы их добавили.

Отключены при установке: postmark_delete_template, postmark_delete_suppressions (позволяет подавленным адресам снова получать письма), postmark_delete_webhook и postmark_archive_message_stream (архивированный stream перестаёт отправлять и через 45 дней удаляется вместе с данными, если его не восстановить). Администратор workspace включает их, когда они нужны команде.

Форматы данных: имена полей в PascalCase (MessageID, SubmittedAt, TotalCount). Даты поиска (fromdate, todate) указываются по восточному времени США (US Eastern); возвращаемые метки времени содержат смещение. Даты статистики в формате YYYY-MM-DD. Сообщения и их события хранятся в течение срока хранения сервера, по умолчанию 45 дней.

Постраничный вывод: инструменты списков и поиска принимают count (по умолчанию 50, не более 500) и offset; count плюс offset не может превышать 10 000. Чтобы заглянуть дальше в прошлое, ИИ сужает диапазон дат. Сравнение TotalCount с полученными строками показывает, есть ли ещё страницы.

Частые ошибки: 401 означает отсутствующий или неверный токен либо токен сервера в инструменте аккаунта. 422 означает неверный запрос; причину называют ErrorCode и Message: 300 ошибка проверки отправки (например, неверный адрес или пустое тело), 406 неактивный или подавленный получатель, 410 больше 500 писем в пакете, 412 получатели вне домена From, пока аккаунт ждёт одобрения, 1101 шаблон не найден, 1235 неизвестный message stream. 429 означает слишком много запросов; 500 это проблема на стороне Postmark, повторите позже.

Коннектор не создаёт серверы, домены и подписи отправителей, не снимает подавления из-за жалоб на спам и не удаляет отправленные сообщения.

Шаг 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.

1. Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
2. Введи название, например Name: Postmark.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

Доступные инструменты

Примеры запросов

• «Дошло ли вчера наше письмо со сбросом пароля на [email protected]? Покажи его события доставки.»
• «Сколько писем мы отправили на прошлой неделе и какими были доли отказов и жалоб на спам?»
• «Выведи жёсткие отказы за последние 7 дней с получателем и ответом принимающего сервера.»
• «Отправь приветственный шаблон на [email protected] с именем Tom. Покажи готовое письмо перед отправкой.»
• «Проверена ли уже DKIM-запись нашего домена отправки? Если нет, покажи DNS-запись, которую нужно добавить.»

FAQ

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot