用途:Ramp 是公司卡与费用管理平台,企业用它自动化费用报销、控制支出并管理财务。本技能用于通过 Membrane CLI 与 Ramp 交互,涉及组织、员工、费用、卡片、交易、账单、报销、报告等数据类型。
主要能力:借助 Membrane 完成 Ramp 的认证与凭据自动刷新,支持按自然语言意图搜索预置 action、运行 action,以及在 action 不覆盖时通过代理直接请求 Ramp API。
安装与认证: 安装 CLI:npm install -g @membranehq/cli@latest 登录:membrane login --tenant --clientName=<agentType>(agentType 可为 claude、openclaw、codex、warp、windsurf 等)。无头环境下命令会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任意命令加 --json 可输出机器可读 JSON。
连接 Ramp: membrane connection ensure "https://ramp.com" --json 若返回状态为 BUILDING,可执行 npx @membranehq/cli connection get <id> --wait --json 轮询直至就绪。状态说明:READY 可直接使用;CLIENT_ACTION_REQUIRED 需按 clientAction 的 connect 或 provide-input 处理;CONFIGURATION_ERROR 或 SETUP_FAILED 需检查 error。
搜索与运行 action: membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json membrane action run <actionId> --connectionId=CONNECTION_ID --json 传参:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。
代理请求:membrane request CONNECTION_ID /path/to/endpoint,可用 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
适用场景:查询或管理 Ramp 的企业卡、交易、费用、报销、账单、预算、审批等数据。
限制与暂未提供:官方文档为 https://ramp.com/developer/api。本资料未说明具体收费、价格、平台覆盖范围、效果或各 action 的完整参数细节,这些暂未提供;使用前建议先搜索已有 action 再决定是否自定义请求。切勿向用户索要 API key 或 token,应由 Membrane 管理凭据。