跳转至

控制 UI 中的 MCP

控制界面有一个专门的 MCP 设置页面,供操作员编辑和快速盘点。

控制界面

浏览器控制界面在 /settings/mcp 下包含一个专门的 MCP 设置页面;之前的 /mcp 路径仍然是别名。该页面显示已配置的服务器数量、已启用/OAuth/筛选器摘要、每个服务器的传输行、启用/禁用控件、常用 CLI 命令,以及一个作用域限定为 mcp 配置部分的编辑器。

如需更简短的设置指南,涵盖设置、Composer 路径(+ → 连接器 → 添加 MCP 服务器…)及其 此会话 / 全局 作用域、CLI 和直接配置,请参阅 连接 MCP 服务器。

请使用此页面进行操作员编辑和快速盘点。当您需要服务器实际运行的证明时,请使用 openclaw mcp doctor --probe 或 openclaw mcp probe。

已启用插件的详情页面会为其声明的 HTTP MCP 服务器显示 账户,这些服务器带有 auth: "oauth"。选择 连接,完成提供商的登录和同意,然后返回 OpenClaw。授权保存后,页面会刷新已保存的状态并显示 已连接。编辑 会打开 MCP 设置页面。登录需要管理员连接。

插件声明在安装并启用后即可直接生效;无需重复的 mcp.servers 条目。显式的 mcp.servers.<name> 条目会覆盖插件的定义,包括使用 enabled: false 来禁用该服务器。

声明了 API 密钥字段的插件还会显示 凭据,包括其环境变量名称。配置 会打开现有的插件设置编辑器,用于配置密钥和机密引用。已配置的密钥会显示勾选标记和 已配置;编辑 会返回该编辑器。这些部分仅在安装后出现,而不会出现在安装前的目录预览中。凭据的存在并不能验证某个密钥或机密引用能否与该服务配合使用。

服务器名称和 URL 必须与插件当前生效的 MCP 声明匹配。此部分不会检查服务健康状况,也不会为未配置的 URL 发现 OAuth。本地 stdio 服务器、按请求方区分的账户,以及 oauth.authProfileId 连接会保留其现有的身份验证设置路径。

操作员工作流:

  1. 打开控制界面并选择 MCP。
  2. 查看摘要卡片,了解总数、已启用、OAuth 和筛选后的服务器。
  3. 使用每个服务器行查看传输、身份验证、筛选器、超时和命令提示信息。
  4. 当您希望保留定义但将其排除在运行时发现之外时,可切换启用状态。
  5. 编辑作用域限定为 mcp 的配置部分,以进行结构性更改,例如新增服务器、标头、TLS、OAuth 元数据或工具筛选器。
  6. 选择 保存 仅持久化配置,或选择 保存并发布 以通过 Gateway 配置路径应用。
  7. 当您需要实际证明编辑后的服务器能够启动并列出工具时,请运行 openclaw mcp doctor --probe。

注意:

  • 命令片段会为服务器名称加引号,因此不常见的名称在 shell 中仍然可以复制。
  • 当显示的类 URL 值包含内嵌凭据时,会在渲染前进行脱敏处理。
  • 该页面本身不会启动 MCP 传输。
  • 活动运行时可能需要执行 openclaw mcp reload、发布 Gateway 配置,或重启进程,具体取决于哪个进程拥有 MCP 客户端。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw