Перейти к содержимому

Использование Mail Merge с AI-агентами (MCP)

Mail Merge имеет публичный MCP-сервер, поэтому AI-агент, который вы уже используете, может читать ваши Google Sheets, писать шаблоны, управлять контактами и отправлять кампании через ваш аккаунт Mail Merge. Вы общаетесь с агентом на естественном языке, агент вызывает Mail Merge, и каждое письмо по-прежнему отправляется с вашего собственного аккаунта Gmail с теми же квотами, отслеживанием и столбцом статуса, что и кампания, запущенная вручную.

Сервер предоставляет те же функции, что и веб-приложение, сгруппированные в виде инструментов, которые может вызывать агент: аккаунт и план, Google Sheets, шаблоны, контакты, кампании, аналитика, прогрев и настройки. Агент видит только аккаунт, с которым вы вошли, и только до тех пор, пока вы не отозвали доступ. Каждый подключенный агент получает свой собственный токен доступа, который указан в разделе Settings → AI agents в веб-приложении.

https://merge.email/mcp

Сервер использует транспорт Streamable HTTP и OAuth 2.1. Когда ваш ассистент подключается в первый раз, открывается окно браузера: войдите с помощью аккаунта Google, который вы используете с Mail Merge, прочитайте страницу согласия с указанием агента и одобрите.

Claude (claude.ai)

  1. Откройте Settings → Connectors.
  2. Нажмите Add custom connector.
  3. Вставьте https://merge.email/mcp как URL и нажмите Connect.
  4. Войдите через Google в открывшемся окне и одобрите агента.

Claude Desktop использует тот же путь: Settings → Connectors → Add custom connector.

Claude Code

claude mcp add --transport http mailmerge https://merge.email/mcp

Затем введите /mcp в сеанс, выберите mailmerge и перейдите по ссылке входа.

  1. Откройте Settings → Connectors.
  2. Выберите Create (в некоторых версиях находится в Advanced → Developer mode).
  3. Введите имя, вставьте https://merge.email/mcp как URL сервера, выберите OAuth и сохраните.
  4. Войдите через Google при появлении запроса и одобрите агента.

Добавьте сервер в .cursor/mcp.json в вашем проекте (или в глобальный файл из Cursor Settings → MCP):

{
"mcpServers": {
"mailmerge": {
"url": "https://merge.email/mcp"
}
}
}

Затем список MCP показывает mailmerge со ссылкой Needs login. Нажмите на нее, войдите через Google и одобрите агента.

Любой MCP-клиент, поддерживающий удаленные серверы через Streamable HTTP с OAuth, работает одинаково: укажите ему https://merge.email/mcp. Клиенты, которые ищут метаданные сервера, находят их по адресу:

https://merge.email/.well-known/oauth-protected-resource/mcp

Поддерживаются динамическая регистрация клиентов и PKCE, поэтому заранее не нужно настраивать никакой ID клиента или секрет.

Аккаунт

ИнструментЧто он делает
get_accountВаш план, сегодняшняя квота и функции, включенные в ваш план.
get_pricingТекущие планы и цены.
get_subscriptionСтатус вашей подписки, период выставления счетов и дата продления.
get_billing_portal_linkСсылка на портал выставления счетов (счета, способ оплаты, изменение плана).
get_team_seatsМеста в вашей командной подписке и кто их занимает.
assign_team_seatПредоставляет место коллеге.
unassign_team_seatОтзывает место.

Google Sheets

ИнструментЧто он делает
list_spreadsheetsТаблицы в вашем Google Drive.
list_sheetsВкладки таблицы.
read_sheetЗаголовки и строки листа, данные, которые объединяет кампания.

Шаблоны

ИнструментЧто он делает
list_templatesВаши сохраненные шаблоны.
get_templateТема и текст шаблона.
create_templateСохраняет новый шаблон.
update_templateИзменяет имя, тему или текст шаблона.
delete_templateУдаляет шаблон.
duplicate_templateКопирует шаблон.
generate_templateПишет шаблон с помощью AI на основе описания, опционально соответствуя столбцам примера листа.
import_google_docПревращает Google Doc в шаблон.

Контакты

ИнструментЧто он делает
list_contactsВаши контакты с фильтрами для отписавшихся и черного списка.
add_contactДобавляет один контакт.
import_contactsДобавляет много контактов сразу.
delete_contactsУдаляет контакты.
block_contactsДобавляет адреса в черный список, чтобы кампании их не отправляли.
unblock_contactsУдаляет адреса из черного списка.
list_contact_listsВаши списки контактов.
create_contact_listСоздает список.
rename_contact_listПереименовывает список.
delete_contact_listУдаляет список (контакты остаются).
add_contacts_to_listДобавляет контакты в список.
remove_contacts_from_listУдаляет контакты из списка.

Кампании

