name: zoho_invoice-automation description: “通过Rube MCP（Composio）自动化Zoho发票任务：发票、估算、费用、客户和支付跟踪。始终先搜索工具以获取当前模式。” requires: mcp: [rube]
通过Rube MCP实现Zoho发票自动化
通过Composio的Zoho发票工具包通过Rube MCP自动化Zoho发票操作。
工具包文档: composio.dev/toolkits/zoho_invoice
先决条件
- Rube MCP必须连接（RUBE_SEARCH_TOOLS可用）
- 通过
RUBE_MANAGE_CONNECTIONS与工具包zoho_invoice的活跃Zoho发票连接 - 始终先调用
RUBE_SEARCH_TOOLS以获取当前工具模式
设置
获取Rube MCP: 在客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可工作。
- 验证Rube MCP可用，确认
RUBE_SEARCH_TOOLS响应 - 使用工具包
zoho_invoice调用RUBE_MANAGE_CONNECTIONS - 如果连接不活跃，请按照返回的身份验证链接完成设置
- 在运行任何工作流之前，确认连接状态显示为活跃
工具发现
在执行工作流之前始终发现可用工具：
RUBE_SEARCH_TOOLS: queries=[{"use_case": "invoices, estimates, expenses, clients, and payment tracking", "known_fields": ""}]
返回内容：
- Zoho发票的可用工具标识
- 推荐执行计划步骤
- 已知陷阱和边缘情况
- 每个工具的输入模式
核心工作流
1. 发现可用的Zoho发票工具
RUBE_SEARCH_TOOLS:
queries:
- use_case: "列出所有可用的Zoho发票工具和功能"
在执行之前，检查返回的工具、描述和输入模式。
2. 执行Zoho发票操作
发现工具后，通过以下方式执行：
RUBE_MULTI_EXECUTE_TOOL:
tools:
- tool_slug: "<发现的工具标识>"
arguments: {<模式兼容的参数>}
memory: {}
sync_response_to_workbench: false
3. 多步骤工作流
对于涉及多个Zoho发票操作的复杂工作流：
- 搜索所有相关工具：使用特定用例的
RUBE_SEARCH_TOOLS - 先执行先决步骤（例如，在更新之前获取）
- 使用工具响应在步骤之间传递数据
- 使用
RUBE_REMOTE_WORKBENCH进行批量操作或数据处理
常见模式
操作前搜索
在创建新资源之前，始终搜索现有资源以避免重复。
分页
许多列表操作支持分页。检查响应中的next_cursor或page_token，直到获取完毕。
错误处理
- 在继续之前检查工具响应中的错误
- 如果工具失败，验证连接是否仍活跃
- 如果连接过期，通过
RUBE_MANAGE_CONNECTIONS重新身份验证
批量操作
对于批量操作，使用RUBE_REMOTE_WORKBENCH配合ThreadPoolExecutor并行执行run_composio_tool()循环。
已知陷阱
- 始终先搜索工具：工具模式和可用操作可能更改。在通过
RUBE_SEARCH_TOOLS发现之前，切勿硬编码工具标识。 - 检查连接状态：在执行任何工具之前，确保Zoho发票连接活跃。过期的OAuth令牌需要重新身份验证。
- 遵守速率限制：如果收到速率限制错误，减少请求频率并实现退避。
- 验证模式：始终传递严格模式兼容的参数。当返回
schemaRef而不是input_schema时，使用RUBE_GET_TOOL_SCHEMAS加载完整输入模式。
快速参考
| 操作 | 方法 |
|---|---|
| 查找工具 | 使用Zoho发票特定用例的RUBE_SEARCH_TOOLS |
| 连接 | 使用工具包zoho_invoice的RUBE_MANAGE_CONNECTIONS |
| 执行 | 使用发现工具标识的RUBE_MULTI_EXECUTE_TOOL |
| 批量操作 | 使用run_composio_tool()的RUBE_REMOTE_WORKBENCH |
| 完整模式 | 对于带有schemaRef的工具，使用RUBE_GET_TOOL_SCHEMAS |