用途:连接任意外部应用并对其执行操作,依赖 Membrane CLI,适用于需要与 Slack、Linear、HubSpot、Salesforce 等外部服务交互的场景。
认证:使用 npx @membranehq/cli login --tenant 登录,也可全局安装 npm i -g @membranehq/cli@latest 后执行 membrane login --tenant。始终加 --tenant 获取租户级令牌,避免后续每条命令传递 workspaceKey 和 tenantKey。交互模式会打开浏览器,否则在控制台输出授权 URL;无浏览器时用 npx @membranehq/cli login complete <code> 完成。凭据存于 ~/.membrane/credentials.json 并自动复用。所有命令可加 --json 获得机器可读输出。
工作流:先获取连接。用 npx @membranehq/cli connection list --json 查找已存在连接(关注 id、name、connectorId、disconnected);若无,用 npx @membranehq/cli search slack --elementType connector --json 查找连接器;若仍无,用 npx @membranehq/cli agent-session create --agent connection-building --message "..." --json 构建,并以 npx @membranehq/cli agent-session get <sessionId> --wait --json 轮询至 idle。创建连接用 npx @membranehq/cli connect --connectorId <connectorId>,非交互时加 --non-interactive 并轮询 npx @membranehq/cli connection-request get abc123 --json。第二步获取动作:npx @membranehq/cli action list --connectionId abc123 --intent "send a message" --limit 10 --json;无合适动作则用 action-building agent 构建后重新搜索。第三步运行:npx @membranehq/cli action run <actionId> --connectionId abc123 --input '{"channel":"#general","text":"Hello!"}' --json,结果在 output 字段。
CLI 还提供 connection get、connection-request create、agent-session list/get/send/abort/messages 等命令。CLI 不可用时可直接调用 https://api.getmembrane.com,认证头为 Authorization: Bearer $MEMBRANE_TOKEN,对应关系见资料中的命令到 API 映射表。
限制与隐私:所有请求发往 Membrane API,不直接联系其他外部服务;数据经 HTTPS 传输,CLI 凭据本地存储于 ~/.membrane/,外部应用凭据由 Membrane 服务保存。仅信任 Membrane 可访问所连应用时再安装。资料中未提供收费、价格或效果信息。