ИнструментЧто он делает
list_campaignsВаши активные, запланированные и завершенные кампании.
get_campaignОдна кампания с ее прогрессом и настройками.
get_campaign_recipientsСтатусы каждого получателя в кампании.
get_sequence_statsКак работает последовательность отслеживания.
check_quotaСколько писем вы можете отправить сегодня и подходит ли кампания.
send_test_emailОтправляет отрендеренный тест на ваш собственный адрес.
send_campaignЗапускает кампанию из листа, списка контактов или введенного списка получателей: сейчас, по расписанию или как Autopilot с опциональным отслеживанием. Поддерживает пробный запуск, который сообщает, что было бы отправлено без фактической отправки.
pause_campaignПриостанавливает работающую кампанию.
resume_campaignВозобновляет приостановленную.
stop_campaignОстанавливает кампанию окончательно.
reschedule_campaignИзменяет дату отправки запланированной кампании.
update_autopilotИзменяет ежедневный объем и окно кампании Autopilot.
delete_scheduled_campaignУдаляет запланированную кампанию до ее начала.

Аналитика

ИнструментЧто он делает
get_analyticsОтправки, открытия и клики во времени с показателями и топ-ссылками.
get_activityКто открыл, кликнул и отписался, получатель за получателем.
get_account_eventsИстория всего, что произошло на вашем аккаунте.

Прогрев

ИнструментЧто он делает
get_warmupСтатус и тренд репутации вашего прогрева.
enable_warmupНачинает прогревать ваш почтовый ящик.
pause_warmupПриостанавливает прогрев.
resume_warmupВозобновляет его.
stop_warmupОстанавливает его.
update_warmup_settingsИзменяет ежедневный объем и рост.
check_email_reputationЗапускает бесплатную проверку репутации адреса или домена.

Настройки

ИнструментЧто он делает
set_throttleУстанавливает скорость отправки: максимально быстро, фиксированная задержка или случайная задержка между письмами.

После подключения попросите агента так, как вы попросили бы коллегу:

  • “Прочитай вкладку Leads моей таблицы Q4 outreach, напиши короткое письмо-отслеживание, которое использует столбцы имени и компании, и отправь мне тест.”
  • “Сколько писем я еще могу отправить сегодня? Если шаблон Webinar invite подходит, запланируй его в список контактов Webinar на завтра в 9 утра.”
  • “Какая кампания прошлого месяца имела лучший процент открытий, и кто кликнул на ссылку цены?”
  • “Приостанови кампанию Partners и заблокируй всех, кто ответил с просьбой быть удаленным.”

Агент имеет ровно те же разрешения, что и ваш план. Ничего не разблокируется при подключении агента.

FreePersonalProfessional
Писем в день50250500 с адресом Gmail, 1,500 с Google Workspace
Планирование, задержки, история кампанийДаДа
Аналитика и активностьДаДа
Autopilot и последовательности отслеживанияДа
Прогрев электронной почтыДа

Когда агент вызывает инструмент, который не включен в ваш план, вызов не молчит: инструмент отвечает сообщением, объясняющим, какой план нужен, и ссылкой на обновление, которую агент вам показывает. Ежедневная квота работает так же: check_quota говорит агенту, что подходит на сегодня, и кампания, которая не подходит, отложена или отклонена точно так же, как в веб-приложении. См. Pricing & subscription и Daily sending limits.

  • Агент подтверждает перед отправкой. Перед send_campaign агенту инструктируется показать вам количество получателей, шаблон и время отправки, и ждать вашего одобрения. Прочитайте это резюме так же внимательно, как вы прочитали бы кнопку отправки.
  • Сначала пробный запуск. Попросите пробный запуск, и агент сообщит, что было бы отправлено (получатели, тема, поля объединения) без фактической отправки.
  • Проверка квоты. check_quota говорит вам, сколько сегодняшней квоты использует кампания, поэтому большой список вас не удивит.
  • Столбец статуса все еще там. Кампания, запущенная из Google Sheet агентом, заполняет тот же столбец статуса 📮, что и запущенная из дополнения, поэтому вы можете следить за ней строка за строкой в таблице и в Campaigns.
  • Приостановите или остановите в любой момент из агента, из веб-приложения или из дополнения.

Откройте merge.email/app → Settings → AI agents. Карточка показывает каждого подключенного агента с датой подключения и последнего использования. Нажмите Revoke рядом с агентом, чтобы немедленно отрезать его доступ; следующий вызов, который он делает, отклоняется и ему нужно пройти вход заново.

Настройки AI-агентов

Отзыв доступа агента не трогает ваше подключение Google или других агентов. Чтобы удалить собственный доступ Mail Merge к вашему аккаунту Google, перейдите на myaccount.google.com/connections, что выходит из всех агентов сразу и также останавливает любую работающую кампанию (см. Reconnecting your Google account).

  • OAuth 2.1 с PKCE. Агент никогда не видит ваш пароль Google, и вы никогда не вводите пароль в агента. Вы входите на собственной странице Google и одобряете на странице согласия Mail Merge, которая указывает агента.
  • Один токен на агента. Каждое подключение получает свой собственный токен с собственным сроком действия и обновлением, поэтому отзыв одного агента оставляет других работающими.
  • Отзыв немедленный из Settings → AI agents или из вашего аккаунта Google.
  • Те же правила данных, что и в приложении. Агент читает и пишет ровно то, что может веб-приложение, ничего больше, и Mail Merge ничего нового не хранит от его имени. См. Permissions and data.