技能介绍

它解决什么问题

Zoho Invoice 的 API 覆盖客户、发票、工时记录、催收提醒等操作，但接入过程是碎片化的：OAuth 授权要自己实现，工具的字段名和参数在不同版本间可能变化，多步任务（例如"先找出所有未收款发票，再逐张生成催款提醒"）还要自己编排数据流。这个技能把这部分工作交给 Rube MCP：调用方只负责发起请求，授权、工具发现和批量执行都在 Rube 一侧完成。

核心能力与执行流程

技能的执行链路分为四步：

接入 Rube MCP：在客户端配置中加入 Rube 的 MCP 服务端地址，无需额外申请 API Key。
建立 Zoho Invoice 连接：调用 RUBE_MANAGE_CONNECTIONS 并指定 zoho_invoice 工具包；若状态不是 ACTIVE，按返回的授权链接完成 OAuth 授权后再确认状态。
发现工具：任何流程开始前先调用 RUBE_SEARCH_TOOLS，拿到当前可用的工具 slug、描述、输入 schema、推荐执行顺序以及已知的边界情况。
执行与编排：用 RUBE_MULTI_EXECUTE_TOOL 运行发现到的工具。复杂流程按"先查后写"拆解步骤，把上一步返回值作为下一步输入；批量任务交给 RUBE_REMOTE_WORKBENCH，在其中循环调用 run_composio_tool()，配合 ThreadPoolExecutor 做并行执行。

适用边界与注意点

几个容易踩坑的地方：

不要硬编码 tool slug。可用接口集合会变动，必须先搜索再执行。
连接状态会变。OAuth token 过期后工具会失败，此时应重新走授权流程，而不是盲目重试。
列表接口要处理分页。响应中出现 next_cursor 或 page_token 时需要继续拉取，否则数据不完整。
遵守限流。触发频率限制时降低请求频率并加入退避策略。
严格校验参数。当搜索结果返回 schemaRef 而非 input_schema 时，用 RUBE_GET_TOOL_SCHEMAS 加载完整 schema。
创建前先查重。新建客户或发票前先搜索已有记录，避免产生重复数据。