MCP

MCP 窗格用于配置本工作区代理可用的 模型上下文协议 服务器。MCP 服务器让代理能够访问外部工具与上下文——文档索引、问题跟踪器、设计工具、数据库浏览器。你在这里定义每个服务器一次,Bromure Agentic Coding 便会将其转换为每个已启用代理所需的正确配置格式,并在启动时注入虚拟机。

编辑工作区窗口的 MCP 窗格,显示空状态消息“未配置 MCP 服务器”以及一个“添加服务器”按钮

窗格的说明文字概述了整个流程:MCP 服务器让你的代理能够访问外部工具与上下文。配置会被转换为活动代理(Claude Code 或 Codex)所需的正确格式,并在启动时注入虚拟机。 当未配置任何服务器时,显示 未配置 MCP 服务器。

服务器如何交付给代理

你以中立的形式描述每个服务器一次。在会话启动时,bromure 会以每个已启用代理的原生格式将其写出:

  • Claude Code — 合并至 ~/.claude.json
  • Codex — 以 TOML 块写入 ~/.codex/config.toml
  • Grok Build — 合并至 Grok 的用户设置文件。

由于这发生在启动时,添加、编辑或移除服务器会在工作区会话下次启动时生效,而不是在运行中的会话内实时生效。每个服务器都有独立的启用开关,让你可以在文件中保留某个定义的同时,为某次运行将其关闭。

添加服务器

点按 添加服务器 以追加一行。新服务器默认使用 HTTP 传输且处于启用状态。每一行的标题栏包含以下控件:

  • 名称 — 服务器的标识符(占位符 my-server)。
  • 传输方式 — 一个分段控件,HTTPSTDIO。当该行处于 JSON 模式时会被隐藏(见下文)。
  • 启用开关 — 独立地打开或关闭这一个服务器。
  • 以 JSON 编辑 — 一个花括号按钮,将表单替换为原始 JSON 编辑器。你输入的 JSON 会被直接透传给代理配置并进行内联验证;此时该按钮显示为 切换到表单 以返回。
  • 移除 — 减号按钮删除该行。

标题栏下方的字段取决于传输方式。

STDIO 服务器

STDIO 服务器是在虚拟机内启动的一个命令,它通过标准输入与输出讲 MCP。两个字段:

  • 命令 — 可执行文件(占位符 npx)。
  • 参数 — 以空格分隔的参数(占位符 -y @upstash/context7-mcp)。

HTTP 服务器

HTTP 服务器是一个远程 MCP 端点。其 URL 字段填入服务器地址(占位符 https://mcp.example.com/mcp),一个 身份验证 展开区块保存凭据。有两种身份验证方式,两者都将真实令牌保留在宿主机上——虚拟机始终只持有一个假令牌,由限定在该服务器主机范围内的代理服务器在传输时进行调换:

  • 使用 OAuth 授权… — 运行一个宿主机侧的 OAuth 代理。一旦授权成功,该行会显示 已授权 及过期时间(“expires …”)以及 重新授权 / 撤销 按钮,令牌的环境变量会被自动命名为 MCP_OAUTH_<NAME>
  • 静态令牌 — 在“或输入静态令牌:”下方,设置一个 环境变量名(例如 FIGMA_OAUTH_TOKEN),并将 令牌 粘贴到安全字段中。该令牌字段的说明为 绝不发送至虚拟机——由代理服务器调换

对于携带 bearer 令牌的 HTTP 服务器,代理服务器还会响应服务器主机的 OAuth 发现路径,从而让虚拟机内的代理将该服务器视为已预先授权,不会尝试其自身的(在虚拟机内无法完成的)OAuth 流程。bearer 令牌的调换连同其他凭据类别一起记录在 凭据与传输边界 中。

MCP 服务器与应用自身的自动化服务器

有两个不同的事物共用了“MCP”这几个字母,值得将它们区分开来:

  • 本窗格 配置的是 虚拟机内的代理 作为工具消费的 MCP 服务器。
  • 应用的 自动化 功能暴露了一个 MCP 服务器,让 外部 代理能够驱动 Bromure Agentic Coding 本身(打开工作区、管理会话)。那是 bromure-cli mcp 子命令,在 自动化 窗格中配置,并记录在 自动化与 CLI 中。

设置参考

设置类型默认值说明
服务器列表服务器行的列表每个服务器都有名称、传输方式、启用开关以及一个 JSON 编辑器切换。
传输方式分段:HTTP / STDIOHTTPHTTP = 远程 URL;STDIO = 在虚拟机中启动的命令。在 JSON 模式下隐藏。
已启用开关(每个服务器)打开或关闭某个服务器而不将其删除。
以 JSON 编辑切换按钮表单模式将表单替换为直接透传的原始、内联验证的 JSON 配置。
命令 / 参数文本(STDIO)可执行文件及其以空格分隔的参数。
URL文本(HTTP)远程 MCP 端点地址。
身份验证OAuth 代理或静态 bearer 令牌(HTTP)OAuth 自动命名为 MCP_OAUTH_<NAME>;静态令牌使用你命名的环境变量。真实令牌保留在宿主机上,并在传输时调换。
添加服务器按钮追加一个新的、启用的 HTTP 服务器行。

相关章节

  • 自动化与 CLI — 应用自身的 MCP 服务器(bromure-cli mcp),用于从外部代理驱动 Bromure Agentic Coding。
  • 凭据与传输边界 — HTTP MCP bearer 令牌如何保留在宿主机上并在传输时调换。
  • 代理 — 哪些代理已启用、哪个为主代理;每个代理在启动时都会收到转换后的 MCP 配置。
  • 设置参考 — 一览所有窗格。