MCP
MCP 窗格用來設定此工作區的代理程式可使用的 Model Context Protocol 伺服器。MCP 伺服器讓代理程式能存取外部工具與情境資訊,例如文件索引、問題追蹤系統、設計工具或資料庫瀏覽器。你在此處為每部伺服器定義一次,Bromure Agentic Coding 會將其翻譯成每個啟用之代理程式所需的正確設定格式,並於開機時注入 VM。
窗格的說明文字概述了整個流程:MCP 伺服器讓你的代理程式能存取外部工具與情境資訊。設定會被翻譯成適用於作用中代理程式(Claude Code 或 Codex)的正確格式,並於開機時注入 VM。 在尚未設定任何伺服器時,畫面會顯示 尚未設定任何 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 伺服器是一個在 VM 內啟動的命令,透過標準輸入與輸出來使用 MCP。共兩個欄位:
- 命令 — 可執行檔(預留文字
npx)。 - 引數 — 以空格分隔的引數(預留文字
-y @upstash/context7-mcp)。
HTTP 伺服器
HTTP 伺服器是一個遠端 MCP 端點。其 URL 欄位接受伺服器位址(預留文字 https://mcp.example.com/mcp),而 驗證 展開區則存放憑證。有兩種驗證方式,兩者都將真正的權杖保留在主機上——VM 只會持有一個假的權杖,由範圍限定於該伺服器主機的代理伺服器在傳輸過程中換上:
- 使用 OAuth 授權… — 執行主機端的 OAuth 代理程序。授權後,該列會顯示 已授權 以及到期時間(「expires …」)與 重新授權 / 撤銷 按鈕,且權杖的環境變數會自動命名為
MCP_OAUTH_<NAME>。 - 靜態權杖 — 在「Or enter a static token:」下方,設定 環境變數名稱(例如
FIGMA_OAUTH_TOKEN)並將 權杖 貼入安全欄位。權杖欄位的說明文字為 絕不傳送至 VM——由代理伺服器換上。
對於攜帶 bearer 權杖的 HTTP 伺服器,代理伺服器也會回應伺服器主機的 OAuth 探索路徑,好讓 VM 內的代理程式將該伺服器視為已預先驗證,而不會嘗試自己(在 VM 中不可能完成)的 OAuth 流程。bearer 權杖的換置方式與其他憑證家族一併記載於 憑證與傳輸邊界。
MCP 伺服器與應用程式本身的自動化伺服器
有兩種不同的東西共用「MCP」這幾個字母,值得將它們區分清楚:
- 此窗格 設定的是 VM 內的代理程式 作為工具使用的 MCP 伺服器。
- 應用程式的 自動化 功能會公開一個 MCP 伺服器,讓 外部 代理程式驅動 Bromure Agentic Coding 本身(開啟工作區、管理工作階段)。那就是
bromure-cli mcp子命令,於 自動化 窗格中設定,並記載於 自動化與 CLI。
設定參考
| 設定 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 伺服器清單 | 伺服器列的清單 | 空白 | 每部伺服器都有名稱、傳輸、啟用開關以及 JSON 編輯器切換。 |
| 傳輸 | 分段:HTTP / STDIO | HTTP | HTTP = 遠端 URL;STDIO = 在 VM 中啟動的命令。JSON 模式下隱藏。 |
| 已啟用 | 開關(每部伺服器) | 開啟 | 開啟或關閉一部伺服器而不刪除它。 |
| 以 JSON 編輯 | 切換按鈕 | 表單模式 | 將表單換成直接傳遞、就地驗證的原始 JSON 設定。 |
| 命令 / 引數 | 文字(STDIO) | 空白 | 可執行檔及其以空格分隔的引數。 |
| URL | 文字(HTTP) | 空白 | 遠端 MCP 端點位址。 |
| 驗證 | OAuth 代理程序或靜態 bearer 權杖(HTTP) | 無 | OAuth 會自動命名為 MCP_OAUTH_<NAME>;靜態權杖使用你命名的環境變數。真正的權杖保留在主機上並於傳輸過程中換置。 |
| 新增伺服器 | 按鈕 | — | 附加一列新的、啟用的 HTTP 伺服器列。 |