注意：此项目没有可用的旧版文档，因此您看到的是当前文档。
PushEngage MCP 服务器允许您通过 AI 聊天窗口运行推送通知堆栈。您将服务器连接到 Claude 等 AI 客户端，在浏览器中一次性批准访问，然后通过用自然语言描述您想要的内容来管理网站、订阅者、受众、广告系列和分析。本指南将引导您完成连接服务器以及您可以使用它完成的所有操作，并为每个步骤提供一个简短的视频。
开始之前
- 您需要一个 PushEngage 帐户和一个活跃的网站。
- 您需要一个支持 MCP 的 AI 客户端，例如 Claude。该服务器以
@pushengage/mcp的形式发布，并公开了 27 个工具。 - 批准在您的浏览器中进行，而不是在聊天中。当客户端首次连接时，PushEngage 会打开一个浏览器窗口，您可以在其中授权访问，并且可以随时从我的帐户 » 活动会话撤销访问权限。
- 访问令牌会颁发给您设备上的本地客户端，并且有时间限制。
MCP 服务器如何工作
您在聊天窗口中与 PushEngage 对话，服务器会将您的请求转化为您帐户上的正确操作。每个请求都映射到服务器的工具之一，发送或更改数据的操作在运行前会得到确认。您选择的网站在会话期间保持活跃，因此您只需设置一次即可继续工作。
| 区域 | 您可以做什么 |
|---|---|
| 帐户和会话 | 登录、检查登录状态和退出。 |
| 网站 | 列出您的网站、选择活动网站以及查看或更新网站设置。 |
| 订阅者和受众 | 列出并创建自定义属性、细分和受众群组。 |
| 发送 | 发送推送通知、发送 A/B 通知以及列出已发送的通知。 |
| 广告系列和自动化 | 查看邮件营销广告系列、触发式广告系列、工作流、RSS 广告系列、聊天小部件和广告系列默认设置。 |
| 分析 | 获取终身分析摘要和随时间变化的分析数据。 |
连接和登录
将 PushEngage MCP 服务器添加到您的 AI 客户端，然后要求它登录。客户端会打开一个浏览器窗口，您可以在其中点击授权以授予访问权限。一旦您批准，聊天就会确认您已登录并显示会话到期时间。
- 将
@pushengage/mcp服务器添加到您的 AI 客户端。[确认：每个客户端的确切安装命令或配置，例如 Claude、Cursor 和 VS Code。] - 要求助手登录您，例如，
登录 pushengage。 - 在打开的浏览器窗口中，查看访问请求并点击授权。
- 返回聊天，您将看到登录已确认以及会话到期时间。
选择您的网站
如果您管理多个网站，请询问您的网站，然后选择您要处理的网站。所选网站在本会话的其余时间保持活动状态，因此后续的请求会自动应用于该网站。
- 询问您的网站，例如，
显示我的 PushEngage 网站。 - 记下您想要的网站的网站 ID。
- 要求助手使用该网站，例如，
使用网站 Playground。
管理订阅者、属性和受众
描述您想要的订阅者数据，助手会创建它。您可以根据自然语言描述列出和创建自定义属性、创建细分以及构建受众群组。
自定义属性
询问您的自定义属性，或通过描述创建一个新属性，例如，创建一个名为 Customer Plan 的属性，键为 plan。助手会用其 ID、名称、键和状态确认该属性。
细分和受众群组
通过描述应捕获的访问者来创建细分，并以相同的方式列出或构建受众群组。例如，创建一个位于美国的金牌套餐移动客户的受众 会返回一个具有筛选器逻辑和可用于发送时重复使用的 ID 的新受众群组。
发送、确认和安排
要求助手发送通知，它会在发送任何内容之前向您确切显示将要发送的内容。推送通知会立即发送且无法撤回，因此助手总是先要求您确认。
- 描述通知，例如，
发送一个标题为“促销今晚结束”，消息为“最后机会，五折优惠”，链接到 https://example.com/sale 的通知。 - 查看助手向您显示的预览。
- 回复确认，助手会发送通知并返回通知 ID。
要安排发送而不是立即发送，请说明时间，例如，为每个订阅者的本地时区安排上午 9 点发送。助手会安排一次发送，在每个订阅者自己的本地时间触达他们。
A/B 测试通知
要求进行 A/B 测试以比较两个版本，并让 PushEngage 自动推出获胜版本。您需要设置测试规模、获胜指标以及在获胜版本发送给其余受众之前的延迟。
例如，运行一个两个标题的 A/B 测试，并在 60 分钟后根据点击率自动推出获胜版本，最多 10,000 名订阅者，每个变体 10%。助手会设置测试并安排自动获胜者推出。
管理广告系列、工作流和默认设置
通过一行即可查询自动化状态并更改帐户默认设置。您可以列出入门广告系列、触发式广告系列、具有进入、完成和失败计数的工作流、聊天小部件和 RSS 广告系列。
要更改默认设置，请进行描述，例如，将我的默认通知有效期设置为 7 天。助手会应用更改并确认之前的值。您还可以检查您的广告系列默认设置，例如 UTM 参数是否已启用。
网站设置
要求助手审核或更新网站设置，例如服务工作线程位置、网站时区和地理位置。如果某个设置已符合您的要求，助手会告知您无需更改，而不是进行冗余更新。
查看分析
询问您的数据，助手会在聊天中返回。您可以列出已发送通知的浏览量和点击量，查看表现最佳的通知，并获取网站的终生分析摘要。
例如，提供此网站的终生分析摘要会返回一个包含活跃订阅者、已发送通知、浏览量、点击量和目标转化次数的表格，以及对您的点击率的快速解读。
常见问题解答
在哪里批准访问，安全吗？
您在浏览器中批准访问，绝不会在聊天中进行。访问令牌会颁发给您设备上的本地客户端，并且有时限，您可以随时从“我的帐户”»“活动会话”中撤销。由于批准是通过浏览器进行的，因此您的助手永远不会处理您的密码。
哪些 AI 客户端与 PushEngage MCP 服务器配合使用？
任何支持 MCP 的客户端都可以连接到 @pushengage/mcp。[确认：官方支持和测试的客户端列表，例如 Claude、Cursor 和 VS Code，以及每种客户端的确切设置步骤。]
我必须每次都选择我的网站吗？
否。一旦您选择了一个网站，它将在您会话的其余时间保持活动状态，因此后续的请求将应用于该网站，直到您切换。如果您管理一个网站，助手将直接与其配合使用。
助手会不经我同意就发送通知吗？
否。发送和其他更改在运行前都会得到确认。由于推送通知会立即发出且无法撤回，因此助手会向您展示将要发送的内容，并等待您的确认。
MCP 服务器实际上能做什么？
它公开了 27 个工具，涵盖帐户和会话、网站和网站设置、订阅者属性、细分和受众群体、发送和 A/B 测试、广告系列和工作流、广告系列默认设置以及分析。请参阅本指南前面的功能表以获取完整明细。
如果您遇到任何问题，请随时通过单击此处联系我们。我们的支持团队将能够帮助您。
