ManyMoney Messaging MCP 服务器

Beta 功能通知

ManyMoney Messaging MCP 服务器正处于 Beta 测试阶段。端点和身份验证选项可能会发生变化。

概览

ManyMoney Messaging MCP 服务器是 ManyMoney AI MCP 服务器 的发送对应部分。ManyMoney AI MCP 服务器帮助您规划和构建营销活动，而 Messaging MCP 服务器则让您的 AI 代理能够根据自然语言指令，按需实际发送消息——包括推送通知、电子邮件、短信、WhatsApp、Telegram、LINE、Kakao 等。

将其连接到任何 Model Context Protocol (MCP) 客户端，您的代理就可以通过单个自然语言请求，向一个细分群体发送推送，或向特定用户发送个性化电子邮件。

支持的渠道

渠道	消息类型
推送 — iOS	标准、静默和关键通知、VoIP 推送以及实时活动
推送 — Android	标准推送，外加华为、百度和亚马逊 Fire
推送 — Web	Chrome、Firefox、Safari 和 Edge (Windows) 中的 Web 推送
电子邮件	HTML 正文、模板、附件、自定义发件人/回复地址
短信	通过您账户上配置的短信平台发送短信
WhatsApp	经 Meta 批准的模板用于出站发送；仅在用户首次向您发送消息后的 24 小时窗口内可发送自由格式文本
Telegram	带有内容变量的短信
LINE	内容和模板消息
Kakao	内容和模板消息

工作原理

1. 将 Messaging MCP 服务器连接到您的 AI 客户端一次（请参阅下方的 连接 MCP 服务器）。
2. 在您的 AI 客户端中，打开一个新的聊天窗口，用通俗语言描述发送需求。包括应用程序、受众（细分群体或特定用户）、消息文本，以及如果不是立即发送，则指定发送时间。请参阅下方的 请求中应包含的内容。您无需自己构建 API 请求或 JSON。
3. 当代理准备好发送时，请在您的客户端中审查详细信息并批准操作。
4. 批准后，Pushwoosh 会发送消息并返回一个 消息代码。您可以在 消息历史 中使用该代码查找发送记录并跟踪投递情况和统计数据。

您的代理能做什么

设置完成后，代理可以：

• 在任何支持的渠道上发送： 推送 (iOS、Android、Web)、电子邮件、短信、WhatsApp、Telegram、LINE 或 Kakao。
• 触达一个细分群体： 向 细分群体 中的所有人广播。
• 触达特定用户： 在某个事件（如订单更新、密码重置等）后，向一个或多个 用户 ID 发送消息。
• 安排投递时间： 立即发送、在设定时间发送、延迟发送，或根据每个用户的本地时区发送。
• 个性化内容： 为每个收件人填充模板占位符，如 {{first_name}} 或 {{promo_code}}。
• 将发送计入营销活动： 告知代理使用哪个 营销活动代码。该发送的投递和互动数据将显示在控制面板中对应的营销活动下。

请参阅下方 从您的 AI 客户端发送消息 中的 示例聊天请求。

兼容的 AI 客户端

Messaging MCP 服务器可与任何兼容 MCP 的客户端配合使用，包括：

• Anthropic 的 Claude Desktop
• Cursor 和 Windsurf
• Cline 和 Continue
• 基于 MCP 规范构建的自定义代理

连接 MCP 服务器

需要开发者协助

您可能需要开发团队的帮助才能将 Messaging MCP 服务器连接到您的 AI 客户端。请与他们分享本指南。

第 1 步：确保您拥有 Pushwoosh 账户和 API 令牌

Messaging MCP 服务器使用 Pushwoosh 服务器 API 令牌 进行身份验证。

在 Pushwoosh 控制面板中，前往 设置 → API 访问，点击 生成新令牌，选择 服务器，并保存该令牌。您将在下一步中将其添加到客户端配置中。

该令牌继承了您账户的权限。请 将其限制 为您希望代理通过其发送消息的应用程序。

第 2 步：将服务器添加到您的 AI 客户端

使用以下端点：

https://messaging-api.svc-nue.pushwoosh.com/mcp

Claude Desktop

将服务器添加到您的 Claude Desktop 配置文件 (claude_desktop_config.json) 中：

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

保存后重启 Claude Desktop。

Cursor / Windsurf

将服务器添加到您的 .cursor/mcp.json 文件中（或 Windsurf 中的等效文件）：

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

保存后重新加载编辑器。

其他客户端

将您的客户端指向 https://messaging-api.svc-nue.pushwoosh.com/mcp 并设置 Authorization: Token YOUR_API_TOKEN 请求头。有关添加带有自定义头的远程 MCP 服务器，请参阅您客户端的文档。

第 3 步：试一试

在您的 AI 客户端中打开一个新的聊天窗口，并提出一个具体的问题：

“在应用程序 XXXXX-XXXXX 中，向我的测试设备发送一条推送，标题为‘来自代理的问候’，正文为‘这是一条测试消息’。”

在批准代理的操作之前，请确认受众和消息内容。

如果连接成功，代理会发送消息并返回一个 Pushwoosh 消息代码，例如 PW-12345-67890。

从您的 AI 客户端发送消息

代理每次请求发送一条消息。

批准前请检查

