用途:该技能用于通过 Membrane CLI 与 Mainstay 客户门户软件交互,管理数据、记录并自动化工作流,适用于需要访问 Mainstay 数据的场景。Mainstay 面向代理机构、顾问及其他服务商,用于集中处理客户互动、项目协作、文件共享与进度跟踪。官方文档地址为 https://docs.mainstay.xyz/。
主要对象:Client(客户)、Project(项目)、Task(任务)、Time Entry(时间条目)、Invoice(发票)。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。
认证:运行 membrane login --tenant --clientName=<agentType>,可能打开浏览器或输出授权 URL;无头环境需手动打开 URL,完成后执行 membrane login complete <code>。agentType 可取 claude、openclaw、codex、warp、windsurf 等,用于适配不同运行环境。
建立连接:membrane connection ensure "https://mainstay.com/" --json,用户在浏览器完成认证后输出连接 id。若状态为 BUILDING,可轮询 npx @membranehq/cli connection get <id> --wait --json 直至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 提示操作(如 connect、provide-input,可能提供 uiUrl 或 agentInstructions);若为 CONFIGURATION_ERROR 或 SETUP_FAILED,检查 error 字段。
查找与执行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema;执行用 membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}' --json,结果位于 output 字段。
代理请求:当动作无法覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接调用 Mainstay API,Membrane 会自动拼接基础 URL 并注入认证头,支持透明凭证刷新。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
限制与注意事项:资料未提供具体功能细节、收费价格、平台支持范围及效果数据。建议优先使用 Membrane 预置动作而非自行编写 API 调用,避免向用户索要 API 密钥,由 Membrane 在服务端管理完整认证生命周期。