loyverse-automation

Loyverse Automation - Rube MCP 集成指南

技能概述

通过 Rube MCP 和 Composio 工具包自动化 Loyverse 操作，无需 API 密钥即可实现库存管理、订单处理等工作流自动化。

适用场景

1. 库存与订单自动化处理

适合需要自动更新库存状态、批量处理订单的零售和餐饮商户。通过 RUBE_MULTI_EXECUTE_TOOL 可以一次性执行多个 Loyverse 操作，减少手动录入错误并提升处理效率。

2. 工作流集成与定制

适合开发者将 Loyverse 嵌入到更大的业务流程中，例如与 CRM 系统、财务软件或自定义仪表板集成。使用 RUBE_REMOTE_WORKBENCH 可在 Python 环境中灵活编排复杂的跨系统操作。

3. 快速原型与测试

适合无需申请正式 API 凭据即可探索 Loyverse 集成可能性的场景。只需在客户端配置中添加 Rube MCP 端点 https://rube.app/mcp 即可开始使用。

核心功能

1. 动态工具发现与模式验证

通过 RUBE_SEARCH_TOOLS 始终获取最新的工具模式、推荐执行计划和已知陷阱。该功能确保自动化脚本在工具 API 更新后仍能正常工作，避免因硬编码工具 slug 或参数导致的运行失败。

2. 连接状态管理

RUBE_MANAGE_CONNECTIONS 提供实时的 Loyverse 连接状态检查，在执行任何操作前验证连接是否为 ACTIVE。支持通过返回的认证链接完成首次授权，确保工作流在正确的连接状态下执行。

3. 灵活的执行模式

单步执行: 使用 RUBE_MULTI_EXECUTE_TOOL 传递已发现的工具 slug 和模式合规的参数

批量操作: 使用 RUBE_REMOTE_WORKBENCH 调用 run_composio_tool() 进行大规模数据处理

完整模式: 使用 RUBE_GET_TOOL_SCHEMAS 获取带有 schemaRef 工具的完整输入输出定义

常见问题

Loyverse Automation 如何无需 API 密钥工作？

Rube MCP 提供了一个中间层，您只需在客户端配置中添加 MCP 服务器端点 https://rube.app/mcp。连接到 Loyverse 时，RUBE_MANAGE_CONNECTIONS 会返回认证链接，完成首次授权后即可使用。无需单独申请 API 密钥或管理凭据。

工具模式会变化吗，为什么每次都要搜索？

是的，Composio 维护的工具包会定期更新以支持新的 Loyverse 功能。RUBE_SEARCH_TOOLS 不仅返回当前可用的工具列表和 slug，还包含输入模式、推荐执行计划和已知陷阱。始终调用此步骤可确保自动化脚本在 API 更新后继续正常工作。

批量执行 Loyverse 操作如何实现？

两种方式：一是使用 RUBE_MULTI_EXECUTE_TOOL 的 tools 数组参数，一次传递多个工具调用；二是使用 RUBE_REMOTE_WORKBENCH 在 Python 环境中编写循环逻辑，反复调用 run_composio_tool() 处理大量数据。注意在处理大量操作时检查响应中的分页标记。