使用 MCP 可以做什麼
連接 MCP servers 後,您可以要求 Claude Code:- 從問題追蹤器實現功能:“新增 JIRA 問題 ENG-4521 中描述的功能,並在 GitHub 上建立 PR。”
- 分析監控資料:“檢查 Sentry 和 Statsig,以檢查 ENG-4521 中描述的功能使用情況。”
- 查詢資料庫:“根據我們的 PostgreSQL 資料庫,找到 10 個使用功能 ENG-4521 的隨機使用者的電子郵件。”
- 整合設計:“根據在 Slack 中發佈的新 Figma 設計更新我們的標準電子郵件範本”
- 自動化工作流程:“建立 Gmail 草稿,邀請這 10 個使用者參加關於新功能的回饋會議。”
- 回應外部事件:MCP server 也可以充當 channel,將訊息推送到您的 session 中,因此當您不在時,Claude 可以回應 Telegram 訊息、Discord 聊天或 webhook 事件。
尋找並建立 MCP servers
在 Anthropic Directory 中瀏覽已審核的連接器。Directory 連接器使用與 Claude Code 相同的 MCP 基礎設施,因此您可以使用claude mcp add 新增任何列在其中的遠端伺服器。
若要建立您自己的伺服器,請參閱 MCP server 指南 以了解協議基礎知識,以及 Claude 連接器建立文件 以了解身份驗證、測試和 Directory 提交。
您也可以使用官方的 mcp-server-dev plugin 讓 Claude 為您建立伺服器。
安裝 plugin
在 Claude Code 工作階段中,執行:如果 Claude Code 報告找不到 marketplace,請先執行
/plugin marketplace add anthropics/claude-plugins-official,然後重試安裝。安裝完成後,執行 /reload-plugins 以在目前工作階段中啟用它。安裝 MCP servers
MCP servers 可以根據您的需求以多種方式進行配置:選項 1:新增遠端 HTTP server
HTTP servers 是連接到遠端 MCP servers 的推薦選項。這是雲端服務最廣泛支援的傳輸方式。.mcp.json、~/.claude.json 或 claude mcp add-json 中的 JSON 配置 MCP servers 時,type 欄位接受 streamable-http 作為 http 的別名。MCP 規範使用名稱 streamable-http 作為此傳輸,因此從 server 文件複製的配置無需修改即可運作。
選項 2:新增遠端 SSE server
選項 3:新增本機 stdio server
Stdio servers 在您的機器上作為本機程序執行。它們非常適合需要直接系統存取或自訂指令碼的工具。 Claude Code 在生成的 server 環境中設定CLAUDE_PROJECT_DIR,以指向專案根目錄,因此您的 server 可以解析專案相對路徑,而無需依賴工作目錄。這與 hooks 在其 CLAUDE_PROJECT_DIR 變數中接收的目錄相同。從您的 server 程序內部讀取它,例如 Node 中的 process.env.CLAUDE_PROJECT_DIR 或 Python 中的 os.environ["CLAUDE_PROJECT_DIR"]。
您的 server 也可以呼叫 MCP roots/list 請求,該請求會傳回啟動 Claude Code 的目錄。
此變數在 server 的環境中設定,而不是在 Claude Code 自己的環境中,因此在專案或使用者範圍的 .mcp.json command 或 args 中透過 ${VAR} 擴展參考它需要預設值,例如 ${CLAUDE_PROJECT_DIR:-.}。Plugin 提供的 MCP 配置直接替換 ${CLAUDE_PROJECT_DIR},不需要預設值。
重要:使用
-- 分隔 server 引數對於 stdio servers,-- (雙破折號) 將 Claude 自己的選項(例如 --transport、--env 和 --scope)與執行 server 的命令和引數分開。-- 之後的所有內容都會原封不動地傳遞給 server。例如:claude mcp add --transport stdio myserver -- npx server→ 執行npx serverclaude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080→ 執行python server.py --port 8080,環境中有KEY=value
--,Claude Code 會嘗試解析 server 的旗標(例如上面的 --port)作為自己的選項。--env 接受多個 KEY=value 對。如果 server 名稱直接跟在 --env 之後,CLI 會將該名稱讀取為另一對並拒絕它,因此請在 --env 和 server 名稱之間放置至少一個其他選項,如上面的範例所示。選項 4:新增遠端 WebSocket server
WebSocket servers 保持持久的雙向連接,適合遠端 MCP servers 主動向 Claude 推送事件。當您的 server 只回應請求時,請改用 HTTP,因為 HTTP 支援 OAuth 和claude mcp add --transport 旗標,而 WebSocket 都不支援。
在 .mcp.json 中或使用 claude mcp add-json 配置 WebSocket servers:
type: "ws" 項目接受與 http 相同的 url、headers、headersHelper、timeout 和 alwaysLoad 欄位。驗證僅限標頭,因此在 headers 中傳遞靜態 token,或在連接時使用 headersHelper 生成一個。claude mcp add --transport 旗標不接受 ws。
管理您的 servers
配置後,您可以使用這些命令管理您的 MCP servers:.mcp.json 的專案範圍 servers 等待您的批准時,會在 claude mcp list 中顯示為 ⏸ Pending approval。執行 claude 互動式命令以檢查和批准它們。claude mcp get <name> 將待處理的 servers 顯示為 ⏸ Pending approval,將被拒絕的 servers 顯示為 ✗ Rejected。
自 v2.1.196 起,claude mcp list 和 claude mcp get 只從未簽入儲存庫的設定檔案中讀取 .mcp.json 批准,直到您透過在其中執行 claude 並接受工作區信任對話框來信任工作區。複製的儲存庫無法批准自己的 servers:提交到專案 .claude/settings.json 的 enableAllProjectMcpServers 或 enabledMcpjsonServers 在不受信任的資料夾中被忽略,server 保持在 ⏸ Pending approval 而不是被連接和健康檢查。
這些來源的批准仍然適用於不受信任的資料夾:
- 您的使用者
~/.claude/settings.json - 受管設定
- 使用
--settings傳遞的設定 .claude/settings.local.json,只要 git 不追蹤它
disabledMcpjsonServers 項目仍然會拒絕 server。
/mcp 面板會在每個已連接的 server 旁邊顯示工具計數,並標記宣告工具功能但未公開任何工具的 servers。
如果您的請求需要來自仍在背景連接的 server 的工具,Claude 會在繼續之前等待該 server。啟用 tool search(預設啟用)後,等待會在 ToolSearch 呼叫內進行。在沒有工具搜尋的配置中,例如 Vertex AI、自訂 ANTHROPIC_BASE_URL 或 ENABLE_TOOL_SEARCH=false,Claude 會改用 WaitForMcpServers 工具。
server 名稱 workspace 保留供內部使用。如果您的配置定義了具有該名稱的 server,Claude Code 會在載入時跳過它,並顯示警告要求您重新命名它。
動態工具更新
Claude Code 支援 MCPlist_changed 通知,允許 MCP servers 動態更新其可用工具、提示和資源,而無需您斷開連接並重新連接。當 MCP server 傳送 list_changed 通知時,Claude Code 會自動重新整理該 server 的可用功能。
自動重新連接
如果 HTTP 或 SSE server 在 session 中途斷開連接,Claude Code 會自動以指數退避方式重新連接:最多五次嘗試,從一秒延遲開始,每次加倍。在/mcp 中,server 會顯示為待處理狀態,同時重新連接正在進行中。五次失敗嘗試後,server 被標記為失敗,您可以從 /mcp 手動重試。Stdio servers 是本機程序,不會自動重新連接。
相同的退避策略適用於 HTTP 或 SSE server 在啟動時初始連接失敗的情況。自 v2.1.121 起,Claude Code 在暫時性錯誤(例如 5xx 回應、連接被拒絕或逾時)上最多重試初始連接三次,如果仍無法連接,則將 server 標記為失敗。驗證和找不到錯誤不會重試,因為它們需要配置變更才能解決。
自 v2.1.191 起,在成功連接後執行的功能探索請求(例如 tools/list、prompts/list 和 resources/list)也會在短退避的情況下重試暫時性網路和 server 錯誤最多三次。驗證錯誤、4xx 回應和請求逾時不會重試。
使用 channels 推送訊息
MCP server 也可以直接將訊息推送到您的 session 中,以便 Claude 可以回應外部事件,例如 CI 結果、監控警報或聊天訊息。若要啟用此功能,您的 server 宣告claude/channel 功能,並在啟動時使用 --channels 旗標選擇加入。請參閱 Channels 以使用官方支援的 channel,或 Channels reference 以建立您自己的。
每個 server 的 timeout 是每個工具呼叫的硬牆鐘限制,來自 server 的進度通知不會延長它。低於 1000 的值會被忽略並落回到 MCP_TOOL_TIMEOUT,或在該變數未設定時落回到其預設值約 28 小時。在 v2.1.162 之前,低於 1000 的值被調整為一秒。對於 HTTP 和 SSE servers,每個請求的 fetch 首位元組預算有 60 秒的最小值。
自 v2.1.187 起,對遠端 HTTP、SSE、WebSocket 或 claude.ai connector server 的工具呼叫如果 5 分鐘內沒有傳送回應和進度通知,會以錯誤中止,而不是等待牆鐘限制。在毫秒中設定 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 環境變數以變更閒置視窗,或將其設定為 0 以停用檢查。Stdio servers 是本機程序,不受閒置逾時限制。
Plugin 提供的 MCP servers
Plugins 可以捆綁 MCP servers,在啟用 plugin 時自動提供工具和整合。Plugin MCP servers 的工作方式與使用者配置的 servers 相同。 Plugin MCP servers 的工作方式:- Plugins 在 plugin 根目錄的
.mcp.json中或在plugin.json中內聯定義 MCP servers - 啟用 plugin 時,其 MCP servers 會自動啟動
- Plugin MCP 工具與手動配置的 MCP 工具一起出現
- Plugin servers 透過 plugin 安裝進行管理,不是
/mcp命令
.mcp.json 中:
plugin.json 中內聯:
- 自動生命週期:在 session 啟動時,已啟用 plugins 的 servers 會自動連接。如果您在 session 期間啟用或停用 plugin,請執行
/reload-plugins以連接或斷開其 MCP servers - 環境變數:使用
${CLAUDE_PLUGIN_ROOT}表示捆綁的 plugin 檔案,${CLAUDE_PLUGIN_DATA}表示 persistent state 在 plugin 更新後仍然存在,以及${CLAUDE_PROJECT_DIR}表示穩定的專案根目錄 - 使用者環境存取:存取與手動配置的 servers 相同的環境變數
- 多種傳輸類型:支援 stdio、SSE、HTTP 和 WebSocket 傳輸,傳輸支援可能因 server 而異
mcp__plugin_<plugin-name>_<server-name>__<tool-name>,其中 A-Z、a-z、0-9、_ 和 - 以外的任何字元都被替換為 _。對於在名為 my-plugin 的 plugin 中捆綁的 database-tools server,query 工具可呼叫為:
allowed-tools 列表或 subagent 的 tools 欄位 中參考工具時,請使用此完整名稱。
Plugin MCP servers 的優點:
- 捆綁分發:工具和 servers 一起打包
- 自動設定:無需手動 MCP 配置
- 團隊一致性:安裝 plugin 時,每個人都會獲得相同的工具
MCP 安裝範圍
MCP servers 可以在三個不同的範圍級別進行配置。您選擇的範圍控制 server 在哪些專案中載入,以及配置是否與您的團隊共享。管理員也可以透過受管配置在企業級別部署 servers。Local scope
Local scope 是預設值。本機範圍的 server 僅在您新增它的專案中載入,並對您保持私密。Claude Code 將其儲存在~/.claude.json 中該專案的路徑下,因此相同的 server 不會出現在您的其他專案中。使用本機範圍進行個人開發 servers、實驗配置或包含您不想在版本控制中的認證的 servers。
MCP servers 的「local scope」術語與一般本機設定不同。MCP 本機範圍的 servers 儲存在
~/.claude.json (您的主目錄) 中,而一般本機設定使用 .claude/settings.local.json (在專案目錄中)。請參閱 Settings 了解設定檔案位置的詳細資訊。/path/to/your/project 執行命令時,該命令會將 server 寫入 ~/.claude.json 中您目前專案的項目。下面的範例顯示結果:
Project scope
Project scope 的 servers 透過在專案根目錄中儲存配置在.mcp.json 檔案中來啟用團隊協作。此檔案設計為簽入版本控制,確保所有團隊成員都能存取相同的 MCP 工具和服務。新增 project scope 的 server 時,Claude Code 會自動建立或更新此檔案,使用適當的配置結構。
.mcp.json 檔案遵循標準化格式:
.mcp.json 檔案的 project scope servers 之前會提示批准。如果您需要重設這些批准選擇,請使用 claude mcp reset-project-choices 命令。
User scope
User scope 的 servers 儲存在~/.claude.json 中,並提供跨專案可存取性,使其在您機器上的所有專案中可用,同時對您的使用者帳戶保持私密。此範圍非常適合個人公用程式 servers、開發工具或您在不同專案中經常使用的服務。
Scope 階層和優先順序
當相同的 server 在多個位置定義時,Claude Code 連接到它一次,使用來自最高優先順序來源的定義。整個 server 項目來自該來源;欄位不會跨範圍合併。- Local scope
- Project scope
- User scope
- Plugin-provided servers
- claude.ai connectors
.mcp.json 中的環境變數擴展
Claude Code 支援 .mcp.json 檔案中的環境變數擴展,允許團隊共享配置,同時保持機器特定路徑和 API 金鑰等敏感值的靈活性。
支援的語法:
${VAR}- 擴展為環境變數VAR的值${VAR:-default}- 如果設定了VAR,則擴展為VAR,否則使用default
command- server 可執行檔路徑args- 命令列引數env- 傳遞給 server 的環境變數url- 對於 HTTP server 類型headers- 對於 HTTP server 驗證
實用範例
範例:使用 Sentry 監控錯誤
範例:連接到 GitHub 進行程式碼審查
GitHub 的遠端 MCP server 使用作為標頭傳遞的 GitHub 個人存取 token 進行驗證。若要取得一個,請開啟您的 GitHub token 設定,產生一個新的細粒度 token,具有對您希望 Claude 使用的儲存庫的存取權,然後新增 server:範例:查詢您的 PostgreSQL 資料庫
使用遠端 MCP servers 進行驗證
許多雲端 MCP servers 需要驗證。Claude Code 支援 OAuth 2.0 以進行安全連接。 Claude Code 會在 server 以401 Unauthorized 或 403 Forbidden 回應時,將遠端 server 標記為需要驗證。任一狀態碼都會在 /mcp 中標記 server,以便您可以完成 OAuth 流程。
從 v2.1.195 開始,當 token 重新整理失敗,因為 server 拒絕儲存的重新整理 token 時,Claude Code 會立即顯示指向 /mcp 的通知。連接的 server 的功能表會提供「重新驗證」選項,因此您可以在下一個工具呼叫失敗之前重新登入。
傳回指向其授權 server 的 WWW-Authenticate 標頭的自訂 server 會獲得與任何其他遠端 server 相同的自動探索。
從 v2.1.193 開始,Claude Code 也會在啟動時顯示通知,當一個或多個已配置的 servers 需要驗證時,因此您不必開啟 /mcp 來探索哪些 servers 需要登入。
在非互動模式中,沒有 /mcp 面板,因此 Claude Code 無法為您執行 OAuth 流程。從 v2.1.196 開始,當已配置的 server 在 claude -p 或啟用工具搜尋的 Agent SDK 執行期間需要驗證時 (這是預設值),Claude Code 會告訴 Claude 該 server 的工具不可用,直到您授權它。Claude 可以命名需要登入的 server,而不是回應為好像 server 未配置。從使用 /mcp 或 claude mcp login <name> 的互動 session 完成登入。
如果您為 server 配置了 headers.Authorization,而 server 拒絕該標頭,Claude Code 會將連接報告為失敗,而不是回退到 OAuth。檢查 token 對 MCP 端點是否有效,或移除標頭以使用 OAuth 流程。
從命令列進行驗證
從 v2.1.186 開始,claude mcp login <name> 直接從您的 shell 執行已配置 server 的 OAuth 流程,因此您不需要在 session 內開啟 /mcp 面板。
claude mcp logout <name>。
從 v2.1.191 開始,該命令會偵測何時沒有本機瀏覽器可用,例如在 SSH session 期間或在沒有顯示伺服器的 Linux 上,並列印授權 URL 而不是嘗試開啟瀏覽器。在您的本機機器上開啟 URL,然後將瀏覽器位址列中的完整重新導向 URL 貼回提示處。該命令需要互動式終端以進行貼上步驟,因此請使用 ssh -t 連接。傳遞 --no-browser 以強制 URL 提示,即使偵測到本機瀏覽器。
使用固定的 OAuth 回呼連接埠
某些 MCP servers 需要預先註冊的特定重新導向 URI。根據預設,Claude Code 為 OAuth 回呼選擇隨機可用連接埠。使用--callback-port 固定連接埠,使其符合 http://localhost:PORT/callback 形式的預先註冊重新導向 URI。
您可以單獨使用 --callback-port (使用動態用戶端註冊) 或與 --client-id 一起使用 (使用預先配置的認證)。
使用預先配置的 OAuth 認證
某些 MCP servers 不支援透過 Dynamic Client Registration 進行自動 OAuth 設定。如果您看到類似「Incompatible auth server: does not support dynamic client registration」的錯誤,server 需要預先配置的認證。Claude Code 也支援使用 Client ID Metadata Document (CIMD) 而不是 Dynamic Client Registration 的 servers,並自動探索這些。如果自動探索失敗,請先透過 server 的開發人員入口網站註冊 OAuth 應用程式,然後在新增 server 時提供認證。使用 server 註冊 OAuth 應用程式
透過 server 的開發人員入口網站建立應用程式,並記下您的用戶端 ID 和用戶端密碼。許多 servers 也需要重新導向 URI。如果是這樣,請選擇一個連接埠並以
http://localhost:PORT/callback 的格式註冊重新導向 URI。在下一步中使用該相同連接埠搭配 --callback-port。使用您的認證新增 server
選擇以下方法之一。用於
--callback-port 的連接埠可以是任何可用的連接埠。它只需要符合您在上一步中註冊的重新導向 URI。- claude mcp add
- claude mcp add-json
- claude mcp add-json (僅回呼連接埠)
- CI / env var
使用
--client-id 傳遞您應用程式的用戶端 ID。--client-secret 旗標會提示輸入帶有遮罩輸入的密碼:覆蓋 OAuth 中繼資料探索
指向 Claude Code 特定的 OAuth 授權 server 中繼資料 URL 以繞過預設探索鏈。當 MCP server 的標準端點出錯時,或當您想要透過內部代理路由探索時,設定authServerMetadataUrl。根據預設,Claude Code 首先檢查 RFC 9728 Protected Resource Metadata at /.well-known/oauth-protected-resource,然後回退到 RFC 8414 authorization server metadata at /.well-known/oauth-authorization-server。
在 .mcp.json 中 server 配置的 oauth 物件中設定 authServerMetadataUrl:
https://。authServerMetadataUrl 需要 Claude Code v2.1.64 或更新版本。中繼資料 URL 的 scopes_supported 會覆蓋上游 server 宣傳的範圍。
限制 OAuth 範圍
設定oauth.scopes 以固定 Claude Code 在授權流程中要求的範圍。這是限制 MCP server 到安全團隊批准的子集的支援方式,當上游授權 server 宣傳的範圍超過您想要授予的範圍時。該值是單個空格分隔的字串,符合 RFC 6749 §3.3 中的 scope 參數格式。
oauth.scopes 優先於 authServerMetadataUrl 和 server 在 /.well-known 發現的範圍。保持未設定以讓 MCP server 決定要求的範圍集。
從 v2.1.196 開始,當未設定 oauth.scopes 時,Claude Code 會要求 server 的 WWW-Authenticate 標頭或其受保護資源中繼資料提供的範圍,當兩者都未提供時不傳送 scope 參數。它不再要求自動探索的授權 server 中繼資料中的完整 scopes_supported 目錄。要求該目錄使得宣傳僅限管理員或範本範圍的身分提供者以 invalid_scope 錯誤拒絕授權要求。從配置的 authServerMetadataUrl 擷取的中繼資料仍然提供其 scopes_supported 作為要求的範圍。
如果授權 server 在 scopes_supported 中宣傳 offline_access,Claude Code 會將其附加到固定範圍,以便可以在沒有新瀏覽器登入的情況下重新整理存取 token。
如果 server 稍後為工具呼叫傳回 403 insufficient_scope,Claude Code 會使用相同的固定範圍重新驗證。當您需要的工具需要固定範圍外的範圍時,擴展 oauth.scopes。
使用動態標頭進行自訂驗證
如果您的 MCP server 使用 OAuth 以外的驗證方案 (例如 Kerberos、短期 tokens 或內部 SSO),請使用headersHelper 在連接時產生請求標頭。Claude Code 執行命令並將其輸出合併到連接標頭中。
- 命令必須將字串鍵值對的 JSON 物件寫入 stdout
- 命令在 shell 中執行,逾時時間為 10 秒
- 動態標頭會覆蓋任何具有相同名稱的靜態
headers
401 Unauthorized 或 403 Forbidden,Claude Code 會自動重新執行 helper、使用新標頭重新連接,並重試呼叫一次。Claude Code 只有在該重試也失敗時,才會在 /mcp 中將 server 標記為需要驗證。
Claude Code 在執行 helper 時設定這些環境變數:
| 變數 | 值 |
|---|---|
CLAUDE_CODE_MCP_SERVER_NAME | MCP server 的名稱 |
CLAUDE_CODE_MCP_SERVER_URL | MCP server 的 URL |
CLAUDE_PLUGIN_ROOT | 外掛程式的根目錄。僅當外掛程式提供 server 時設定 |
headersHelper 路徑會在外掛程式目錄內解析,而不是針對 session 的工作目錄。需要 Claude Code v2.1.195 或更新版本。
headersHelper 執行任意 shell 命令。在專案或本機範圍定義時,它僅在您接受工作區信任對話框後執行。從 JSON 配置新增 MCP servers
如果您有 MCP server 的 JSON 配置,您可以直接新增它:從 Claude Desktop 匯入 MCP servers
如果您已在 Claude Desktop 中配置了 MCP servers,您可以匯入它們:使用來自 claude.ai 的 MCP servers
如果您已使用 claude.ai 帳戶登入 Claude Code,您在 claude.ai 中新增的 MCP servers 會自動在 Claude Code 中可用:在 claude.ai 中配置 MCP servers
在 claude.ai/customize/connectors 新增 servers。在 Team 和 Enterprise 計畫上,只有管理員可以新增 servers。
Show unused connectors 列後面摺疊,因此組織佈建的列表不會填滿面板。選擇該列以展開它們。您之前登入過的 connector 即使目前需要重新驗證,也會保持可見。
Claude.ai connectors 只有在您的活躍驗證方法是您的 Claude.ai 訂閱時才會被取得。當 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper 或第三方提供者(例如 Bedrock 或 Vertex)處於活躍狀態時,它們不會被載入,即使您之前執行過 /login。如果 /mcp 沒有列出您新增的 connector,請執行 /status 以確認哪個驗證方法處於活躍狀態,取消設定該環境變數或移除 apiKeyHelper 設定,然後執行 /login 以選擇您的 claude.ai 帳戶。
您在 Claude Code 中新增的 server 優先於指向相同 URL 的 claude.ai connector。發生這種情況時,/mcp 會將 connector 列為隱藏,並顯示如何移除重複項(如果您寧願使用 connector)。
某些 Anthropic 託管的 connectors(例如 Microsoft 365、Gmail 和 Google Calendar)不支援來自 Claude Code 的本機 OAuth,因為上游身分識別提供者只接受 claude.ai 註冊的重新導向 URL。從 v2.1.162 開始,在 /mcp 中驗證其中一個主機會顯示一條訊息,指導您改為在 claude.ai 上的設定 → Connectors 中連接它。連接後,connector 會自動出現在 Claude Code 中。
停用 claude.ai connectors
若要在 Claude Code 中停用 claude.ai MCP servers,請將disableClaudeAiConnectors 設定為 true(在任何設定範圍中):
true 優先。已簽入的專案 .claude/settings.json 可以選擇退出雲端 connectors,但專案層級的 false 無法重新啟用使用者或政策層級 true 已停用的 connectors。透過 --mcp-config 明確傳遞的 servers 不受影響。
您也可以將 ENABLE_CLAUDEAI_MCP_SERVERS 環境變數設定為 false,這對目前的 shell 工作階段有相同的效果:
deniedMcpServers。例如,serverName 項目 "claude.ai Slack" 會阻止 Slack connector。若要僅針對目前專案切換 connector 的開啟或關閉,請使用 /mcp 面板。
這些用戶端設定管理本機 Claude Code 工作階段。在 Claude Code on the web 工作階段中,claude.ai connectors 由遠端主機佈建,並作為明確的
--mcp-config 項目到達,因此 disableClaudeAiConnectors 不適用於此處。Connector URL 也會透過工作階段代理重寫,因此針對廠商 URL 的 deniedMcpServers serverUrl 模式將不會符合。從您的 claude.ai 組織設定管理雲端工作階段可以使用哪些 connectors。使用 Claude Code 作為 MCP server
您可以使用 Claude Code 本身作為其他應用程式可以連接到的 MCP server:MCP 輸出限制和警告
當 MCP 工具產生大型輸出時,Claude Code 可幫助管理 token 使用情況,以防止淹沒您的對話內容:- 輸出警告閾值:當任何 MCP 工具輸出超過 10,000 個 tokens 時,Claude Code 會顯示警告
- 可配置限制:您可以使用
MAX_MCP_OUTPUT_TOKENS環境變數調整最大允許的 MCP 輸出 tokens - 預設限制:預設最大值為 25,000 個 tokens
- 範圍:環境變數適用於未宣告自己限制的工具。設定
anthropic/maxResultSizeChars的工具使用該值代替文字內容,無論MAX_MCP_OUTPUT_TOKENS設定為什麼。傳回影像資料的工具仍受MAX_MCP_OUTPUT_TOKENS限制
- 查詢大型資料集或資料庫
- 產生詳細報告或文件
- 處理廣泛的日誌檔案或除錯資訊
提高特定工具的限制
如果您正在建立 MCP server,您可以透過在工具的tools/list 回應項目中設定 _meta["anthropic/maxResultSizeChars"] 來允許個別工具傳回超過預設持久化到磁碟閾值的結果。Claude Code 將該工具的閾值提高到註解值,最高為 500,000 個字元的硬上限。
這對於傳回本質上很大但必要的輸出的工具很有用,例如資料庫架構或完整檔案樹。沒有註解,超過預設閾值的結果會持久化到磁碟,並在對話中被檔案參考取代。
MAX_MCP_OUTPUT_TOKENS 應用,因此使用者無需提高環境變數來使用宣告它的工具。傳回影像資料的工具仍受 token 限制。
回應 MCP 引發請求
MCP servers 可以使用引發在任務中途要求您提供結構化輸入。當 server 需要無法自行取得的資訊時,Claude Code 會顯示互動式對話框並將您的回應傳回給 server。您無需進行任何配置:當 server 要求時,引發對話框會自動出現。 Servers 可以透過兩種方式要求輸入:- 表單模式:Claude Code 顯示一個對話框,其中包含 server 定義的表單欄位 (例如,使用者名稱和密碼提示)。填入欄位並提交。
- URL 模式:Claude Code 開啟瀏覽器 URL 以進行驗證或批准。在瀏覽器中完成流程,然後在 CLI 中確認。
Elicitation hook。
如果您正在建立使用引發的 MCP server,請參閱 MCP 引發規格,了解協議詳細資訊和架構範例。
使用 MCP 資源
MCP servers 可以公開資源,您可以使用 @ 提及來參考,類似於您參考檔案的方式。參考 MCP 資源
使用 MCP Tool Search 進行擴展
Tool search 透過延遲工具定義直到 Claude 需要它們來保持 MCP 內容使用低。只有工具名稱和伺服器指示在 session 啟動時載入,因此新增更多 MCP servers 對您的內容視窗的影響最小。Claude Code 不會對每個伺服器施加固定的工具上限;實際限制是您的內容視窗預算。工作原理
Tool search 預設啟用。MCP 工具被延遲而不是預先載入到內容中,Claude 使用搜尋工具在任務需要時探索相關的工具。只有 Claude 實際使用的工具才會進入內容。從您的角度來看,MCP 工具的工作方式完全相同。 如果您偏好基於閾值的載入,請設定ENABLE_TOOL_SEARCH=auto 以在工具適合內容視窗的 10% 內時預先載入架構,並僅延遲溢出。請參閱 配置 tool search 了解所有選項。
對於 MCP server 作者
如果您正在建立 MCP server,啟用 Tool Search 時 server 指示欄位會變得更有用。Server 指示可幫助 Claude 了解何時搜尋您的工具,類似於 skills 的工作方式。 新增清晰、描述性的 server 指示,說明:- 您的工具處理的任務類別
- Claude 應何時搜尋您的工具
- 您的 server 提供的關鍵功能
配置 tool search
Tool search 預設啟用:MCP 工具被延遲並按需探索。Claude Code 在 Vertex AI 上預設停用它。當ANTHROPIC_BASE_URL 指向非第一方主機時,它也被停用,因為大多數代理不轉發 tool_reference 區塊。設定 ENABLE_TOOL_SEARCH 明確以覆蓋任一回退。
Tool search 需要支援 tool_reference 區塊的模型。Haiku 模型不支援它。在 Vertex AI 上,tool search 支援 Claude Sonnet 4.5 及更新版本和 Claude Opus 4.5 及更新版本。
使用 ENABLE_TOOL_SEARCH 環境變數控制 tool search 行為:
| 值 | 行為 |
|---|---|
| (未設定) | 所有 MCP 工具被延遲並按需載入。在 Vertex AI 上或當 ANTHROPIC_BASE_URL 是非第一方主機時回退到預先載入 |
true | 所有 MCP 工具被延遲。Claude Code 即使在 Vertex AI 上和透過代理也會傳送 beta 標頭。在 Vertex AI 模型早於 Sonnet 4.5 或 Opus 4.5 上,或在不支援 tool_reference 區塊的代理上,請求會失敗 |
auto | 閾值模式:如果工具適合內容視窗的 10% 內,則預先載入,否則延遲 |
auto:N | 閾值模式,具有自訂百分比,其中 N 是 0-100。例如,auto:5 表示 5% |
false | 所有 MCP 工具預先載入,無延遲 |
env 欄位 中設定值。
您也可以特別停用 ToolSearch 工具:
豁免伺服器延遲
如果伺服器的工具應始終對 Claude 可見而無需搜尋步驟,請在該伺服器的配置中將alwaysLoad 設定為 true。該伺服器的每個工具隨後都會在 session 啟動時載入到內容中,無論 ENABLE_TOOL_SEARCH 設定如何。對於 Claude 在每個回合都需要的少量工具,請使用此選項,因為每個預先載入的工具會消耗內容,否則這些內容將可用於您的對話。
以下 .mcp.json 項目豁免一個 HTTP 伺服器,同時保持其他伺服器延遲:
alwaysLoad 欄位在所有伺服器類型上可用,需要 Claude Code v2.1.121 或更新版本。MCP 伺服器也可以透過在工具的 _meta 物件中包含 "anthropic/alwaysLoad": true 來標記個別工具為始終載入,這對該工具只有相同的效果。
設定 alwaysLoad: true 也會阻止啟動直到伺服器連線,上限為標準 5 秒連線逾時。即使 MCP 啟動在其他方面預設為非阻塞,這也適用,因為工具必須在建立第一個提示時存在。其他伺服器繼續在背景中連線。
使用 MCP 提示作為命令
MCP servers 可以公開提示,這些提示在 Claude Code 中變成可用的命令。執行 MCP 提示
受管理的 MCP 配置
對於需要對使用者可以連接的 MCP servers 進行集中控制的組織,請參閱 受管理的 MCP 配置。它涵蓋使用managed-mcp.json 部署固定的 server 集合、使用 allowedMcpServers 和 deniedMcpServers 限制 servers,以及當 server 被阻止時使用者看到的內容。