Elastic Email MCP

Примечание! Видео выше демонстрирует только один метод авторизации с помощью API-ключа.

Адрес MCP-сервера, https://mcp.elasticemail.com, используется только для подключения AI-агентов. Это не адрес REST API Elastic Email, и его нельзя использовать в качестве хоста API в других интеграциях. Для получения адреса API обратитесь к статье «API Settings».

Внедряя 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

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

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

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

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

• Теперь вы можете использовать один из двух доступных способов авторизации:

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

2. Используйте метод авторизации OAuth. Просто следуйте следующим шагам инструкции и пропустите добавление раздела заголовков с X-Auth-Token. Когда будете готовы, инициируйте подключение к MCP-серверу: нажмите Start над elasticemail.mcp в файле конфигурации и разрешите VS Code аутентификацию через oidc.elasticemail.com.

Вы будете перенаправлены на страницу входа. После успешного входа вы будете автоматически перенаправлены обратно в VS Code. Если этого не произошло, следуйте инструкции, отображаемой на странице:

• В верхней панели VS Code используйте функцию поиска, чтобы найти: Show and run commands
• Вы можете написать «MCP» в поле поиска, чтобы сузить доступные варианты, и выбрать « MCP: Open user configuration».
• Вставьте текст конфигурации, как показано ниже (если у вас уже есть серверы, достаточно только данных elasticemail.mcp)
• Используйте раздел заголовков с вашим API-ключом только в том случае, если вы хотите использовать метод ключа для авторизации. Удалите его, если вы используете метод OAuth.

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

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

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

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

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

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

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

Советы

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

Подключение MCP в других AI-агентах

В настройке выше используются VS Code и GitHub Copilot, но тот же адрес сервера работает с любым AI-агентом, который поддерживает MCP и может работать в режиме агента. Для пошагового примера на основе Claude см. Как подключить MCP-сервер Elastic Email к Claude.