前提条件 \
- 一个可以访问您要管理的 OneSignal 应用的 OneSignal 账户。
- 通过 OAuth(OneSignal 使用的基于浏览器的登录方式)批准 OneSignal 访问的权限。
- 一个支持通过 HTTP 和 OAuth 连接远程 MCP 服务器的 AI 工具。
连接详情 \
每个 AI 工具都连接到同一个托管端点:设置您的 AI 工具 \
Cursor \
从 Cursor Marketplace 安装 OneSignal。1
打开 OneSignal 插件
前往 Cursor Marketplace 中的 OneSignal,或在 Cursor 的 Marketplace 中搜索 OneSignal。
2
安装插件
点击 Add to Cursor。Cursor 会安装 OneSignal 插件,其中包括 MCP 服务器。
3
登录 OneSignal
打开 Settings > MCP & Integrations,然后点击 OneSignal 旁边的 Authenticate。在浏览器中登录并点击 Agree & Allow Access。
4
在 Agent 聊天中使用 OneSignal
开始一个新的 Agent 聊天,并让 OneSignal 执行只读检查,例如列出您的 OneSignal 应用。
mcp.json:
Claude Code \
1
添加 OneSignal MCP 服务器
在终端中运行以下命令:
2
在 Claude Code 中进行身份验证
启动
claude,然后输入 /mcp 打开 MCP 面板。选择 onesignal,然后选择 Authenticate,在浏览器中打开 OneSignal 登录页面。3
批准访问
登录并点击 Agree & Allow Access。返回 Claude Code。服务器状态会变为 connected。
claude mcp list,或在 Claude Code 中运行 /mcp,即可查看工具数量。
Claude 自定义连接器 \
仅当您无法从 Claude 目录安装 OneSignal 时,才使用自定义连接器。远程 MCP 服务器无法通过claude_desktop_config.json 添加,该文件仅用于本地 stdio 服务器。
1
添加自定义连接器
前往 Customize > Connectors 并点击 Add custom connector。
2
输入服务器详情
将 Name 设置为
OneSignal,将 Remote MCP server URL 设置为 https://api.onesignal.com/mcp/oauth。将 Advanced settings 下的 OAuth Client ID 和 OAuth Client Secret 留空。3
登录 OneSignal
点击 Add,然后在浏览器中完成 OneSignal 登录并点击 Agree & Allow Access。
Codex CLI \
1
打开插件浏览器
运行
codex,然后输入 /plugins。2
安装 OneSignal
找到 OneSignal,打开并安装它。
3
开始新会话并登录
开始一个新会话。当 Codex 要求您进行身份验证时,在浏览器中登录 OneSignal 并点击 Agree & Allow Access。
VS Code 中的 GitHub Copilot \
将 OneSignal 添加到工作区的.vscode/mcp.json 中以与团队共享,或从命令面板运行 MCP: Open User Configuration 为您的用户配置文件安装:
其他 AI 工具和代理 \
在您的 AI 工具的远程 MCP 服务器设置中添加https://api.onesignal.com/mcp/oauth。AI 工具第一次调用 OneSignal 工具时,会在浏览器中打开 OneSignal 登录页面。登录并点击 Agree & Allow Access。连接成功后,您的 AI 工具会列出 OneSignal 工具。
验证连接 \
开始一个新的聊天或会话并发送:onesignal_health。它在 AI 工具访问权限开启之前就会响应,因此健康的结果并不能确认其他工具可以正常工作。
故障排除 \
- 重新进行身份验证。 从您的 AI 工具的 MCP 或连接器设置中重新连接 OneSignal,然后开始新会话。
-
检查服务器 URL。 URL 必须完全为
https://api.onesignal.com/mcp/oauth,不能有额外的路径或尾随字符。 - 清空 OAuth 客户端字段。 如果您的 AI 工具有 OAuth 客户端 ID 或密钥字段,请将其留空。
- 检查 AI 工具访问权限。 如果工具返回 “tool access is not enabled for this application”: OneSignal 尚未为您的 OneSignal 登录开启 AI 工具访问权限。请联系 OneSignal 支持团队。
- 重启您的 AI 工具并开始新会话。这可以解决大多数暂时性的连接问题。
工具 \
请浏览以下工具。工具发现取决于您的 OneSignal 应用或账户是否启用了 MCP。每个操作还会检查您的 OneSignal 应用权限。应用(2 个工具) \
Journeys(9 个工具) \
使用 MCP 管理 Journeys
构建工具请求、获取 schema,并安全地应用 Journey 更改。
消息(3 个工具) \
要启动或更新 Live Activity,请参阅下方的 Live Activities。
用户和订阅(12 个工具) \
模板(4 个工具) \
细分(4 个工具) \
Live Activities(2 个工具) \
导出(2 个工具) \
自定义事件(2 个工具) \
电子邮件送达率(4 个工具) \
电子邮件预热(5 个工具) \
分析和实用工具(4 个工具) \
安全与防护措施 \
- OneSignal 将
send_message标记为高影响工具,因此遵循工具注解的 AI 工具可能会在运行前要求确认。 send_message会在发送前验证定向:每个请求只能使用一种定向方式,并且筛选条件有数量上限。- OneSignal 会在执行前验证输入,包括标识符、电子邮件地址和电话号码。
- 有关 Journey 并发要求、生命周期控制以及写入结果不确定时的恢复,请参阅 Journey 请求指南。
- OneSignal 按每个 OneSignal 登录开启或关闭 AI 工具访问权限。
- MCP 服务器不会存储您的客户数据(订阅者、消息、导出)。
限制和使用 \
连接 OneSignal 是免费的。每个操作都会计入您正常的 OneSignal API 使用限制。您的 AI 提供商的套餐可能会产生其自身的费用。- 工具调用有速率限制,以防止工具陷入失控循环。
- 连接遵循已登录用户的权限,可以访问该用户能够管理的所有 OneSignal 应用。
- 在实用工具以外的工具可以使用之前,OneSignal 可能需要为您的登录开启 AI 工具访问权限。
FAQ \
我需要 REST API 密钥吗? \
不需要。每个连接都使用 OneSignal OAuth。您通过浏览器登录并批准访问,因此无需复制、存储或轮换 API 密钥。如何使用多个 OneSignal 应用? \
一个连接即可涵盖您的 OneSignal 账户能够管理的所有应用。调用list_apps 查找应用 ID。您不需要为每个应用单独配置。
我可以连接仅支持本地 stdio 服务器的 AI 工具吗? \
不可以。OneSignal MCP 服务器是通过 HTTP 访问的远程服务器。您的 AI 工具必须支持带 OAuth 的远程 MCP 服务器。如何撤销 AI 工具的访问权限? \
在 OneSignal 中前往 Settings > Account settings > Connected apps 并撤销该连接。撤销连接不会影响您队友的连接。相关页面 \
在 Claude 和 ChatGPT 中使用 OneSignal
从 Claude 或 ChatGPT 目录安装 OneSignal。
使用 MCP 管理 Journeys
从您的 MCP 客户端创建草稿、更新 Journey 步骤并管理 Journey 状态。
REST API 概述
OneSignal MCP 服务器所调用端点的参考。
创建消息 API
send_message 背后的端点参考。AI 数据实践
OneSignal 如何为 AI 功能和已连接的 AI 工具处理数据。