通过 Messaging MCP 服务器发送的消息是真实投递。一旦您批准“立即发送”操作，或在您设定的计划时间，消息就会发出。在您的 AI 客户端中批准操作之前，请检查应用程序、受众、渠道、消息文本和时间安排。当目标是细分群体时要特别小心。一旦您批准，代理无法取消发送。计划发送的消息可以在 Pushwoosh 控制面板的 消息历史 中取消，但仅限于发送开始之前。

请求中应包含的内容

在您的聊天中描述以下详细信息，以便代理知道要发送什么、谁应该接收以及何时发送。请使用通俗语言（例如，“应用 XXXXX-XXXXX”，“细分群体 cart-abandonment”）。

应包含的内容	描述
application	应用程序代码 (XXXXX-XXXXX)
platforms	要发送的 渠道 ID（推送、电子邮件、短信等）
target	细分代码、细分表达式，或明确的 用户、hwid 或 推送令牌 列表（事务性目标定位）
message_payload	推送： 标题和正文，或 推送预设，可选声音、角标和打开操作 电子邮件： 主题、正文或 模板、附件 短信和即时通讯工具： 文本或已批准的模板
schedule	在特定时间发送、延迟发送或遵循用户时区
dynamic_content_placeholders	占位符的值，例如 {{first_name}} 或 {{promo_code}}
campaign	将消息归属的 营销活动代码
frequency_capping	频率上限 限制每个用户在时间窗口内接收消息的频率

代理如何发送消息

代理使用 Notify 工具创建并发送一条消息。支持两种目标定位模式：

模式	何时使用
细分	向所有匹配 细分 或 细分表达式 的用户广播。支持 计划发送、频率上限、发送速率 和 对照组。
事务性	发送给特定的 用户、hwids 或 推送令牌 列表。非常适合触发式或个性化消息。

示例提示

向细分群体发送推送：

在应用程序 XXXXX-XXXXX 中，向 iOS 和 Android 上的 cart-abandonment 细分群体发送一条推送。

标题：“还在考虑吗？” 正文：“您的购物车在等您，这里有 10% 的折扣。”

安排在每个用户本地时间的下午 3 点发送。使用营销活动代码 spring-promo。

向单个用户发送电子邮件：

在应用程序 XXXXX-XXXXX 中，向用户 uid-123 发送一封电子邮件，使用电子邮件模板 welcome-flow-v2，并将占位符 {{first_name}} 设置为 Alex。

向细分群体发送短信：

在应用程序 XXXXX-XXXXX 中，向细分群体 vip-users 发送一条短信，内容为“您的专属优惠今晚结束。” 立即发送。

向细分群体发送 Telegram 消息：

在应用程序 XXXXX-XXXXX 中，向细分群体 subscribers-monthly 发送一条 Telegram 消息，内容为“嗨 {{first_name}}，您的五月发票已准备好——请从您的账户下载。” 安排在明天上午 10:00 UTC 发送。

身份验证

Messaging MCP 服务器支持两种身份验证方法：

方法	如何使用
API 令牌	在每个请求中添加 Authorization: Token YOUR_API_TOKEN。推荐用于代理和自动化管道。
会话令牌 (SSO)	添加 Authorization: Bearer YOUR_SSO_TOKEN。用于通过 Pushwoosh OAuth2 SSO 在特定用户会话下操作的程序化集成。对于典型的代理设置不需要——请改用服务器 API 令牌。

缺少或无效令牌的请求将被拒绝，并返回 HTTP 401。

提示和最佳实践

• 在批准前务必仔细审查每次发送。 这些是真实的投递，它们会在您批准或在计划时间发出。请确保客户端中的应用、受众、渠道和消息文本与您的意图相符。
• 为代理使用专用的服务器 API 令牌。 在 设置 → API 访问 中创建一个单独的 服务器 API 令牌，并 将其限制 为代理应从中发送的应用程序。这样，代理的访问权限就仅限于这些应用。
• 对触发式消息使用事务性目标定位。 当您在某个事件（如订单已发货、密码重置）后向已知用户 ID 发送消息时，请使用 transactional 模式并附带 users: [userId]。不要为同一次发送构建一个单人细分群体。请参阅 NotifyTransactional。
• 在进行大规模发送前，先在测试设备上测试。 在向真实细分群体发送之前，请先让代理向您的 已注册测试设备 发送。例如：“在应用程序 XXXXX-XXXXX 中，向我的测试设备发送一条推送，标题为‘测试’，正文为‘在此处检查文本’。” 这会将消息仅路由到您在 设置 → 测试设备 中添加的设备。当预览看起来正确时，再请求真实的细分群体或受众。
• 在您的请求中指定一个营销活动。 在聊天中包含一个 营销活动代码（例如 spring-promo），以便结果显示在 Pushwoosh 控制面板中正确的营销活动下。
• 广播前确认。 配置您的 AI 客户端，在批准任何针对细分群体的工具调用前，要求明确确认。向大量受众广播是不可逆的。
• 使用占位符进行个性化。 在您的聊天请求中传递 {{first_name}} 或 {{promo_code}} 等占位符的值，而不是为每个用户构建单独的消息。

相关内容

ManyMoney AI MCP 服务器：规划和构建营销活动

控制面板内的 ManyMoney AI

AI 工具概览