Control UI 中的 MCP
控制台 UI 有一个专用的 MCP 设置页面,用于操作员编辑和快速盘点。
控制台 UI¶
浏览器控制台 UI 在 /settings/mcp 包含一个专用的 MCP 设置页面;之前的 /mcp 路径仍保留为别名。该页面显示已配置服务器数量、启用/OAuth/过滤摘要、按服务器划分的传输行、启用/禁用控件、常用 CLI 命令,以及针对 mcp 配置段的范围编辑器。
如需更简短的设置指南,涵盖设置、编辑器路径(+ → 连接器 → 添加 MCP 服务器…)及其 此会话 / 所有位置 范围、CLI 和直接配置,请参阅 连接 MCP 服务器。
将该页面用于操作员编辑和快速盘点。当需要实时服务器验证时,使用 openclaw mcp doctor --probe 或 openclaw mcp probe。
已安装插件详情页会优先为匹配的 HTTP MCP 服务器显示 账户,这些服务器配置了 auth: "oauth"。 连接 会打开现有 OAuth 流程;之后页面会刷新其已保存状态。已保存的授权显示对勾和 已连接,编辑 会打开现有 MCP 设置页面。登录需要管理员连接。
声明了 API 密钥字段的插件还会显示 凭据,包括其环境变量名称。 配置 会打开现有插件设置编辑器,用于密钥和密钥引用。已配置的密钥显示对勾和 已配置,编辑 会返回该编辑器。这些部分仅在安装后出现,不会出现在安装前的目录预览中。凭据的存在并不能验证密钥或密钥引用是否可与服务配合使用。
服务器名称和 URL 必须与插件当前生效的 MCP 声明匹配。此部分不会探测服务健康状况,也不会为未配置的 URL 发现 OAuth。本地 stdio 服务器、按请求者划分的账户以及 oauth.authProfileId 连接保留其现有身份验证设置路径。
操作员工作流:
- 打开控制台 UI 并选择 MCP。
- 查看摘要卡片,了解服务器总数、已启用服务器、OAuth 服务器和已过滤服务器。
- 使用每个服务器行查看传输、身份验证、过滤、超时和命令提示。
- 当你想保留定义但将其排除在运行时发现之外时,切换启用状态。
- 编辑范围限定的
mcp配置段,进行结构性更改,例如新服务器、请求头、TLS、OAuth 元数据或工具过滤器。 - 选择 保存 仅持久化配置,或选择 保存并发布 通过 Gateway 配置路径应用。
- 当需要实时验证已编辑的服务器能够启动并列出工具时,运行
openclaw mcp doctor --probe。
说明:
- 命令片段会为服务器名称添加引号,以便不寻常的名称在 shell 中仍可复制
- 显示的类似 URL 的值在包含嵌入凭据时会在渲染前被脱敏
- 该页面本身不会启动 MCP 传输
- 活动运行时可能需要
openclaw mcp reload、Gateway 配置发布或进程重启,具体取决于哪个进程拥有 MCP 客户端
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw