PushEngage WordPress 功能

PushEngage 注册了一组 WordPress 功能，以便 AI 助手和 MCP 客户端可以直接从您的 WordPress 网站操作您的推送通知。每个功能都是一个单一的、描述清晰的操作，例如发送通知、列出细分或提取分析报告，助手可以发现并征得您的许可后调用。本指南解释了这些功能是什么、使用它们需要什么以及代理可以做什么。

开始之前

• 您需要 PushEngage 插件版本 4.2.3 或更高版本。此版本将 PushEngage 的功能注册到 WordPress 功能 API。
• 您的网站需要 WordPress 7.0 或更高版本。功能 API 自 7.0 版本起已成为 WordPress 核心的一部分。
• 您必须是管理员。每个 PushEngage 功能都需要 manage_options 权限，并且助手通过应用程序密码以 WordPress 用户的身份进行身份验证。
• 要通过 MCP 将功能暴露给外部 AI 客户端，请添加免费的 WP MCP Adapter 插件。您可以在 PushEngage 工具页面 PushEngage » Tools 上查看其状态以及您的其他 AI 工具包。
• 某些功能仅在 WooCommerce 处于活动状态时可用。

PushEngage 功能的工作原理

当您的网站加载时，PushEngage 插件通过 WordPress 功能 API 注册一个 pushengage 功能类别及其功能。每个功能都声明了一个 AI 助手可以发现和调用的单一权限，格式为机器可读、兼容 MCP。

访问权限继承自 WordPress，而不是 PushEngage 构建的独立系统：

• 权限。 每个功能都需要 manage_options 权限，通过功能 API 的 permission_callback 声明。助手通过应用程序密码针对 WordPress 用户进行身份验证，这是自 5.6 版本以来标准的 WordPress 机制。以管理员身份连接的助手可以运行这些功能。以贡献者身份连接的助手则不能。
• 确认。 只有一个功能被标记为破坏性操作：发送通知，因此了解 MCP 的助手在发送前会与您确认。设置更新和细分创建是非破坏性的。
• 最小权限。 获取调试日志会返回管理员级别的管理内容，例如 URL 和请求负载，并且与所有其他功能一样，仅限于相同的管理员权限。助手拥有与运行它的管理员相同级别的访问权限，不多不少。

要从外部助手访问这些能力，请安装免费的WP MCP适配器，它会将已注册的能力桥接到您的助手所使用的MCP协议。在连接适配器或MCP客户端之前，这些能力已注册，但尚无代理可以访问它们。

代理可以做什么

PushEngage注册了22种能力，这些能力按其执行的工作分组如下。您的“工具”页面上显示的具体数量可能因您网站上激活的内容而异，因为某些能力仅在WooCommerce存在时注册。“类型”显示了能力是仅读取数据还是也写入更改。

发送推送通知

能力	它的作用	类型
发送通知	向订阅者发送推送通知。	写入
获取通知	返回单个通知的详细信息。	仅读取
列出通知	列出通知，可选择按状态过滤和分页。	仅读取
获取连接状态	返回网站是否已连接到PushEngage帐户。	仅读取

构建和定位细分

能力	它的作用	类型
列出细分	列出订阅者细分。	仅读取
列出受众群体	列出可用于定位的受众群体。	仅读取
创建细分	创建一个新的订阅者细分。	写入
将订阅者添加到细分	将订阅者添加到现有细分。	写入

读取您的分析

能力	它的作用	类型
获取通知摘要	返回所有通知的汇总发送、查看和点击次数。	仅读取
获取分析概览	返回日期范围内的订阅者、展示次数和点击次数，按天、周或月分组。	仅读取
获取订阅者分析	返回每周活跃和总活跃订阅者。	仅读取

配置自动推送

能力	它的作用	类型
获取自动推送设置	返回自动推送配置，包括启用的帖子类型和功能标志。	仅读取
更新自动推送设置	更新自动推送，包括切换、帖子类型、图标和功能标志。	写入
列出分类	列出 WordPress 帖子分类，并在 WooCommerce 激活时列出 WooCommerce 产品分类。	仅读取
列出分类段映射	列出 WordPress 分类到 PushEngage 段的映射。	仅读取
获取属性映射	返回 PushEngage 订阅者属性到 WordPress 用户元键的映射。	仅读取

运行 WooCommerce 和 WhatsApp 自动化

这些功能仅在 WooCommerce 激活时可用。获取 WhatsApp 状态还需要有效的 WhatsApp 凭据。

能力	它的作用	类型
列出推送自动化广告系列	列出 WooCommerce 推送自动化广告系列及其管理员和客户配置。	仅读取
更新推送自动化广告系列	启用、禁用或配置 WooCommerce 推送自动化广告系列。	写入
列出 WhatsApp 自动化广告系列	列出为 WooCommerce 事件配置的 WhatsApp 自动化广告系列。	仅读取
获取 WhatsApp 状态	返回 WhatsApp 集成凭据是否有效。	仅读取

诊断和验证

能力	它的作用	类型
获取插件信息	返回插件版本、连接状态和关键配置。	仅读取
获取站点环境	返回用于诊断的 WordPress、PHP 和服务器详细信息。	仅读取
获取调试日志	列出调试日志文件，并在提供文件名时读取特定文件。仅限管理员，因为日志内容可能包含 URL 和请求负载。	仅读取

您可以问您的助手什么

一旦 MCP 客户端连接成功，您就可以用通俗易懂的语言描述工作内容，助手会调用相应的能力。例如：

• “找到我的‘有互动购物者’细分，然后向其中所有人发送一个标题为‘闪购午夜截止’、链接到我的促销页面的推送。”助手会列出细分以查找 ID，然后发送通知，在发送前进行确认。
• “向我展示过去 30 天的每周分析报告，以及哪些广告系列带来了最多的点击量。”助手会拉取分析概览并将发送量与标题进行匹配。
• “在周二之前禁用我的 WooCommerce 浏览放弃营销活动。”助手会列出自动化营销活动并更新正确的活动。
• “创建一个名为‘pricing-page-visitors’的细分，捕获过去七天内访问过 /pricing 的任何人。”助手会根据您的描述创建细分。

常见问题解答

谁可以使用这些能力？

仅限管理员。每个 PushEngage 能力都需要 manage_options 权限，并且助手通过应用程序密码以 WordPress 用户的身份进行身份验证。以管理员身份连接的助手可以运行这些能力，而以贡献者身份连接的则不能。

我需要 MCP Adapter 吗？

您需要它才能通过 MCP 从外部 AI 客户端访问这些能力。这些能力会自动注册到 WordPress Abilities API，但免费的 WP MCP Adapter 是将它们连接到您的助手所使用的 MCP 协议的桥梁。您可以在 PushEngage 工具页面上查看其状态。

为什么我的工具页面显示的能力数量不同？

PushEngage 总共注册了 22 项能力，但 WooCommerce 推送自动化和 WhatsApp 能力仅在 WooCommerce 处于活动状态时注册，因此您网站上显示的数量取决于哪些处于活动状态。

代理会未经我许可就更改我的帐户吗？

只读能力仅返回数据。只有“发送通知”被标记为具有破坏性，因此了解 MCP 的助手在触发发送前会与您确认。设置更新和细分创建是非破坏性的，无需提示即可运行。

我需要哪个插件和 WordPress 版本？

能力需要 PushEngage 4.2.3 或更高版本，Abilities API 需要 WordPress 7.0 或更高版本。建议保持插件更新，因为更高版本会优化能力及其 AI 和 MCP 响应。

如果您遇到任何问题，请随时通过单击此处联系我们。我们的支持团队将能够帮助您。