用途:仅通过已认证的 Speakeasy AI Control Plane(AICP)Platform MCP,把经审核的目录 MCP 服务器加入一个明确的 AICP 项目,流程与在 AICP 面板手动操作一致:选择经审核的 MCP、为指定项目配置、完成安全设置并验证就绪。该包本身不授予任何组织访问权限。若用户提供的是审核目录之外的远程 MCP URL,应改用 add-mcp-from-remote-url 工作流。
主要能力与用法:先调用 list_projects 验证认证并获取可用项目;若无法认证发现,应停止并让用户修复 AICP OAuth,不得声称安装成功。调用 search_mcp_catalog,让用户选定唯一项目和唯一候选。调用 inspect_mcp_candidate 说明变更并收集其中声明的非机密配置字段。用户确认后调用 register_catalog_mcp 传入选定项目、候选、非机密配置和新的幂等键,且不分发。再调用 get_mcp_readiness 检查持久化就绪状态。
安全设置:遇 upstream_identity_provider_not_configured 时,说明 AICP 可附加发现的身份提供商,确认后调用 attach_platform_mcp_identity_provider 并展示其 Inspect 授权 URL,等待用户完成 Connect 或 Authorize。遇 upstream_authorization_required 时,再次调用同一工具获取当前授权 URL 并展示。其他安全设置结果只展示服务器返回的精确设置 URL,OAuth 或密钥输入在代理外完成,绝不索要验证码、令牌或密钥。完成后,已连接的外部客户端调用 get_mcp_readiness 并带 force: true;受管项目助手不带 force,仅报告持久化证据。
限制:注册私有,只有插件承载后才生效。调用 get_mcp_client_admission 报告模式及自定义客户端 ID 元数据 URL;仅在用户要求时用 set_mcp_client_admission 更改并确认。已知客户端(预设)会拒绝未列出的客户端且无回退。调用 list_plugins 由用户指定承载插件,再调用 distribute_mcp_to_plugin;名称无匹配返回 not_found、匹配多个返回 ambiguous_target,应如实报告并再次询问,不得改选、新建插件或分发到其他项目。安全规则禁止索要或粘贴任何密钥、令牌、OAuth 码、客户端密钥、机密标头或 MCP 凭据,禁止让用户提供 MCP 端点。send_platform_mcp_feedback 须先征得同意,且不得包含标识符、URL、凭据、载荷、标头、日志或附件。