透過 MCP 將 Claude Code 連接到工具

​

使用 MCP 可以做什麼

• 從問題追蹤器實現功能：“新增 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

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

安裝 MCP servers

​

選項 1：新增遠端 HTTP server

# 基本語法
claude mcp add --transport http <name> <url>

# 實際範例：連接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 使用 Bearer token 的範例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

選項 2：新增遠端 SSE server

# 基本語法
claude mcp add --transport sse <name> <url>

# 實際範例：連接到 Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# 使用驗證標頭的範例
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

​

選項 3：新增本機 stdio server

# 基本語法
claude mcp add [options] <name> -- <command> [args...]

# 實際範例：新增 Airtable server
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

選項 4：新增遠端 WebSocket server

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

從為另一個用戶端編寫的設定指示新增 server

• URL，例如 https://mcp.example.com/mcp：server 是遠端的。
• 啟動命令，例如 npx -y @example/mcp-server：server 在您的機器上執行。
• mcpServers JSON 區塊：為另一個用戶端的設定檔案編寫的配置。

​

從 URL

claude mcp add --transport http example https://mcp.example.com/mcp

​

從 npx、uvx 或二進位命令

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

從 mcpServers JSON 區塊

• 沒有 type 的 url：新增 "type": "http"、"type": "sse" 或 "type": "ws" 以符合端點。Claude Code 將沒有 type 的項目讀取為 stdio server，因此沒有 type 的 url 項目會失敗。
• 具有字母、數字、連字號和底線以外字元的金鑰：選擇僅使用這些字元的 server 名稱。否則金鑰是 server 名稱。

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

​

管理您的 servers

# 列出所有已配置的 servers
claude mcp list

# 取得特定 server 的詳細資訊
claude mcp get notion

# 移除 server
claude mcp remove notion

# (在 Claude Code 中) 檢查 server 狀態
/mcp

​

Server 狀態

• ⏸ Pending approval (run `claude` to approve)：來自 .mcp.json 的專案範圍 server，您尚未批准。Claude Code 在 claude mcp list 和 claude mcp get <name> 中都顯示它。執行 claude 互動式命令以檢查和批准它。
• ✘ Rejected (see disabledMcpjsonServers in settings)：由 disabledMcpjsonServers 項目拒絕的 .mcp.json server。Claude Code 只在 claude mcp get <name> 中顯示它。
• ⊘ Disabled for this project (re-enable via /mcp)：專案的 disabledMcpServers 列表命名的 server。Claude Code 在 claude mcp list 和 claude mcp get <name> 中都顯示它。從 /mcp 面板重新開啟 server。在 v2.1.238 之前，兩個命令都連接到已停用的 server 以進行健康檢查並報告連接結果。

​

專案 server 批准和工作區信任

• 您的使用者 ~/.claude/settings.json
• 受管設定
• 使用 --settings 傳遞的設定

​

Server 狀態詳細資訊

• 路徑和查詢永遠不會出現在該訊息中。
• 對於本機、專案或使用者範圍中的 server 或受管 MCP 配置中的 server，來源顯示在該配置中寫入的主機，因此主機中的 ${VAR} 參考在訊息中不會展開。
• 對於沒有狀態或錯誤代碼的失敗，Claude Code 顯示錯誤文字而不顯示來源。

​

配置警告

