用途:本技能用于把用户自带的远程 MCP 服务器 URL 接入 AICP 项目,仅在通过认证的 Speakeasy AI Control Plane Platform MCP 中运行。若目标已在审核目录中,应改用 add-mcp-from-catalog。该包本身不授予任何组织访问权限。
主要能力与流程:先用 list_projects 确认已认证并获取可用项目;先按名称用 search_mcp_catalog 查目录,优先选已审核条目;再用 inspect_mcp_candidate(remote_url)做唯一只读检查,返回有限证据,不做注册或分发。注册前需向用户展示返回的 URL、传输方式、工具数量与名称、认证态势、配置要求、OAuth 发现状态,缺少证据要如实说明。用户明确确认该 URL 与该具体项目后,调用 register_remote_mcp(项目、URL、可选安全显示名、新幂等键)进行私有注册。随后用 get_mcp_readiness 查看持久化的角色范围证据;新注册通常返回 readiness_unavailable,并非停止理由。若检查为 authentication_required,需确认后调用 attach_platform_mcp_identity_provider 并展示授权 URL;若为 anonymous 则跳过。外部客户端场景按 secure_dashboard_setup_required 展示 dashboard_setup_url,配置完成后以 force: true 重查就绪状态。最后用 get_mcp_client_admission 报告准入模式,改动需用户申请并明确确认后调用 set_mcp_client_admission。
安全限制:绝不能让用户在聊天中粘贴 API 密钥、密码、令牌、OAuth 码、客户端密钥、秘密头或 MCP 凭据;认证与请求头只在 AICP 仪表盘安全配置中完成。项目必须显式指定,不得从历史对话推断或替换。注册是私有的,在就绪成功且精确插件分发开放前不得声称对用户可用。仅在工具返回时展示非秘密的配置与授权链接。反馈仅在征得同意后调用,且不得包含任何标识、URL、凭据、负载、请求头、日志或附件。
适用场景:将未经审核目录收录的用户自有远程 MCP 服务器私有接入指定 AICP 项目并验证可用性。限制:必须依赖已认证的 AICP Platform MCP,无法确定就绪时不得伪造证据,注册不公开分发。