name: onesignal_rest_api-automation description: “通过Rube MCP(Composio)自动化OneSignal任务:推送通知、分段、模板和消息传递。始终首先搜索工具以获取当前模式。” requires: mcp: [rube]
通过Rube MCP实现OneSignal自动化
通过Composio的OneSignal工具包通过Rube MCP自动化OneSignal操作。
工具包文档: composio.dev/toolkits/onesignal_rest_api
前提条件
- Rube MCP必须已连接(RUBE_SEARCH_TOOLS可用)
- 通过
RUBE_MANAGE_CONNECTIONS使用工具包onesignal_rest_api的活跃OneSignal连接 - 在执行任何工作流之前始终首先调用
RUBE_SEARCH_TOOLS以获取当前工具模式
设置
获取Rube MCP: 在客户端配置中将https://rube.app/mcp添加为MCP服务器。无需API密钥 — 只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证Rube MCP可用 - 使用工具包
onesignal_rest_api调用RUBE_MANAGE_CONNECTIONS - 如果连接不活跃,按照返回的身份验证链接完成设置
- 在执行任何工作流之前确认连接状态显示为活跃
工具发现
在执行工作流之前始终发现可用工具:
RUBE_SEARCH_TOOLS: queries=[{"use_case": "推送通知、分段、模板和消息传递", "known_fields": ""}]
这将返回:
- 用于OneSignal的可用工具 slug
- 推荐的执行计划步骤
- 已知陷阱和边界情况
- 每个工具的输入模式
核心工作流
1. 发现可用的OneSignal工具
RUBE_SEARCH_TOOLS:
queries:
- use_case: "列出所有可用的OneSignal工具和能力"
在执行之前,审查返回的工具、它们的描述和输入模式。
2. 执行OneSignal操作
发现工具后,通过以下方式执行:
RUBE_MULTI_EXECUTE_TOOL:
tools:
- tool_slug: "<discovered_tool_slug>"
arguments: {<schema-compliant arguments>}
memory: {}
sync_response_to_workbench: false
3. 多步骤工作流
对于涉及多个OneSignal操作的复杂工作流:
- 搜索所有相关工具:使用特定用例的
RUBE_SEARCH_TOOLS - 首先执行先决步骤(例如,在更新之前获取)
- 使用工具响应在步骤之间传递数据
- 使用
RUBE_REMOTE_WORKBENCH进行批量操作或数据处理
常见模式
行动前搜索
始终在创建新资源之前搜索现有资源以避免重复。
分页
许多列表操作支持分页。检查响应中的next_cursor或page_token并在耗尽之前继续获取。
错误处理
- 在继续之前检查工具响应中的错误
- 如果工具失败,验证连接是否仍然活跃
- 如果连接过期,通过
RUBE_MANAGE_CONNECTIONS重新身份验证
批量操作
对于批量操作,使用RUBE_REMOTE_WORKBENCH在循环中与ThreadPoolExecutor并行执行run_composio_tool()。
已知陷阱
- 始终首先搜索工具:工具模式和可用操作可能更改。永远不要在没有首先通过
RUBE_SEARCH_TOOLS发现它们的情况下硬编码工具slug。 - 检查连接状态:在执行任何工具之前确保OneSignal连接是活跃的。过期的OAuth令牌需要重新身份验证。
- 尊重速率限制:如果收到速率限制错误,降低请求频率并实现退避。
- 验证模式:始终传递严格符合模式的参数。当返回
schemaRef而不是input_schema时,使用RUBE_GET_TOOL_SCHEMAS加载完整的输入模式。
快速参考
| 操作 | 方法 |
|---|---|
| 查找工具 | 使用OneSignal特定用例的RUBE_SEARCH_TOOLS |
| 连接 | 使用工具包onesignal_rest_api的RUBE_MANAGE_CONNECTIONS |
| 执行 | 使用发现的工具slug的RUBE_MULTI_EXECUTE_TOOL |
| 批量操作 | 使用run_composio_tool()的RUBE_REMOTE_WORKBENCH |
| 完整模式 | 对于带有schemaRef的工具的RUBE_GET_TOOL_SCHEMAS |