• 隱藏的空白：當 MCP 配置值攜帶隱藏的前導或尾隨空白時，Claude Code 會發出警告，這通常來自貼上帶有尾隨換行符的 token。Claude Code 檢查 command、url、每個 args 項目以及 env 和 headers 下的值和金鑰名稱。Claude Code 在 claude mcp list 輸出和 /mcp 中顯示警告，命名受影響的欄位而不回顯其值，例如 Leading or trailing whitespace in: headers.Authorization。Claude Code 不會修剪空白，並完全按照寫入的方式使用值，因此編輯配置以移除它。
• 在多個範圍中具有相同名稱：如果您在多個範圍中定義相同的 server 名稱，具有不同的端點，Claude Code 會在 claude mcp list 輸出和 /mcp 中警告衝突。Claude Code 按端點儲存 OAuth 登入，因此當您驗證在一個專案中載入的定義時，您仍然需要在不同定義載入的專案中單獨登入。保留您想要的端點並使用 claude mcp remove <name> --scope <scope> 移除其他端點。在警告中，Claude Code 引用每個範圍的端點，如在您的配置中寫入的，具有${VAR} 參考未展開，因此它永遠不會顯示已解析的值，例如 API 金鑰。
• 保留名稱：Claude Code 保留其內建 servers 的名稱，包括 workspace、claude-in-chrome、computer-use、Claude Preview 和 Claude Browser。如果您的配置定義了具有保留名稱的 server，Claude Code 會在載入時跳過它，並顯示警告要求您重新命名它。claude mcp add 會以錯誤拒絕保留名稱。Claude Preview 和 Claude Browser 都命名了 Claude Code 桌面應用程式的預覽窗格使用的內建 server。在 v2.1.205 之前，Claude Browser 未被保留，因此使用者配置的 server 可以在該名稱下註冊。
• 遺漏的環境變數：如果配置中的 ${VAR} 參考命名未設定且沒有 :-default 的變數，Claude Code 會在 claude mcp list 輸出和 /mcp 中警告，命名變數，並仍然使用 ${VAR} 文字未展開載入 server。設定變數或新增 ${VAR:-default} 後備。在遠端 server 的 url 和 headers 中，某些認證變數讀取為空，沒有警告。

​

工具可用性

• 使用工具搜尋（預設）：等待發生在 ToolSearch 呼叫內。
• 沒有工具搜尋：Claude 改為使用 WaitForMcpServers 工具。沒有工具搜尋的配置包括自訂 ANTHROPIC_BASE_URL、ENABLE_TOOL_SEARCH=false 和 Google Cloud 的 Agent Platform 上早於 Claude 4.5 世代的模型。
• 在 Microsoft Foundry 部署託管在 Azure 上：Claude 在工具搜尋路徑上啟動，而不是使用 WaitForMcpServers，因為 Claude Code 只從 API 發現部署的伺服器端拒絕。Claude Code 將該部署切換到前期載入後，來自完成連接的 server 的工具在 Claude 的下一個請求上變得可用。

​

停用 server 而不移除它

• disabledMcpServers：使用者配置的 servers、plugin servers、您的組織透過受管設定提供的 servers、Claude Code 自己擷取的 claude.ai 連接器以及預設為開啟的內建 servers 的選擇退出列表。Claude Code 不會連接到您在此列出的 server。當您使用停用 claude.ai 連接器中所述的按專案 /mcp 切換停用 claude.ai 連接器時，Claude Code 會在此列表下使用其顯示名稱（例如 claude.ai Slack）寫入它。
• enabledMcpServers：預設為關閉的內建 servers（例如 computer-use）的選擇加入列表。Claude Code 只在您在此列出時連接到預設關閉的 server。

​

MCP 用戶端執行時

• Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上的 Sessions，除非嵌入 Claude Code 的主機平台設定 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• 透過 Claude apps gateway 登入的 Sessions
• 您關閉遙測或功能旗標擷取的 Sessions，例如使用 DISABLE_TELEMETRY

• 詢問 HTTP servers 是否支援較新的修訂版，並與支援的 servers 一起使用它。它也在擷取功能旗標的 sessions 中詢問 claude.ai 連接器 servers。若要讓它詢問 stdio servers 或每個 session 中的連接器 servers，請設定 MCP_PROTOCOL_NEGOTIATION 為 auto。它連接到每個其他 server，如 v1 所做的那樣。
• 從較新修訂版上的 servers 接收 list_changed 通知，透過它保持開啟的流。
• 不註冊在較新修訂版上連接的channel server，因為該修訂版無法攜帶 channel 訊息。
• 失敗MCP OAuth 登入，其授權回應命名意外的簽發者。

​

動態工具更新

​

v2 執行時上的通知流

• 流在 10 秒內再次關閉：Claude Code 最多重新開啟它三次，然後停止該連接。
• 流保持開啟超過 10 秒，然後關閉，如流到無伺服器主機通常所做的那樣：在一小時內五次重新開啟後，Claude Code 在下一次之前等待約六小時。

​

自動重新連接

​

遠端 server 的中途斷開

• 在互動式 session 中：/mcp 在 Claude Code 重新連接時將 server 顯示為待處理。五次失敗嘗試後，Claude Code 將 server 標記為失敗，或在 server 需要再次授權時標記為需要驗證。當它將 server 標記為失敗時，您會看到 MCP server "<name>" disconnected · open /mcp to reconnect 通知。您可以從 /mcp 手動重試。
• 在 claude -p 執行和 Agent SDK sessions 中：Claude Code 按相同的時間表重新連接，沒有 /mcp 面板顯示嘗試。

​

失敗的首次連接

• WebSocket server 的首次連接
• 驗證或找不到錯誤，因為它需要配置變更才能解決。當 headersHelper 是 server 的 Authorization 標頭的唯一來源時，Claude Code 無論如何都會重試驗證錯誤，因為它在每次嘗試時重新執行 helper 並可以選擇新的認證

​

失敗的發現請求

​

Claude 如何了解 server 失敗

• 使用工具搜尋，Claude Code 告訴 Claude 哪個 server 失敗及其連接錯誤，因此 Claude 在其回應中報告連接失敗。Claude Code 在找不到匹配工具的 ToolSearch 結果中包含相同的資訊。
• 在任何沒有工具搜尋的配置中，Claude Code 不會向 Claude 報告失敗的 server 連接。

​

使用 channels 推送訊息

​

長工具呼叫的自動背景化

• 來自 subagents 的呼叫；Claude Code 只背景化主對話呼叫
• 對 IDE servers 的呼叫
• 在非互動式模式中的呼叫，除非 CLAUDE_AUTO_BACKGROUND_TASKS 設定為 1，因為一次性執行可能在結果到達之前結束

​

Plugin 提供的 MCP servers

• Plugins 在 plugin 根目錄的 .mcp.json 中或在 plugin.json 中內聯定義 MCP servers
• 啟用 plugin 時，其 MCP servers 會自動啟動
• Claude Code 將 plugin MCP 工具與手動配置的 MCP 工具一起提供
• 您透過安裝或卸載 plugin 新增和移除 plugin servers，而不是使用 /mcp 命令。您仍然可以在 /mcp 中切換已安裝的 plugin server 關閉，這會停止 Claude Code 連接到它，而不會移除 plugin

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• 自動生命週期：servers 在這些點連接和斷開：
  • 在 session 啟動時，Claude Code 自動連接已啟用 plugins 的 servers。在 /mcp 中，您之前使用過的遠端 (HTTP 或 SSE) plugin server 可以顯示cached 狀態而不是；Claude Code 在 Claude 首次呼叫其其中一個工具時連接它
  • 如果您在 session 期間啟用或停用 plugin，Claude Code 在變更套用時連接或斷開其 MCP servers。在不重新啟動的情況下套用 plugin 變更描述何時發生。在沒有互動式終端的 session 中，/reload-plugins 不會連接或斷開 plugin MCP servers；這些變更在您的下一個 session 中生效
  • 當您重新載入時，Claude Code 保留配置未變更的 plugin servers 的即時連接，並在您替換 session 的 MCP server 列表而不命名它們時執行相同操作
  • 當您在 v2.1.246 或更新版本上使用 /cd 移動 session 時，Claude Code 連接新目錄的設定啟用的 plugins 的 servers，並斷開不再啟用的 plugins 的 servers，因此您不需要在移動後執行 /reload-plugins
  • 在雲端 sessions 中，對尚未連接的 plugin server 的 MCP 呼叫（例如在閒置 session 喚醒後），按需啟動 server 並等待它連接
• 路徑佔位符：${CLAUDE_PLUGIN_ROOT} 解析為 plugin 的安裝目錄，${CLAUDE_PLUGIN_DATA} 解析為其持久狀態目錄，${CLAUDE_PROJECT_DIR} 解析為穩定的專案根目錄。替換適用於：
  • stdio servers：command、args、env
  • http、sse 和 ws servers：url、headers 和 headersHelper。在 v2.1.195 之前，headersHelper 將佔位符作為字面字符串傳遞
