Elastic Email MCP

注意！以上视频仅展示了使用 API 密钥进行授权的一种方法。

MCP 服务器地址 https://mcp.elasticemail.com 仅用于连接 AI 代理。它不是 Elastic Email REST API 的地址，不能在其他集成中用作 API 主机。有关 API 地址，请参阅文章“API 设置”。

通过实现 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 服务器，您可以使用任何支持 MCP 的 AI 代理。任何设置的关键要求是支持“代理模式”，该模式允许 AI 代理安全地以编程方式与外部服务交互。

我们准备了使用 VS Code 和 Github Copilot 工具的分步设置示例。

• https://github.com 您需要在 Github 中创建一个免费账户
• https://code.visualstudio.com/ 从此网站下载 VS Code

接下来，您需要将您的 Github 账户连接到 VS Code

• 在 Github Copilot 中授权 Visual Studio Code

• 在下一步中允许运行 VS Code

• 要显示聊天窗口，请转到 VS Code 顶部菜单中的“视图 → 聊天”。聊天应显示在右侧。

• 将聊天切换到代理模式

• 现在您可以使用两种可用的授权方式之一：

1. 在 Elastic Email 中创建 API 密钥。所需的查看和修改权限如下：账户、模板、营销活动、联系人、文件、发送 HTTP。此外，至少需要对访问令牌具有“查看”权限。请记住，**切勿**与未经授权的第三方共享您的 API 密钥！

2. 使用 OAuth 授权方法。只需按照下一步说明操作，并跳过包含 X-Auth-Token 的 headers 部分。准备就绪后，启动与 MCP 服务器的连接：在配置文件中的 elasticemail.mcp 上方点击“启动”，并允许 VS Code 通过 oidc.elasticemail.com 进行身份验证。

您将被重定向到登录页面。成功登录后，您将自动重定向回 VS Code。如果未发生这种情况，请按照页面上显示的说明操作：

• 在 VS Code 顶部栏中使用搜索功能查找：显示并运行命令
• 您可以在搜索字段中输入“MCP”以缩小可用选项范围，然后选择“MCP: 打开用户配置”。
• 粘贴如下所示的配置文本（如果您已有任何服务器，只需 elasticemail.mcp 的数据即可）
• 仅当您想使用密钥方法进行授权时，才使用包含您的 API 密钥的 headers 部分。如果您使用 OAuth 方法，请将其删除。

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

请注意，这里最重要的一步是输入您实际的 API 密钥，并具有上述权限。另外，请确保在修改此字段后，在继续之前保存更改。如果不保存更改，“启动”集成的选项将不会出现。

• 现在您可以启动与 MCP 服务器的连接：在配置文件中的 elasticemail.mcp 上方点击“启动”。

从现在开始，您可以在聊天窗口中使用 Elastic Email MCP 服务器提供的操作。这些操作已在本文开头概述。

您可以尝试您的第一个命令以确保集成正常工作。例如，您可以输入“Is MCP working”提示，如果一切正常，您应该会收到确认回复。

为了更深入地了解这种集成在 Elastic Email 端的工作方式，请随时查看我们的 API 文档：

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

提示

1. AI 代理可能会卡在记住一些先前的指令并重试它们。启动新的聊天会话有助于解决此类问题。此外，您可以指示代理重新获取工具，并告知服务器端已有更改，以确保它确实重新获取新数据。
2. 提示越精确，留给 LLM 的解释空间就越小，从而减少与幻觉相关的问题。
3. 在发送请求之前检查请求是很有用的，因为您可能会注意到 LLM 将您的请求转换为 API 调用时可能存在的潜在不一致之处。

在其他 AI 代理中连接 MCP

上述设置使用 VS Code 和 GitHub Copilot，但相同的服务器地址适用于任何支持 MCP 并能以代理模式运行的 AI 代理。有关基于 Claude 的分步示例，请参阅如何将 Elastic Email MCP 服务器连接到 Claude。