用途:通过 Rube MCP 调用 Composio 的 Square 工具包,自动化 Square 的支付处理、订单管理、发票管理与门店位置查询。工具包文档见 composio.dev/toolkits/square。
前提条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 以 toolkit square 建立有效的 Square 连接;每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
安装:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥。确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit square;若连接非 ACTIVE,按返回的授权链接完成 Square OAuth,确认状态为 ACTIVE 后再执行工作流。
主要能力与用法:
- 支付:SQUARE_LIST_PAYMENTS 查询支付,支持 begin_time/end_time(RFC 3339)、sort_order、cursor、location_id;SQUARE_CANCEL_PAYMENT 取消待处理支付,需精确 payment_id。
- 订单:先 SQUARE_LIST_LOCATIONS 获取 location_ids,再 SQUARE_SEARCH_ORDERS(location_ids 必填,query 支持日期、状态、履约类型),可用 SQUARE_RETRIEVE_ORDER 查看详情、SQUARE_UPDATE_ORDER 修改(需当前 version)。
- 位置:SQUARE_LIST_LOCATIONS 列出所有门店,返回 id、name、address、status、timezone;多数操作依赖 location ID,建议缓存。
- 发票:SQUARE_LIST_INVOICES(需 location_id)、SQUARE_GET_INVOICE、SQUARE_CANCEL_INVOICE(需 invoice_id 与 version)。
常见模式:先解析位置名称到 ID;分页时检查 cursor 并逐页传递直到为空;日期过滤统一使用 RFC 3339 UTC 格式。
限制与注意:时间戳必须为 RFC 3339;仅待处理支付可取消,已完成支付需退款;仅 SCHEDULED、UNPAID、PARTIALLY_PAID 发票可取消且不可撤销;UPDATE_ORDER 与 CANCEL_INVOICE 需当前 version,版本不匹配返回 409;Square API 有速率限制,批量操作需退避;金额以最小货币单位(如美元分)表示;响应可能嵌套在 data 键下。其他未在资料中说明的功能、收费或平台信息暂未提供。