• 使用者環境存取：存取與手動配置的 servers 相同的環境變數
• 多種傳輸類型：支援 stdio、SSE、HTTP 和 WebSocket 傳輸，傳輸支援可能因 server 而異

mcp__plugin_my-plugin_database-tools__query

​

MCP 安裝範圍

​

Local scope

# 新增本機範圍的 server (預設)
claude mcp add --transport http stripe https://mcp.stripe.com

# 明確指定本機範圍
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

Project scope

# 新增 project scope 的 server
claude mcp add --transport http shared-server --scope project https://example.com/mcp

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

• 將其新增到 disabledMcpjsonServers，這會在每個權限模式中阻止它。
• 使用 --setting-sources 或 SDK 的 settingSources 選項完全排除專案設定。
• 使用 --strict-mcp-config 啟動工作階段。Claude Code 隨後只使用您透過 --mcp-config 傳遞的 MCP servers。跳過 Claude Code 未載入的 project scope servers 的批准提示需要 Claude Code v2.1.246 或更新版本；在 v2.1.246 之前，嚴格工作階段仍會等待它們的批准，這會導致背景工作階段在啟動時等待。請參閱使用 managed-mcp.json 進行獨佔控制了解該旗標在受管 MCP 檔案下的作用。

​

User scope

# 新增使用者 server
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

Scope 階層和優先順序

1. Local scope
2. Project scope
3. User scope
4. Plugin-provided servers
5. claude.ai connectors

​

.mcp.json 中的環境變數擴展

​

支援的語法

• ${VAR}：擴展為環境變數 VAR 的值
• ${VAR:-default}：如果設定了 VAR，則擴展為 VAR，否則使用 default

​

擴展位置

• command：server 可執行檔路徑
• args：命令列引數
• env：傳遞給 server 的環境變數
• url：對於 HTTP server 類型
• headers：對於 HTTP server 驗證

​

使用變數擴展的範例

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

​

未設定預設值的未設定變數

​

讀取為空的認證變數

• Claude Code 自己的認證，例如 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
• 您的雲端提供者的認證，例如 AWS_BEARER_TOKEN_BEDROCK
• 您的環境攜帶的其他認證，例如 HTTPS_PROXY 和 NPM_TOKEN

​

參考在 /mcp 和 CLI 輸出中的顯示方式

• server 的 /mcp 詳細檢視中的 URL 或命令行
• claude mcp list 和 claude mcp get 輸出

​

實用範例

​

範例：連接到 GitHub 進行程式碼審查

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

審查 PR #456 並建議改進

為我們剛發現的錯誤建立新問題

顯示所有指派給我的開放 PRs

​

範例：查詢您的 PostgreSQL 資料庫

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

本月我們的總收入是多少？

顯示 orders 表的架構

找到 90 天內未進行購買的客戶

​

使用遠端 MCP 伺服器進行身份驗證

• 對於您尚未登入的伺服器，任一狀態碼都會在 /mcp 中標記它，以便您完成 OAuth 流程。
• 對於 claude.ai 連接器，由 claude.ai 拒絕您的工作階段令牌導致的 401 不會標記連接器，因為重新授權連接器無法修復您的登入。Claude Code 改為顯示 工作階段令牌被拒絕狀態。
• 對於您在 headers 中或透過 headersHelper 設定 Authorization 標頭的伺服器，連線時的 401 或 403 不會標記伺服器，因為要修復的認證是您設定的認證。Claude Code 改為報告連線失敗。如果您從 ${VAR} 參考設定該標頭，請檢查該變數是否是 Claude Code 讀取為空 的變數之一。
• 對於 傳遞到雲端工作階段的連接器，Claude Code 不會執行登入流程，因為工作階段的代理使用您在 claude.ai 中授予的授權向連接器進行身份驗證。當那裡的連接器需要再次授權時，請在 claude.ai/customize/connectors 重新連接它，而不是從工作階段進行。

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

/mcp

​

從命令列進行身份驗證

claude mcp login sentry

claude mcp login sentry --no-browser

​

使用固定的 OAuth 回呼連接埠

