SuperAPI AI 工具集

configure-private-mcp-access

部署与运维

查看项目

更新于 11-02 22:48

技能介绍

这是一个面向 Speakeasy AI Control Plane(AICP)的平台操作技能,用于配置已有 MCP 服务器或网关的访问地址和网络访问方式,并确认对应插件包是否已经反映新配置。

用途方面,它只负责修改现有 MCP 服务器(包括托管工具集)或网关的地址与网络模式,不改变上游 URL、插件成员关系或用户权限。托管工具集的地址与网络模式归其规范 MCP 服务器目标所有,需通过该目标修改。

主要能力包括:列出并选择项目与插件,读取连接设置(端点、网络模式、已配置入站、插件成员关系),读取近七日观测到的公有与私有请求量与最后出现时间;在预览中展示变更前后的确切地址或网络模式,并在显式确认后提交变更;随后重新读取设置并检查受影响插件的发布状态(fresh、last_publish、awaiting_manual_sync 等),必要时经确认重新发布插件。

使用方式上,需使用已认证的 AICP Platform MCP,并由管理员选定确切项目、插件和 MCP 服务器或网关。每次变更前都要刷新连接设置,以新版本号和稳定的幂等键发起调用;未带 confirmed: true 时只返回预览,确认后再以相同键与 confirmed: true 提交。变更后重新读取设置,并逐个检查受影响插件的发布证据;若包未刷新且无更新在途、无仓库冲突,管理员可要求重新发布,但需说明会重新生成项目内所有插件。

适用场景是已有 MCP 服务器或网关需要调整访问入口或从公网访问过渡到公私双通、仅私有访问等模式,并希望核实插件包是否使用新地址。限制包括:需要组织访问与网络访问权限,安装插件本身不授予这些权限;托管服务器不能脱离正在使用的自定义域名,自定义域名必须是组织已验证的有效域名;仅私有模式可能中断公有客户端访问,需服务器准入与入站就绪检查,不能只凭 DNS 名称推断就绪;流量统计只在遥测开启期间有效,零请求不能证明路由未被使用。工作流不传输 API 密钥、OAuth 代码、客户端密钥、访问令牌等敏感凭据,也不声称已安装客户端已刷新或 OAuth 会话已重连。