SuperAPI AI 工具集

migrate-mcp-between-projects

部署与运维

查看项目

更新于 11-02 22:48

技能介绍

用途

本技能面向 Speakeasy AI 控制平面(AICP)的 MCP 服务迁移场景:在同一个组织内,把一台由平台托管(platform_managed)的 MCP 服务器,从一个明确的源项目重新创建到另一个明确的目标项目。它只适用于通过已认证的 AICP Platform MCP 接入的外部管理员,不适用于项目内的托管助理;安装本包本身不会授予任何组织或项目权限。

资料明确说明系统不存在“搬移”工具,因此该流程按照用户手动在 AICP 仪表盘中完成时的同等受控路径执行:读取源注册信息,在指定的目标项目中重新加入同一来源,完成安全设置,校验就绪状态,分发到一个确切的目标插件,之后才可选择停用源端。

主要能力

  • 通过 list_projects 获取可用项目,要求用户指定一个源项目和一个不同的目标项目。
  • 通过 find_mcp 仅筛选 model 为 platform_managed 的源 MCP,并通过 get_mcp 校验其注册状态、组件完整性和启用状态。
  • 通过 get_mcp_access 记录源端工具名与角色,通过 get_mcp_client_admission 读取客户端准入模式(可能因权限不可读)。
  • 通过 list_plugins 与 get_plugin 盘点承载该 MCP 的插件、策略与分配集。
  • 在写入前呈现迁移清单,逐项标明哪些属性随注册复制、哪些需用户确认后重建、哪些需用户重新填写、哪些无法复制(如密钥配置、身份提供方绑定与用户授权、端点地址与自定义域名、自定义客户端 ID 元数据 URL、访问角色规则)。
  • 根据 source.kind(reviewed_catalogue 或 user_supplied_url)用 inspect_mcp_candidate 重新推导候选,并仅收集非密钥配置值。
  • 在用户明确确认后,调用 register_catalog_mcp 或 register_remote_mcp 在目标项目注册,注册结果默认为私有且未分发。
  • 通过 get_mcp_readiness 校验就绪;必要时使用 force: true,资料标注强制探测限制为每分钟三次。
  • 按就绪证据路由安全设置:附加身份提供方并给出 authorization_url、引导用户通过连接 URL 完成首次调用、或呈现 dashboard_setup_url 由用户在仪表盘重新输入密钥。
  • 在就绪后对比并对齐客户端准入模式,选择或创建目标插件,必要时镜像插件分配,最后调用 distribute_mcp_to_plugin 完成分发。

使用方式

流程按固定步骤推进:项目发现 → 源 MCP 选择与校验 → 读取访问与准入 → 插件盘点 → 迁移清单确认 → 候选重新推导 → 目标注册 → 就绪检查与安全设置 → 准入对齐 → 插件选择或创建 → 分发 → 可选停用源端。多个步骤要求用户显式确认,写入操作需使用新的幂等键,冲突或拒绝时应返回重新读取并交由用户复核,不得自动重试或更换项目。

适用场景

适用于组织内需要把一台平台托管 MCP 从旧项目迁至新项目的管理员操作,尤其是涉及重新进行身份提供方授权、重新收集非密钥配置、重新选择承载插件的场景。首次添加且无源端的情况,资料建议改用 add-mcp-from-catalog 或 add-mcp-from-remote-url。

限制

  • 仅支持 platform_managed 源;仪表盘托管、托管式、隧道式或旧版服务器无法用这些工具迁移。
  • 源端须为已注册、组件完整、私有且启用状态;已停用或公开的源端应停止并报告,而不是重建。
  • 针对源注册范围的读取与生命周期操作仅对注册该源的管理员可用,若返回 not-found、invalid-request 或 unsupported-target,只能报告不可读并转交仪表盘处理。
  • 密钥、令牌、请求头和 OAuth 状态不得进入对话或工具参数,只能在服务端返回的链接中输入。
  • 自定义客户端 ID 元数据 URL 只能在 AICP 仪表盘中重新添加。
  • 目标注册在插件承载前为私有;在目标实时状态验证且用户确认退役前,不得停用源端。

暂未提供

资料未说明该技能的价格、收费方式、支持的平台范围、界面截图或具体效果数据。