# 使用動態用戶端註冊的固定回呼連接埠
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

使用預先設定的 OAuth 認證

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

覆寫 OAuth 中繼資料探索

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

限制 OAuth 範圍

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

使用動態標頭進行自訂身份驗證

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• 命令必須將字串鍵值對的 JSON 物件寫入 stdout
• Claude Code 在 shell 中執行命令，並在 10 秒後放棄
• Claude Code 根據 您設定伺服器的位置 選擇命令的工作目錄，因此請將指令碼作為絕對路徑提供或將其放在 PATH 上
• 動態標頭會覆寫任何具有相同名稱的靜態 headers

​

Helper 執行的位置

​

Helper 可以讀取哪些變數

• 已移除：專案 .mcp.json 或外掛程式中的伺服器，以及來自您專案或 --add-dir 目錄的代理檔案中的內聯伺服器
• 未移除：使用者 或 本機範圍 的伺服器、受管 MCP 中的伺服器、來自 claude.ai 連接器 的伺服器、由 SDK 或 --mcp-config 提供的伺服器，以及來自 ~/.claude/agents/、受管設定或使用 --agents 傳遞的代理檔案中的內聯伺服器

​

在 headersHelper 執行之前信任資料夾

• 不計算的信任：父資料夾的信任，以及 claude -p 或 SDK 工作階段為 設定檔案中的 hook 獲得的自動信任
• 直到您信任資料夾：Claude Code 僅使用其靜態 headers 連接伺服器。在 claude -p 或 SDK 工作階段中，它也會列印一個 headersHelper not run 行到 stderr，告訴您如何授予信任。
• 無對話的信任：在 ~/.claude.json 中設定 projects["<path>"].hasTrustDialogAccepted 為 true。<path> 是資料夾 專案允許規則和工作區信任 說 Claude Code 信任的鍵。

​

從 JSON 配置新增 MCP servers

# 基本語法
claude mcp add-json <name> '<json>'

# 範例：使用 JSON 配置新增 HTTP server
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# 範例：使用 JSON 配置新增 stdio server
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# 範例：使用預先配置的 OAuth 認證新增 HTTP server
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

從 Claude Desktop 匯入 MCP servers

# 基本語法 
claude mcp add-from-claude-desktop 

claude mcp list 

​

使用來自 claude.ai 的 MCP 伺服器

/mcp

• ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 處於作用中
• Amazon Bedrock 或 Google Cloud 的 Agent Platform 等第三方提供者處於作用中
• ANTHROPIC_PROFILE、federation 變數或作用中的 Anthropic 設定檔 提供認證
• CLAUDE_CODE_OAUTH_TOKEN 持有來自 claude setup-token 的權杖，該權杖只能進行模型請求

1. 執行 /login 以再次登入。
2. 從 /mcp 重新連接 connector。

​

Connectors 如何到達 Claude Code

• Cloud 工作階段：到達工作階段的 allowedMcpServers 和 deniedMcpServers 項目（例如透過 server-managed 設定）也會篩選傳遞的 connectors。工作階段的代理會重寫每個 connector 的 URL，因此為 connector 自己的 URL 編寫的 serverUrl 模式不會符合它。若要在自託管環境中的 URL allowlist 旁邊允許傳遞的 connectors，請新增 Connector 流量離開您的網路 下列出的 serverUrl 項目。當執行工作階段的主機上存在 managed-mcp.json 時（例如 self-hosted runner 主機），Claude Code 會捨棄傳遞的 connectors，無論您是否設定 allowAllClaudeAiMcps。
• 桌面應用程式本機和 SSH 工作階段：桌面應用程式將 connectors 註冊為程序內 type: "sdk" 伺服器，沒有 MCP 設定或 managed-mcp.json 到達它們。使用者可以透過在 claude.ai/customize/connectors 斷開連接來將 connector 排除在自己的工作階段之外。組織可以阻止 connector 的 工具 或完全 關閉桌面應用程式中的 Claude Code。

​

組織對 connector 工具的控制

