用途:连接任意外部应用并对其执行操作,底层依赖 Membrane CLI。适用于需要与 Slack、Linear、HubSpot、Salesforce 等外部服务交互的场景。
认证:先执行 npx @membranehq/cli login --tenant,或全局安装 npm i -g @membranehq/cli@latest 后用 membrane login --tenant。始终使用 --tenant 获取租户级令牌。凭证本地存储在 ~/.membrane/credentials.json。无交互环境(远程/无头)下会打印授权 URL,用户浏览器完成登录后,用 npx @membranehq/cli login complete <code> 结束登录。
主要流程:1)获取连接:用 connection list --json 查找已有连接;若无则用 search <app> --elementType connector --json 找连接器,或通过 agent-session create --agent connection-building 构建,再用 connect --connectorId <id> 创建连接(非交互加 --non-interactive,并用 connection-request get 轮询状态)。2)获取操作:用 action list --connectionId <id> --intent "..." --json 搜索,若无则用 agent-session create --agent action-building 构建。3)执行操作:action run <actionId> --connectionId <id> --input '{...}' --json,结果在 output 字段。
所有命令支持 --json 输出结构化结果;可用 --workspaceKey、--tenantKey 覆盖默认值。若 CLI 不可用,可直接调用 API(基址 https://api.getmembrane.com,鉴权头 Authorization: Bearer $MEMBRANE_TOKEN),资料中给出了各命令与 API 端点的对应关系。
限制与安全:所有数据经 HTTPS 发送至 Membrane API;外部应用凭证由 Membrane 服务存储而非本地;操作输入输出经 Membrane API 转发至已连接的外部应用。使用即表示数据会发送至 Membrane,仅在信任其访问所连接应用时安装。