Elastic Email MCP Server

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

Д_оступные действия, которые наш 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-серверу вы можете использовать любого ИИ-агента, поддерживающего MCP. Ключевым требованием для любой настройки является поддержка «режима агента», который позволяет ИИ-агенту безопасно взаимодействовать с внешними сервисами программным способом.

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

• https://github.com вам потребуется создать бесплатную учетную запись на Github
• https://code.visualstudio.com/ скачайте VS Code с этого сайта

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

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

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

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

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

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

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

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

• Создайте API-ключ в Elastic Email. Необходимые разрешения для просмотра и изменения: Account, Templates, Campaigns, Contacts, Files, Send HTTP. Кроме того, требуется как минимум доступ на просмотр к 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-ключа с указанными выше разрешениями. Также убедитесь, что после изменения этого поля вы сохранили изменения перед продолжением. Без сохранения изменений опция «запустить» интеграцию не появится.

• Теперь вы можете инициировать подключение к 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. ИИ-агенты могут застревать, запоминая предыдущие инструкции и повторяя их. Полезно начинать новый сеанс чата для решения таких проблем. Также вы можете дать агенту указание повторно получить инструменты и сообщить, что на сервере произошли изменения, чтобы убедиться, что он действительно получит новые данные.
2. Чем точнее запрос, тем меньше пространства для интерпретации остается у LLM, что снижает проблемы, связанные с галлюцинациями.
3. Полезно просматривать запросы перед их отправкой, так как вы можете заметить потенциальные несоответствия в том, как LLM преобразовал ваш запрос в вызовы API.