MCP

MCP 窗格用來設定此工作區的代理程式可使用的 Model Context Protocol 伺服器。MCP 伺服器讓代理程式能存取外部工具與情境資訊,例如文件索引、問題追蹤系統、設計工具或資料庫瀏覽器。你在此處為每部伺服器定義一次,Bromure Agentic Coding 會將其翻譯成每個啟用之代理程式所需的正確設定格式,並於開機時注入 VM。

編輯工作區視窗的 MCP 窗格,顯示尚未設定任何 MCP 伺服器的空白狀態訊息以及一個新增伺服器按鈕

窗格的說明文字概述了整個流程:MCP 伺服器讓你的代理程式能存取外部工具與情境資訊。設定會被翻譯成適用於作用中代理程式(Claude Code 或 Codex)的正確格式,並於開機時注入 VM。 在尚未設定任何伺服器時,畫面會顯示 尚未設定任何 MCP 伺服器。

伺服器如何交付給代理程式

你以中立的形式描述每部伺服器一次。在工作階段開機時,bromure 會以每個啟用之代理程式的原生格式寫出:

  • Claude Code — 合併至 ~/.claude.json
  • Codex — 以 TOML 區塊寫入 ~/.codex/config.toml
  • Grok Build — 合併至 Grok 的使用者設定檔。

由於這些動作在開機時才發生,因此新增、編輯或移除伺服器會在工作區的工作階段下次啟動時生效,而非在執行中的工作階段即時生效。每部伺服器各自的啟用開關讓你可以保留檔案中的定義,同時在某次執行中將其關閉。

新增伺服器

按一下 新增伺服器 以附加一列。新伺服器預設使用 HTTP 傳輸並為啟用狀態。每一列的標頭橫列有下列控制項:

  • 名稱 — 伺服器的識別碼(預留文字 my-server)。
  • 傳輸 — 分段控制項,HTTPSTDIO。當該列處於 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 / STDIOHTTPHTTP = 遠端 URL;STDIO = 在 VM 中啟動的命令。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 設定。
  • 設定參考 — 一覽所有窗格。