hookdeck-automation

Hookdeck Automation - Hookdeck 自动化操作技能

技能概述

通过 Composio 的 Hookdeck toolkit 和 Rube MCP，实现 Hookdeck webhook 管理的自动化操作，包括工具发现、连接管理和批量工作流执行。

适用场景

1. Webhook 基础设施自动化

自动创建和管理 Hookdeck 连接，批量配置事件源，无需手动操作 Hookdeck 控制台。适合需要频繁创建、更新或监控 webhook 端点的开发团队。

2. 工作流集成

将 Hookdeck 操作集成到更大的自动化流程中，如 CI/CD 管道、事件驱动架构或 DevOps 工作流。通过 Rube MCP 的统一接口，与其他服务和工具无缝衔接。

3. 运维监控与故障处理

自动化查询 Hookdeck 事件日志、监控 webhook 交付状态、配置重试策略。当连接状态异常时，可触发自动恢复流程或告警通知。

核心功能

动态工具发现

通过 RUBE_SEARCH_TOOLS 实时获取当前可用的 Hookdeck 工具列表和参数架构，避免硬编码过时的 API 定义。工具会返回推荐的执行计划和已知注意事项。

连接生命周期管理

使用 RUBE_MANAGE_CONNECTIONS 检查和管理 Hookdeck 连接状态，支持授权链接自动生成和 ACTIVE 状态验证。确保在执行任何操作前连接处于可用状态。

批量工具执行

通过 RUBE_MULTI_EXECUTE_TOOL 一次性执行多个 Hookdeck 操作，支持会话复用和内存管理。适合批量创建连接、配置多个事件源或执行复杂的多步骤工作流。

常见问题

Rube MCP 需要配置 API key 吗？

不需要。Rube MCP 是一个免认证的 MCP 服务，只需将 https://rube.app/mcp 添加到你的 MCP 客户端配置中即可使用。但操作 Hookdeck 时需要通过 RUBE_MANAGE_CONNECTIONS 完成一次性的 Hookdeck 账号授权。

为什么要先调用 RUBE_SEARCH_TOOLS？

Composio 的工具架构会定期更新，硬编码工具名称和参数可能导致调用失败。RUBE_SEARCH_TOOLS 返回的是当前有效的工具 schema，包括推荐的输入格式和已知陷阱，能显著提高自动化脚本的稳定性。

如何处理连接不是 ACTIVE 的情况？

当 RUBE_MANAGE_CONNECTIONS 返回的状态不是 ACTIVE 时，响应中会包含一个授权链接。点击该链接完成 Hookdeck 账号授权后，再次调用 RUBE_MANAGE_CONNECTIONS 确认状态变为 ACTIVE 即可。连接一旦建立，后续会话可复用无需重复授权。