• 工具設定為 ask：Claude Code 會在每次呼叫時提示，原因為 Your organization requires approval for this tool。即使在 acceptEdits、auto 和 bypassPermissions 權限模式 中，提示也會出現，且永遠不會提供記住您選擇的選項。符合工具的 Allow 規則 也不會跳過提示。在 dontAsk 模式中（永遠不提示），Claude Code 會改為拒絕呼叫。
• 工具設定為 blocked：Claude Code 在 Claude 看到它之前會篩選出工具，因此它永遠不會出現在工具清單中。桌面應用程式和 claude.ai 聊天應用相同的 blocked 設定，因此 Claude 也無法在那裡使用工具，您無法從桌面應用程式的工作階段中隱藏工具，同時在聊天中保持可用。桌面應用程式會跳過所有工具都被阻止的 connector。

​

停用 claude.ai connectors

{
  "disableClaudeAiConnectors": true
}

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

將 Claude Code 用作 MCP 伺服器

# 啟動 Claude 作為 stdio MCP 伺服器
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

MCP 輸出限制和警告

• 輸出警告閾值：當任何 MCP 工具輸出超過 10,000 個權杖時，Claude Code 會顯示警告
• 可配置的限制：您可以使用 MAX_MCP_OUTPUT_TOKENS 環境變數調整允許的最大 MCP 輸出權杖數
• 預設限制：預設最大值為 25,000 個權杖
• 範圍：環境變數適用於未聲明自己限制的工具。設定 anthropic/maxResultSizeChars 的工具會針對文字內容使用該值，無論 MAX_MCP_OUTPUT_TOKENS 設定為何。傳回影像資料的工具仍受 MAX_MCP_OUTPUT_TOKENS 限制
• 超過限制：當沒有影像內容的結果超過限制時，Claude Code 會將其儲存到檔案，並在對話中用命名檔案路徑的訊息取代它，以便 Claude 在需要內容時讀取該檔案。該檔案位於 ~/.claude/projects/ 下的工作階段 tool-results 目錄中。

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

提高特定工具的限制

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

工具結果中的影像

​

具有根層級組合器的工具輸入綱要

• allOf：來自每個分支的屬性會被合併，每個分支的 required 清單仍然適用
• anyOf 和 oneOf：來自每個分支的屬性會被合併，每個分支的 required 清單會在工具描述中說明，而不是由綱要強制執行

​

具有無效輸入綱要的工具

• 頂層屬性名稱必須為 1 到 64 個字元長，且只能使用 ASCII 字母和數字、_、. 和 -
• 綱要必須對 JSON Schema draft 2020-12 元綱要有效。Claude Code 會對未宣告 $schema 的綱要和宣告 draft 2020-12 的綱要套用此檢查。宣告任何其他方言的綱要會跳過此檢查，但上述屬性名稱檢查仍然適用

​

要求特定工具的批准

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

回應 MCP 徵詢請求

• 表單模式：Claude Code 顯示一個對話框，其中包含伺服器定義的表單欄位（例如，使用者名稱和密碼提示）。填入欄位並提交。
• URL 模式：Claude Code 詢問是否在您的瀏覽器中開啟連結，當您接受時會開啟它。伺服器使用此模式進行在終端外完成的流程，例如登入。

​

使用 MCP 資源

​

參考 MCP 資源

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

Compare @postgres:schema://users with @docs:file://database/user-model

​

使用 MCP 工具搜尋進行擴展

​

針對 MCP 伺服器作者

• 您的工具處理的任務類別
• Claude 應何時搜尋您的工具
• 您的伺服器提供的關鍵功能

​

設定工具搜尋

• Claude Opus 4.5、Sonnet 4.5、Haiku 4.5 及更新版本：工具搜尋預設為開啟，與 Anthropic API 上相同。
• 較早的 Agent Platform 模型：Claude Code 預先載入所有 MCP 工具，因為它們的服務堆疊拒絕所需的測試版標頭。ENABLE_TOOL_SEARCH=true 不會覆蓋此設定。

# 使用自訂 5% 閾值
ENABLE_TOOL_SEARCH=auto:5 claude

# 完全停用工具搜尋
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

​

豁免伺服器不延遲

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

使用 MCP 提示作為命令

​

執行 MCP 提示

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

Managed MCP 設定