Elastic Email MCP

официальный

Сервер Elastic Email MCP позволяет AI-агентам, таким как GitHub Copilot, ChatGPT, Claude и другим совместимым ассистентам, легко интегрироваться с вашим аккаунтом Elastic Email.

Что можно делать с Elastic Email MCP?

  • Добавить контакт в список — Попросите вашего ассистента добавить подписчика в определенный список контактов.
  • Создавать и управлять кампаниями — Создавайте, обновляйте, приостанавливайте или просматривайте список email-кампаний с помощью create_campaign, update_campaign, pause_campaign и list_campaigns.
  • Отправлять массовые и транзакционные письма — Дайте указание ИИ отправлять письма напрямую через ваш аккаунт Elastic Email.
  • Получать ресурсы аккаунта — Извлекайте существующие контакты, списки, сегменты и шаблоны, чтобы просмотреть уже настроенные элементы.
  • Удалять контакты — Удалите контакт из определенного списка или из всего аккаунта.
  • Проверять готовность подключения — Убедитесь, что сервер MCP подключен и работает, с помощью проверки состояния.

Документация

Внедряя MCP, Elastic Email позволяет AI-агентам получать доступ к вашим почтовым операциям и управлять ими, сохраняя при этом безопасность и надлежащую аутентификацию.

Доступные действия, которые наш MCP сможет выполнять для вас_

  • Добавить контакт в список
  • Загрузить и добавить контакты
  • Создать список
  • Создать сегмент
  • Создать кампанию
  • Получить кампании
  • Обновить кампанию
  • Приостановить кампанию
  • Перечислить кампании
  • Отправлять электронные письма: как транзакционные, так и массовые
  • Получить контакт, контакты, контакт из списка
  • Получить списки
  • Получить шаблоны
  • Получить сегменты
  • Проверка готовности (проверка работоспособности, соединения и готовности)
  • Удалить контакт из списка
  • Удалить контакт из аккаунта

Обратите внимание, что не все перечисленные конечные точки доступны для всех тарифных планов Elastic Email. Например, конечные точки кампаний и контактов недоступны для планов Email API. Вот полный список наших доступных статей по перечисленным выше функциям:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

Настройка

Чтобы подключиться к нашему MCP-серверу, вы можете использовать любой AI-агент, поддерживающий MCP. Ключевое требование для любой настройки — поддержка «режима агента», который позволяет AI-агенту безопасно взаимодействовать с внешними сервисами программным способом.

Мы подготовили пример пошаговой настройки с использованием VS Code и инструментов Github Copilot.

Далее вам нужно будет подключить ваш аккаунт Github к VS Code

  • Установите и запустите VS Code

  • Откройте расширения в левом меню и установите расширения Github Copilot и Github Copilot Chat

  • Войдите в Github, используя аккаунт, созданный на предыдущем шаге

  • Авторизуйте Visual Studio Code в Github Copilot

  • Разрешите запуск VS Code на следующем шаге

  • Чтобы отобразить окно чата, перейдите в View → Chat в верхнем меню VS Code. Чат должен отобразиться с правой стороны.

  • Переключите чат в режим агента (Agent Mode)

  • Создайте API-ключ в Elastic Email. Требуемые разрешения для просмотра и изменения: Account, Templates, Campaigns, Contacts, Files, Send HTTP. Кроме того, требуется как минимум доступ «view» к Access Tokens. Пожалуйста, помните: никогда не передавайте ваш API-ключ неавторизованным третьим лицам!

  • В верхней панели VS Code используйте функцию поиска, чтобы найти: Show and run commands

  • Вы можете ввести «MCP» в поле поиска, чтобы сузить доступные варианты, и выбрать «MCP: Open user configuration».

  • Вставьте текст конфигурации, как показано ниже (если у вас уже есть какие-либо серверы, достаточно будет только данных elasticemail.mcp)

{
"servers": {
"elasticemail.mcp": {
"url": "https://mcp.elasticemail.com",
"headers": {
"X-Auth-Token": "your_api_key"
}
}
}
}

Обратите внимание, что самый важный шаг здесь — ввести ваш фактический API-ключ с вышеуказанными разрешениями. Также убедитесь, что после изменения этого поля вы сохранили изменения перед продолжением. Без сохранения изменений опция «start» интеграции не появится.

  • Теперь вы можете инициировать подключение к MCP-серверу: нажмите Start над elasticemail.mcp в файле конфигурации.

  • Альтернативный способ: выберите Extensions в левом меню, выберите сервер из MCP SERVERS INSTALLED внизу, нажмите правой кнопкой мыши и выберите Start server

С этого момента вы можете использовать действия, предоставляемые MCP-сервером Elastic Email, в окне чата. Эти действия были описаны в начале этой статьи.

Вы можете попробовать свою первую команду, чтобы убедиться, что интеграция работает. Например, вы можете ввести запрос «Is MCP working», и если всё работает, вы должны получить подтверждение в ответ.

Чтобы лучше понять, как такая интеграция работает на стороне Elastic Email, вы также можете ознакомиться с нашей документацией по API:

https://elasticemail.com/developers/api-documentation/rest-api

Советы

  1. AI-агенты могут застрять, запоминая предыдущие инструкции и повторяя их. Полезно начать новый сеанс чата, чтобы решить такие проблемы. Также вы можете указать агенту повторно получить инструменты и сообщить, что на сервере произошли изменения, чтобы он действительно загрузил новые данные.
  2. Чем точнее запрос, тем меньше места для интерпретации вы оставляете LLM, что снижает проблемы, связанные с галлюцинациями.
  3. Полезно проверять запросы перед их отправкой, так как вы можете заметить потенциальные несоответствия в том, как LLM преобразовал ваш запрос в вызовы API.