PushEngage

@pushengage/mcp

使用自然语言，通过任意 AI 助手管理你的 PushEngage 账户。

PushEngage 是一个推送通知平台，支持 Web 推送、移动应用推送、WhatsApp 和站内聊天小组件，可用于增加订阅者并挽回收入（例如购物车弃购、降价提醒、到货提醒等）。

此软件包是一个 Model Context Protocol (MCP) 服务。它可将 Claude Desktop、Claude Code 和 Cursor 等支持 MCP 的助手连接到你的 PushEngage 账户，让你只需提出需求，就能发送和安排通知、运行 A/B 测试、构建受众、查看分析数据以及管理网站设置，无需离开聊天界面。

你只需通过浏览器登录一次，之后助手便会代表你操作所选的 PushEngage 网站。

目录

• 你可以做什么
• 要求
• 安装
• 首次运行：登录
• 工具
• 配置
• 安全性和令牌存储
• 故障排除
• 许可证

你可以做什么

连接后，只需描述你想做什么。以下是一些示例：

发送和安排通知

• “发送一条通知，标题为‘促销今晚结束’，内容为‘最后机会，立享 5 折优惠’，链接到 https://example.com/sale。”
• “安排在每位订阅者所在的本地时区上午 9 点发送。”
• “设置每周一和周四上午 8 点发送的定期摘要，持续到本月底。”
• “对两个标题进行 A/B 测试，并按点击率自动推送胜出版本。”

精准定位用户

• “为访问过 /pricing 的访客创建细分群体。”
• “创建一个由美国的黄金套餐客户组成的受众，并仅向他们发送通知。”

了解效果

• “我有多少订阅者？过去 30 天的点击率是多少？”
• “列出我的活跃滴灌营销活动，并显示已发送、已查看和已点击的数据。”

配置网站

• “将默认通知有效期设为 7 天。”
• “将网站时区改为 Asia/Kolkata，并开启地理定位。”

要求

• 一个 PushEngage 账户（免费或付费），且至少有一个网站。
• Node.js 18 或更高版本（助手通过 npx 运行服务）。
• 一个支持 MCP 的客户端（Claude Desktop、Claude Code、Cursor 或其他客户端）。

安装

将此服务添加到客户端的 MCP 配置中。无需全局安装；npx 会按需获取。

Claude Desktop（一键安装包）

在 Claude Desktop 上，最简单的方式是使用 MCP Bundle：

1. 从 GitHub releases 页面下载最新的 pushengage-mcp-<version>.mcpb 文件。
2. 使用 Claude Desktop 打开该文件（双击或将其拖到窗口中），然后点击 安装。

所有内容都已打包，无需编辑 JSON。安装对话框还可选地允许你设置 PushEngage 授权页面上显示的标签，以及自定义令牌文件路径（用于运行多个账户）。

Claude Desktop（手动配置）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或平台上的对应文件：

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

重启 Claude Desktop。“pushengage”服务应会出现在工具列表中。

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

其他 MCP 客户端

任何通过 stdio 使用 MCP 通信的客户端都可以使用。将其配置为运行命令 npx -y @pushengage/mcp。

首次运行：登录

身份验证通过浏览器进行，因此你的凭据不会接触助手。

1. 提出请求：“帮我登录 PushEngage。” 服务会打开一个浏览器标签页，前往 PushEngage 授权页面。
2. 点击 Authorize。标签页会确认成功，并在本地保存访问令牌。
3. 提出请求：“显示我的 PushEngage 站点。”，然后提出 “使用站点 12345”，选择要操作的站点。重启后仍会保留此选择。

所有站点级工具默认对当前站点执行操作，除非你传入明确的 site_id。令牌过期时，你会看到 AUTH_EXPIRED 消息；只需再次请求登录即可。

工具

所有站点级工具默认使用当前站点。

身份验证和站点

工具	用途
pushengage_auth_login	打开浏览器前往 PushEngage，并在成功后保存令牌。
pushengage_auth_status	显示你是否已通过身份验证，以及当前选中的站点。
pushengage_auth_logout	删除本地存储的令牌。
pushengage_list_sites	列出你可以访问的 PushEngage 站点。
pushengage_select_site	设置其他工具使用的当前站点。

站点设置

工具	用途
pushengage_get_site_details / pushengage_update_site_details	站点名称、URL、时区、地理位置，以及“Powered By PushEngage”品牌标识开关。
pushengage_get_campaign_defaults / pushengage_update_campaign_defaults	UTM 参数、备用通知、备用属性和默认通知有效期。更新会合并到当前值，因此可以进行部分编辑。
pushengage_get_service_worker_settings / pushengage_update_service_worker_settings	Service Worker 注册、子文件夹支持和 Worker 文件路径。

受众

工具	用途
pushengage_list_segments / pushengage_create_segment	基于 URL 规则的订阅者细分。
pushengage_list_audience_groups / pushengage_create_audience_group	已保存的定向群组（设备、国家/地区、细分、互动、日期、属性）。发送工具的 audience_groups 会引用这些群组。
pushengage_list_attributes / pushengage_create_attribute	受众群组规则中使用的自定义订阅者属性键（每个站点最多 50 个）。

营销活动和自动化

