---

name: square-automation description: "通过Rube MCP（Composio）自动化Square任务：支付、订单、发票、门店。始终先搜索工具以获取当前schema。" risk: critical source: community date_added: "2026-02-27"

通过Rube MCP实现Square自动化

通过Composio的Square工具包经由Rube MCP自动化Square支付处理、订单管理和发票开具。

前置条件

• 必须连接Rube MCP（RUBE_SEARCH_TOOLS可用）
• 通过RUBE_MANAGE_CONNECTIONS使用toolkit square建立活跃的Square连接
• 始终先调用RUBE_SEARCH_TOOLS获取当前工具schema

设置

获取Rube MCP：在客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可使用。

1. 确认RUBE_SEARCH_TOOLS响应以验证Rube MCP可用
2. 使用toolkit square调用RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接完成Square OAuth
4. 在运行任何工作流之前确认连接状态显示ACTIVE

核心工作流

1. 列出和监控支付

使用场景：用户想查看支付历史或检查支付状态

工具调用序列：

1. SQUARE_LIST_PAYMENTS - 使用可选过滤器检索支付记录 [必需]
2. SQUARE_CANCEL_PAYMENT - 如需要则取消待处理的支付 [可选]

关键参数：

• begin_time / end_time：RFC 3339时间戳用于日期范围过滤
• sort_order：'ASC'或'DESC'用于时间排序
• cursor：上一响应的分页游标
• location_id：按特定门店过滤支付

注意事项：

• 时间戳必须是RFC 3339格式（例如'2024-01-01T00:00:00Z'）
• 大结果集需要分页；跟随cursor直到不存在
• 只有待处理的支付可以取消；已完成的支付需要退款
• SQUARE_CANCEL_PAYMENT需要列表结果中的精确payment_id

2. 搜索和管理订单

使用场景：用户想按条件查找订单或更新订单详情

工具调用序列：

1. SQUARE_LIST_LOCATIONS - 获取用于过滤的门店ID [前置条件]
2. SQUARE_SEARCH_ORDERS - 使用过滤器搜索订单 [必需]
3. SQUARE_RETRIEVE_ORDER - 获取特定订单的完整详情 [可选]
4. SQUARE_UPDATE_ORDER - 修改订单状态或详情 [可选]

关键参数：

• location_ids：要搜索的门店ID数组（搜索时必需）
• query：包含日期范围、状态、履行类型的搜索过滤对象
• order_id：用于检索/更新操作的特定订单ID
• cursor：搜索结果的分页游标

注意事项：

• location_ids对于SEARCH_ORDERS是必需的；先从LIST_LOCATIONS获取ID
• 订单状态包括：OPEN、COMPLETED、CANCELED、DRAFT
• UPDATE_ORDER需要当前version字段以防止冲突
• 搜索结果是分页的；跟随cursor直到不存在

3. 管理门店

使用场景：用户想查看商业门店或获取门店详情

工具调用序列：

1. SQUARE_LIST_LOCATIONS - 列出所有商业门店 [必需]

关键参数：

• 无必需参数；返回所有可访问的门店
• 响应包括id、name、address、status、timezone

注意事项：

• 大多数其他Square操作（订单、支付）需要门店ID
• 首次检索后始终缓存门店ID以避免冗余调用
• 非活跃门店可能仍出现在结果中；检查status字段

4. 发票管理

使用场景：用户想列出、查看或取消发票

工具调用序列：

1. SQUARE_LIST_LOCATIONS - 获取用于过滤的门店ID [前置条件]
2. SQUARE_LIST_INVOICES - 列出某门店的发票 [必需]
3. SQUARE_GET_INVOICE - 获取详细发票信息 [可选]
4. SQUARE_CANCEL_INVOICE - 取消已计划或未付款的发票 [可选]

关键参数：

• location_id：列出发票时必需
• invoice_id：获取/取消操作时必需
• cursor：列表结果的分页游标
• limit：每页结果数量

注意事项：

• location_id对于LIST_INVOICES是必需的；通过LIST_LOCATIONS解析
• 只有SCHEDULED、UNPAID或PARTIALLY_PAID状态的发票可以取消
• CANCEL_INVOICE需要发票version以防止竞态条件
• 已取消的发票无法恢复

常见模式

ID解析

门店名称 -> 门店ID：

1. Call SQUARE_LIST_LOCATIONS
2. Find location by name in response
3. Extract id field (e.g., 'L1234ABCD')

订单查找：

1. Call SQUARE_SEARCH_ORDERS with location_ids and query filters
2. Extract order_id from results
3. Use order_id for RETRIEVE_ORDER or UPDATE_ORDER

分页

• 检查响应中的cursor字段
• 在下一个请求的cursor参数中传递cursor值
• 继续直到cursor不存在或为空
• 使用limit控制页面大小

日期范围过滤

• 使用RFC 3339格式