MCP
MCP 窗格用于配置本工作区代理可用的 模型上下文协议 服务器。MCP 服务器让代理能够访问外部工具与上下文——文档索引、问题跟踪器、设计工具、数据库浏览器。你在这里定义每个服务器一次,Bromure Agentic Coding 便会将其转换为每个已启用代理所需的正确配置格式,并在启动时注入虚拟机。
窗格的说明文字概述了整个流程:MCP 服务器让你的代理能够访问外部工具与上下文。配置会被转换为活动代理(Claude Code 或 Codex)所需的正确格式,并在启动时注入虚拟机。 当未配置任何服务器时,显示 未配置 MCP 服务器。
服务器如何交付给代理
你以中立的形式描述每个服务器一次。在会话启动时,bromure 会以每个已启用代理的原生格式将其写出:
- Claude Code — 合并至
~/.claude.json。 - Codex — 以 TOML 块写入
~/.codex/config.toml。 - Grok Build — 合并至 Grok 的用户设置文件。
由于这发生在启动时,添加、编辑或移除服务器会在工作区会话下次启动时生效,而不是在运行中的会话内实时生效。每个服务器都有独立的启用开关,让你可以在文件中保留某个定义的同时,为某次运行将其关闭。
添加服务器
点按 添加服务器 以追加一行。新服务器默认使用 HTTP 传输且处于启用状态。每一行的标题栏包含以下控件:
- 名称 — 服务器的标识符(占位符
my-server)。 - 传输方式 — 一个分段控件,HTTP 或 STDIO。当该行处于 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 / STDIO | HTTP | HTTP = 远程 URL;STDIO = 在虚拟机中启动的命令。在 JSON 模式下隐藏。 |
| 已启用 | 开关(每个服务器) | 开 | 打开或关闭某个服务器而不将其删除。 |
| 以 JSON 编辑 | 切换按钮 | 表单模式 | 将表单替换为直接透传的原始、内联验证的 JSON 配置。 |
| 命令 / 参数 | 文本(STDIO) | 空 | 可执行文件及其以空格分隔的参数。 |
| URL | 文本(HTTP) | 空 | 远程 MCP 端点地址。 |
| 身份验证 | OAuth 代理或静态 bearer 令牌(HTTP) | 无 | OAuth 自动命名为 MCP_OAUTH_<NAME>;静态令牌使用你命名的环境变量。真实令牌保留在宿主机上,并在传输时调换。 |
| 添加服务器 | 按钮 | — | 追加一个新的、启用的 HTTP 服务器行。 |