SuperAPI AI 工具集

integration-development

编程与开发

查看项目

更新于 10-16 00:28

技能介绍

用途:该技能用于编写会读写、同步或响应外部应用数据的代码,面向 SaaS 产品、内部工具、脚本和批处理等场景。核心是 Membrane 的五步线性模型:步骤0开发者自身认证;步骤1后端签发 JWT 认证代码,在此决定单租户还是多租户;步骤2在应用 UI 中用 membrane.ui.connect() 创建连接;步骤3通过连接对外部应用调用动作,未知调用目标时可用意图搜索发现;步骤4进阶为通用集成,用通用动作与跨连接逻辑实现厂商无关代码,仅当厂商无关行为是核心产品需求时使用。

主要能力:通过 MCP 或 membrane CLI 进行认证与操作;列出外部应用、目录动作和现有连接;签发租户级与管理工作区级令牌;创建、重连、归档连接;以 api、code、id、key 四种派发方式调用 /act;按意图检索动作;创建、更新、替换、删除工作区级可复用动作;用 actionRunId 查阅运行日志排查失败。

必要用法:

  • 确认会话:membrane status;未登录时 npx @membranehq/cli login
  • 填充凭据:membrane credentials --shell > .env.local
  • 查找应用:membrane external-app list --search <app-name>
  • 列出动作:membrane action list --externalAppId <id>
  • 查看连接:membrane connection list
  • 签发令牌:membrane token(每用户加 --tenantKey <key>,管理操作用 --manager)
  • 首次连接无可匹配项时传 connectorKey(目录级)而非 integrationKey

限制:membrane.ui.connect(...) 必须在浏览器中调用,服务端重定向或 CLI 无法替代;POST /actions 等管理操作需管理令牌,租户令牌会返回 403;目录动作只有 id 没有 key;首次按需构建连接可能耗时并出现 BUILDING 状态,失败时检查 CONFIGURATION_ERROR 或 SETUP_FAILED;Membrane 不直接建模多连接动作,跨连接需自行编排或用 code 派发。资料未提供具体收费与价格信息。