build-product-integrations

用途：为产品添加第三方集成，让客户连接外部应用、代为执行操作、同步数据，或提供 AI 智能体工具。Membrane 是集成引擎，负责认证、API 调用与数据转换。核心概念包括 Workspace、Customer、Connector、Integration、Connection、Action、Data Collection、Flow；元素分 Universal、Integration、Connection 三层。认证使用 JWT：Workspace Key 作为 iss，Workspace Secret 用于签名（不得暴露给前端），后端按客户生成 Customer Token。遵循搜索→使用→委托流程：先用意图搜索查找所需元素，存在则直接使用，不存在则交给 Membrane Agent 创建，不要自己构建。开发可用 npx @membranehq/cli login --tenant；无浏览器时用 npx @membranehq/cli login complete <code>；生产环境由后端生成令牌。应用中可通过 @membranehq/sdk、@membranehq/react 或 REST API（https://api.getmembrane.com）接入，连接 UI 使用 https://ui.integration.app/embed/integrations/{INTEGRATION_KEY}/connect?token={TOKEN}，MCP 服务器为 https://mcp.integration.app/sse?token={TOKEN}&productKey={PRODUCT_KEY}。运行操作可用 npx @membranehq/cli action list --connectionId <id> --intent "..." --json 与 npx @membranehq/cli action run <actionId> --connectionId <id> --json。适合需要第三方集成的产品与 AI 智能体工具场景。限制：必须遵循委托原则；连接断开需重连；操作失败可能因缺失输入、限流或权限不足；资料未提供收费与价格信息。