用途:当需要执行外部应用操作(如发消息、调用 SaaS 接口)且使用 Membrane 时,通过 Membrane CLI 完成认证、连接与执行。仅适用于需要真实执行外部动作的场景,纯讲解、SDK 或直连 API 的实现应交给更窄的厂商技能。
主要能力:CLI 登录后按工作区与客户维度保存凭据于 ~/.membrane/credentials.json;查找、重连或新建外部应用连接,并驱动其到 READY;用 act 执行内联 HTTP 请求、内联 JS 逻辑,或按 key/id 调用已保存的可复用动作;可创建、更新、删除动作,并用 action-run-log 查看运行日志。所有请求经 Membrane 代理并自动注入认证头,含凭据刷新。
使用方式:先执行 npx @membranehq/cli login --tenant 登录;用 connection list、connection ensure 或 connect 获取或创建连接;再用 act --connectionKey <k> --api '<json>'、--code '<js>' 或 --key <k> 执行。新建连接后建议先用内联 api 验证;重复调用才保存为动作。所有命令支持 --json。若 CLI 不可用,可改用 https://api.getmembrane.com 的 API,带 Authorization: Bearer $MEMBRANE_TOKEN。
场景与限制:适合需要统一认证、代理执行多款外部 SaaS 动作的流程。执行模糊、破坏性或不可逆操作前应先向用户确认连接、目标与操作。遇到 CLIENT_ACTION_REQUIRED 应重连而非新建连接,避免产生孤立记录;401 需重新登录;动作失败时根据 actionRunId 拉取日志,不要只凭 HTTP 状态判断。数据会发送至 Membrane,外部应用凭据由 Membrane 服务端存储,仅在信任 Membrane 时使用。