用途:通过 Membrane CLI 与 Alegra 云端会计与开票平台交互,管理数据、记录并自动化工作流。适用对象为小微企业主、会计和自由职业者。官方文档:https://developers.alegra.com/
主要能力:围绕客户联系人(Contact)、发票(Invoice)、付款(Payment)、商品(Item)、价格表(Price List)、税(Tax)、分支机构(Branch Office)、用户(User)等实体进行操作。已提供常用动作,包括 list-invoices、list-contacts、list-items、list-bills、list-estimates、list-payments、list-users,以及 create-invoice、create-contact、create-item、create-bill、create-estimate、create-payment、update-invoice、update-contact、update-item、update-estimate、get-invoice、get-contact、get-item 等。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;通过 membrane login --tenant --clientName=<agentType> 登录,无交互环境会输出授权 URL,需用户在浏览器完成登录后用 membrane login complete <code> 完成。建立连接:membrane connection ensure "https://www.alegra.com" --json;若连接处于 BUILDING 状态,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --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 等选项。所有命令加 --json 可获得机器可读输出。
限制:凭据由 Membrane 在服务端管理,不应向用户索要 API 密钥或令牌;认证需要用户在浏览器中完成。具体每个动作的参数与返回结构需通过 action list 查看 inputSchema、outputSchema。定价、平台覆盖范围及其他未在资料中说明的信息暂未提供。