工具	用途
pushengage_list_drip_campaigns	滴灌式自动回复。可按状态筛选；设置 include_analytics 可查看每个营销活动的统计数据。
pushengage_list_triggered_campaigns	触发式营销活动（购物车/浏览放弃、降价等）。可按状态筛选；分析数据为可选项。
pushengage_list_rss_campaigns	RSS 自动推送营销活动。可按状态筛选。
pushengage_list_workflows	工作流自动化。可按状态筛选；设置 include_analytics 可查看进入、活跃、已完成、失败及目标统计数据。

聊天小组件

工具	用途
pushengage_list_chat_widgets	在站点上展示 WhatsApp、Messenger 和其他渠道的小组件。显示状态、渠道、设备、营业时间限制和定向设置。

分析

工具	用途
pushengage_get_analytics_summary	累计总数：订阅者、已发送通知、浏览量、点击量和目标数量/价值。
pushengage_get_analytics_timeseries	按日期范围统计各时间段（日/周/月）的订阅者、发送量、浏览量、点击量、CTR 和退订量。

发送通知

工具	用途
pushengage_list_notifications	按时间倒序列出已发送、已安排和草稿通知。可按状态（与控制面板标签页的语义一致）、发送日期范围或标签筛选；设置 include_analytics 可获取汇总的 A/B 测试和按时区发送统计数据。
pushengage_send_notification	发送或安排通知。一个工具支持三种发送模式：立即发送、单次安排（可按订阅者时区发送）和定期发送。可选按 audience_groups 定向发送；否则发送给所有订阅者。
pushengage_send_ab_notification	发送包含两个变体的 A/B 通知。传入 intelligent_ab_test，即可对每个变体进行抽样，在延迟一段时间后按点击率选出胜出变体，并将其推广给其余用户。

配置

无需配置——此服务开箱即用，可直接连接 PushEngage 的生产 API。以下环境变量适用于较少见的设置：

环境变量	默认值	用途
PE_MCP_CLIENT_NAME	AI assistant	授权界面上显示的请求应用标签。如果想设置特定标签，可设置此变量，例如 "Claude Desktop"。
PE_MCP_CONFIG_PATH	~/.pushengage/mcp.json	令牌的存储位置。若要同时运行多个 PushEngage 账户，请设置此变量（见下文）。必须是绝对路径——系统会严格按给定路径使用，不会展开 ~。

同时运行多个 PushEngage 账户

使用两个不同的名称注册服务，并为每个服务设置各自的 PE_MCP_CONFIG_PATH，以避免令牌冲突：

{
  "mcpServers": {
    "pushengage-client-a": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
      }
    },
    "pushengage-client-b": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
      }
    }
  }
}

让助手分别以每个服务名称登录；每次授权时，都会连接到你在浏览器中选择的 PushEngage 账户。

安全与令牌存储

• 登录通过浏览器进行。助手永远不会看到你的 PushEngage 密码。
• 控制面板通过 POST 请求将令牌发送到服务，因此令牌不会出现在 URL、浏览器历史记录或访问日志中。
• 令牌存储在 ~/.pushengage/mcp.json 中，权限为 0600（仅你可读取）。令牌的过期时间由 PushEngage 设置，可通过 pushengage_auth_status 查看。
• 若要撤销令牌，请运行 pushengage_auth_logout，或在 PushEngage 的“设置”→“安全”中退出所有会话。

故障排除

服务完全无法连接（“Connection closed”）

如果你直接在终端中输入 npx -y @pushengage/mcp 可以正常运行，但客户端（Claude Desktop、Cursor 等）显示服务已断开连接，或记录类似 MCP error -32000: Connection closed 的信息，这几乎总是 PATH 问题，而不是服务本身的错误。

这些客户端是从 Dock/Finder 启动的，而不是从终端启动，因此不会加载 shell 的启动文件（.zshrc、.zprofile 等）。如果 Node 是通过版本管理器（nvm、fnm、volta 等）安装的，这些工具只会在启动文件中将 node/npx 添加到 PATH 中——因此客户端完全找不到 npx，服务进程也无法启动，最终出现通用连接错误，而不是清晰的“找不到命令”提示。

**修复方法：**将客户端指向 npx 的绝对路径（这样就无需通过 PATH 查找它），并在 env 中将同一目录作为 PATH 传入（这样 npx 重新执行时，其自身的 #!/usr/bin/env node shebang 才能找到 node）。在终端中运行 which npx 获取路径，然后将其用于客户端配置：

{
  "mcpServers": {
    "pushengage": {
      "command": "/absolute/path/from/which-npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

编辑后重启客户端。如果 which npx 输出的路径位于 /usr/local/bin 或 /opt/homebrew/bin 下，那么你的 Node 并非通过版本管理器安装，这很可能不是问题所在——请检查客户端自身的 MCP 日志以查看实际错误。

其他错误

• AUTH_EXPIRED — 你的令牌已过期。请让助手重新登录。
• NO_SITE_SELECTED — 调用 pushengage_list_sites，然后在使用站点范围的工具前，请求使用返回的某个站点。
• 浏览器未打开 — 这通常发生在无头或远程（例如 SSH）会话中。授权 URL 会显示在运行服务的终端中；请手动打开。
• 其他情况 — 服务返回的每条错误都以 [CODE] 标签开头，并附有通俗易懂的说明；如需帮助，请将其发送给支持团队。

许可证

MIT