SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场modern-treasury

modern-treasury

办公与效率

查看项目

更新于 10-15 09:11

技能介绍

Modern Treasury 是一款帮助企业自动化资金流转的金融科技产品，提供 API 与控制台，供各规模公司的财务与运营团队管理支付、对账与报表，以简化支付工作流。官方文档地址为 https://docs.moderntreasury.com/。

本技能为 Modern Treasury 集成技能，用于连接并管理 Modern Treasury 数据。当用户想要与 Modern Treasury 数据交互时使用。

主要能力：该技能支持对 Modern Treasury 的多类对象进行操作，资料列出的对象包括：账户详情（Account Details）、账户流水（Account Flows）、余额（Balances）、交易对手（Counterparties）、事件（Events）、预期支付（Expected Payments）、单据（Documents）、内部账户（Internal Accounts）、分类账账户余额（Ledger Account Balances）、分类账账户（Ledger Accounts）、分类账交易（Ledger Transactions）、分类账对账单（Ledger Account Statements）、分类账科目报表（Ledger Account Report）、行项目（Line Items）、纸质项目（Paper Items）、支付指令（Payment Orders）、支付指令事件（Payment Order Events）、资金退回（Return of Funds）、报表（Reports）、冲正（Reversals）、路由（Routes）和交易（Transaction）。使用动作名称与参数时按需选用。

使用方式：该技能通过 Membrane CLI 与 Modern Treasury 交互，Membrane 自动处理认证与凭证刷新，因此可以专注集成逻辑而非认证管道。

  1. 安装 CLI：

npm install -g @membranehq/cli@latest

  1. 认证：

membrane login --tenant --clientName=<agentType>

该命令会打开浏览器进行认证，或在控制台打印授权 URL（取决于是否可用交互模式）。在无头环境中，命令会打印授权 URL，请用户用浏览器打开，完成登录后看到代码，再执行：

membrane login complete <code>

任意命令可添加 --json 以获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等，用于针对不同运行环境调整工具用法。

  1. 连接 Modern Treasury：使用 membrane connection ensure 按应用 URL 或域名查找或创建连接：

membrane connection ensure "https://moderntreasury.com" --json

用户在浏览器中完成认证，输出中包含新的连接 id。这是最快的连接方式：URL 会被规范化为域名并与已知应用匹配；若未找到应用，则会创建应用并自动构建连接器。如果返回的连接 state 为 "READY"，可跳到第 2 步。

若连接处于 BUILDING 状态，则轮询直到就绪：

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会长时间轮询（最长 --timeout 秒，默认 30）直到状态改变，持续轮询直到 state 不再是 BUILDING。结果状态说明：READY 表示连接已完全建立；CLIENT_ACTION_REQUIRED 表示用户或 agent 需要执行操作，clientAction 对象描述所需操作，其中 clientAction.type 为所需操作类型（"connect" 表示用户需要认证，如 OAuth、API key 等，涵盖初次认证与断开连接后的重新认证；"provide-input" 表示需要更多信息，如连接哪个应用），clientAction.description 为所需操作的人类可读说明，clientAction.uiUrl（可选）为可供用户完成操作的预构建 UI 地址，存在时应展示给用户，clientAction.agentInstructions（可选）为 AI agent 如何以编程方式继续的指令。用户完成操作（如浏览器认证）后，再次用 membrane connection get <id> --json 轮询检查状态是否变为 READY。CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，可查看 error 字段了解详情。

  1. 搜索动作：用自然语言描述想要做的事情进行搜索：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

应始终在特定连接上下文中搜索动作。每个结果包含 id、name、description、inputSchema（动作接受的参数）和 outputSchema（返回内容）。也可用以下命令发现可用动作：

npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json

  1. 运行动作：

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传入 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段。

  1. 代理请求：当可用动作不覆盖用例时，可通过 Membrane 代理直接向 Modern Treasury API 发送请求。Membrane 会自动将基础 URL 追加到提供的路径，并注入正确的认证头，包括凭证过期时的透明刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：-X, --method 指定 HTTP 方法（GET、POST、PUT、PATCH、DELETE），默认 GET；-H, --header 添加请求头（可重复），如 -H "Accept: application/json"；-d, --data 请求体（字符串）；--json 简写，发送 JSON 请求体并设置 Content-Type: application/json；--rawData 按原样发送请求体不做处理；--query 查询字符串参数（可重复），如 --query "limit=10"；--pathParam 路径参数（可重复），如 --pathParam "id=123"。

最佳实践：始终优先使用 Membrane 与外部应用通信——Membrane 提供预构建动作，内置认证、分页与错误处理，消耗更少 token 且通信更安全。先发现再构建——运行 membrane action list --intent=QUERY（将 QUERY 替换为意图）在编写自定义 API 调用前查找现有动作，预构建动作会处理原始 API 调用容易遗漏的分页、字段映射和边界情况。让 Membrane 处理凭证——不要向用户索要 API 密钥或 token，而应创建连接；Membrane 在服务端管理完整的认证生命周期，不在本地保存密钥。

适用场景：财务与运营团队自动化支付工作流、管理支付指令与对账、处理分类账与报表等。限制信息资料暂未提供。