ManyMoney Messaging MCP 服务器

Beta 功能通知

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

概述

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

将其连接到任何模型上下文协议 (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://manymoney-messaging.pushwoosh.com/mcp

Claude Desktop

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

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

保存后重启 Claude Desktop。

Cursor / Windsurf

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

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

保存后重新加载编辑器。

Other clients

将您的客户端指向 https://manymoney-messaging.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 工具创建并发送一条消息。支持两种目标定位模式：

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

示例提示

向细分群体发送推送：

在应用程序 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 令牌。
OAuth 2.0 (动态客户端注册)	适用于实现 MCP 授权规范 而非静态头的 MCP 客户端。范围反映了登录用户的 Pushwoosh SSO 会话（不限于特定应用程序），访问令牌有效期为 7 天，刷新令牌有效期为 30 天。请参阅下文的 OAuth 2.0 登录流程。

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

OAuth 2.0 登录流程

支持 MCP 规范的 OAuth 流程的客户端（例如，Claude Desktop 的远程服务器登录）不需要手动粘贴令牌——客户端会发现授权服务器，自行注册，并引导用户完成 Pushwoosh SSO 登录和同意步骤：

1. 发现。 客户端在 MCP 端点的主机上获取 /.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server，以找到 authorize、token 和 register 端点。
2. 动态客户端注册 (DCR)。 客户端向 /register 发送 POST 请求以获取 client_id，无需在控制面板中进行任何手动设置。
3. 使用 PKCE 进行授权。 客户端使用 code_challenge_method=S256 将用户发送到 /authorize 并附带 code_challenge。PKCE 是强制性的——令牌端点不通过任何其他方式验证客户端，因此没有有效 S256 质询的请求将被拒绝。
4. Pushwoosh SSO 登录和同意。 用户通过 Pushwoosh SSO 登录，然后在颁发授权码之前，在 /oauth/consent 屏幕上确认客户端的访问权限。
5. 令牌交换。 客户端在 /token 处交换代码和 PKCE 验证器以获取访问令牌，然后在 MCP 请求中将其作为 Authorization: Bearer 发送。

您无需自己配置任何这些内容——这仅在您排查的客户端实现流程与预期不同时才重要。

提示和最佳实践

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

相关内容

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

控制面板内的 ManyMoney AI

AI 工具概述