timely-automation

Timely Automation - 通过 Rube MCP 自动化时间追踪任务

技能概述

Timely Automation 技能通过 Composio 的 Timely 工具包和 Rube MCP，让您无需 API 密钥即可自动化执行各种 Timely 时间追踪操作，包括时间记录创建、项目管理和批量任务处理。

适用场景

自动化时间记录创建

当您需要根据事件自动创建 Timely 时间记录时，此技能可以帮助您通过 MCP 接口自动执行时间记录创建，无需手动操作或配置复杂的 API 密钥。

批量处理 Timely 数据

当您需要对多个项目、任务或时间记录进行批量操作时，通过 RUBE_REMOTE_WORKBENCH 和 run_composio_tool() 方法，可以高效地批量执行 Timely 操作。

集成到 MCP 工作流

当您正在使用 MCP（Model Context Protocol）构建自动化工作流，并需要将 Timely 时间追踪功能集成到现有系统中时，此技能提供了完整的工具发现、连接管理和执行能力。

核心功能

智能工具发现

通过 RUBE_SEARCH_TOOLS 自动发现当前可用的 Timely 工具及其输入架构，确保始终使用最新的工具定义，避免因架构变更导致的执行失败。此功能返回工具标识符、推荐执行计划和已知注意事项。

连接状态管理

使用 RUBE_MANAGE_CONNECTIONS 实时检查和管理 Timely 连接状态，确保在执行任何自动化任务前连接处于活动状态，提供清晰的认证引导和状态反馈。

灵活工具执行

通过 RUBE_MULTI_EXECUTE_TOOL 执行已发现的 Timely 工具，支持架构合规的参数传递、会话重用和内存管理，适用于从单次操作到复杂工作流的各种执行场景。

常见问题

如何配置 Rube MCP 来连接 Timely？

只需在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器即可，无需任何 API 密钥。添加后，通过 RUBE_SEARCH_TOOLS 验证连接可用性，然后使用 RUBE_MANAGE_CONNECTIONS 配置工具包为 timely 并完成认证流程。

Rube MCP 需要什么 API 密钥吗？

不需要。Rube MCP 采用无密钥设计，您只需添加 MCP 服务器端点即可使用。所有认证流程通过 RUBE_MANAGE_CONNECTIONS 返回的认证链接完成，简化了配置过程。

为什么每次执行前都要调用 RUBE_SEARCH_TOOLS？

Composio 工具的工具架构可能会随时变更。硬编码工具标识符或参数会导致执行失败。RUBE_SEARCH_TOOLS 始终返回当前有效的工具定义、输入架构和推荐执行计划，这是确保自动化稳定运行的关键步骤。

如何验证 Timely 连接是否处于活动状态？

调用 RUBE_MANAGE_CONNECTIONS 并指定工具包为 timely，检查返回的连接状态。如果状态不是 ACTIVE，请按照返回的认证链接完成设置，确认状态变为 ACTIVE 后再执行任何工作流。

批量操作 Timely 数据的最佳实践是什么？

使用 RUBE_REMOTE_WORKBENCH 配合 run_composio_tool() 方法进行批量操作。在执行前务必通过 RUBE_SEARCH_TOOLS 获取正确的工具架构，并在整个批量操作过程中重用同一会话 ID 以保持上下文连续性。

RUBE_MULTI_EXECUTE_TOOL 的 memory 参数是做什么的？

memory 参数用于在工具执行之间传递和存储上下文信息。即使您当前没有需要存储的数据，也必须包含此参数（可以设置为空对象 {}），这是工具执行的要求之一。