SuperAPI AI 工具集

square-automation

办公与效率

查看项目

更新于 10-16 08:07

技能介绍

用途:通过 Rube MCP 接入 Composio 的 Square 工具包,用自动化方式处理 Square 支付、订单、发票和门店位置等业务操作。

前置条件:需连接 Rube MCP(确保 RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 toolkit square 建立 Square 连接;调用前先执行 RUBE_SEARCH_TOOLS 获取最新的工具 schema。

配置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API key;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit square;若连接非 ACTIVE,按返回的授权链接完成 Square OAuth,确认状态为 ACTIVE 后再运行工作流。

主要能力:

  1. 支付:SQUARE_LIST_PAYMENTS 查询支付记录,SQUARE_CANCEL_PAYMENT 取消待处理支付。支持 begin_time/end_time(RFC 3339)、sort_order、cursor、location_id 等参数。
  2. 订单:先用 SQUARE_LIST_LOCATIONS 取门店 ID,再用 SQUARE_SEARCH_ORDERS 检索,SQUARE_RETRIEVE_ORDER 查看详情,SQUARE_UPDATE_ORDER 修改。订单状态含 OPEN、COMPLETED、CANCELED、DRAFT。
  3. 门店:SQUARE_LIST_LOCATIONS 列出所有门店,返回 id、name、address、status、timezone。
  4. 发票:SQUARE_LIST_INVOICES 列表,SQUARE_GET_INVOICE 查看详情,SQUARE_CANCEL_INVOICE 取消。

常见模式:先做 ID 解析(门店名到门店 ID、订单检索取 order_id);分页时沿 cursor 继续直到缺失;日期过滤统一用 RFC 3339(UTC)。

限制与注意事项:时间戳必须为 RFC 3339;大结果集需分页;仅待处理支付可取消,已完成的需退款;SEARCH_ORDERS 必须提供 location_ids;UPDATE_ORDER 和 CANCEL_INVOICE 需要当前 version 字段,否则可能返回 409;仅 SCHEDULED、UNPAID、PARTIALLY_PAID 发票可取消,取消后不可撤销;Square API 有速率限制,批量操作需退避;金额以最小货币单位表示。其他未在资料中说明的功能或收费情况暂未提供。