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