喺 Claude Code 度點樣安全噉用 MCP

喺 Claude Code 度點樣安全噉用 MCP

2026年5月18日
123 次閱讀
claude-code mcp mcp-server security oauth scope ai-agent developer-tools

嗨,我係 Lena。MCP 已經唔再係新概念,但要喺 Claude Code 度將一個 server 真正接好、又唔踩到坑,入面嘅彎彎曲曲比大多數人預期嘅多。

過去幾個月我一直用 Claude Code 加唔同嘅 MCP server 做日常開發——由 GitHub 到 Sentry,再到自己寫嘅內部 database 查詢工具,全部跑過。講真,接入呢件事本身唔難——難嘅係搞清楚邊樣可以信、OAuth 死咗去邊度查、scope 究竟係點工作。 呢篇文章係我踩過嘅坑同我翻官方文檔翻出嚟嘅細節,寫畀已經用緊 Claude Code、準備接 MCP server 嘅 developer。

接 MCP server 之前要先睇嘅幾樣嘢

Claude Code 嘅版本同平台支援

先睇版本。OAuth 相關嘅行為要 v2.1.64 之後先穩定落嚟——嗰個版本先加咗 authServerMetadataUrl 嘅支援。再老啲嘅版本同 remote server 認證時會直接拋錯。Windows 度仲有一個known issue:claude mcp add-json 加 HTTP server 嘅時候間中會返 "Invalid input"。官方 MCP 文檔建議撞到呢種情況就回退用 claude mcp add --transport http 嗰種寫法。

MCP 喺 Claude Code 入面到底可以做啲乜

MCP 將 Claude Code 由一個只可以讀寫本地檔案、跑 bash 嘅工具,升級做一個可以直接同外部系統溝通嘅 agent——拉 Jira ticket、開 GitHub PR、去 Sentry 查 production 報錯,全部都係佢嘅活。但有個細節成日畀人忽略:MCP server 之間係完全隔離嘅。 冇 passthrough,每一層都係獨立嘅。

Tools、resources、prompts

按 MCP 規範所講,一個 server 可以暴露三類能力:tools(可執行嘅動作)、resources(可讀嘅資料源)、prompts(預設嘅互動模板)。/mcp 面板會顯示每個已接 server 嘅工具數量,仲會將嗰啲聲明咗 tools capability、但實際冇暴露任何工具嘅 server 標出嚟。

一步步將第一個 MCP server 加入嚟

用 CLI 加 server

Claude Code 支援三種 transport 類型:HTTP(建議用喺遠端服務)、SSE(已棄用,可以避就避)、stdio(本地進程)。

Bash
# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Local stdio server
claude mcp add --transport stdio --env API_KEY=your_key myserver \
  -- npx -y my-mcp-server

呢度有個最易絆親人嘅細節:所有 option 都要寫喺 server name 前面。 雙橫線 -- 係用嚟將 Claude 自己嘅 flag 同傳畀 MCP server 進程嘅 argument 分開。次序寫錯,命令會靜默失敗。呢個坑我自己踩過唔止一次。

用 .mcp.json 同團隊共用

用 --scope project 可以將設定寫入一個 .mcp.json 檔案,commit 入 version control 同隊友共用。千祈唔好將真嘅 token 直接寫入呢個檔案——用環境變數 reference 代替。同名 server 喺 local scope 會覆蓋 project scope,呢個做法可以保住憑證唔外洩。

確認 server 真係連上咗

喺 Claude Code 度跑 /mcp 睇狀態同工具數量。由 v2.1.121 開始,HTTP/SSE server 第一次連接會自動重試最多三次,但認證錯誤同 404 唔會 retry——呢類錯只可以改設定先得。

第一次調用時審批

新 server 第一次畀調用嘅時候,Claude Code 會彈一個權限確認。呢個係設計上嘅信任校驗。Claude Code 安全文檔寫得好清楚:新接入嘅 MCP server 必須要用戶確認。可以單次允許,又可以揀 "Always allow" 直接加入 allowlist。

認證同 OAuth 流程

需要 OAuth token 嘅 server

大多數 remote server——GitHub、Slack、Notion 呢類——都要 OAuth。Claude Code 內建 OAuth 2.1 支援,整個流程基本上係自動嘅:server 返 401,Claude Code 先按 RFC 9728 Protected Resource Metadata 去搵 OAuth metadata,搵唔到就回退去 RFC 8414;如果支援 Dynamic Client Registration,就自動 register 成個 client,瀏覽器彈出嚟畀用戶授權,跟住攞返 token。

如果 server 唔支援 Dynamic Client Registration,你會見到 "Incompatible auth server" 呢個錯。咁就要去 server 嘅 developer 後台手動 register 一個 OAuth app,攞 client ID 同 secret,再用 --client-id 同 --client-secret 加 server。有啲 server 仲會要求固定嘅 callback 端口——用 --callback-port 對返你 register 嘅 redirect URI。

憑證擺喺邊、點樣輪換

Token 擺喺系統嘅安全憑證庫度——macOS 係 Keychain,其他平台係加密嘅憑證檔案。佢從來唔會以明文形式落到 config 檔案度。 要輪換嘅話,打開 /mcp 重新對相關 server 做一次認證就得。SSH 環境冇瀏覽器嗰陣,Claude Code 會顯示一個 "Paste code here" 嘅提示,等你喺另一部機完成授權之後將結果貼返入嚟。

唔好畀 token 喺共享配置度漏出去

呢點我要講得直接啲——我見過唔止一個團隊將 hard-code 咗 token 嘅 config 推上公開 repo。憑證永遠要用 ${ENV_VAR} reference。 企業環境裏面,admin 可以下發一份 managed-mcp.json,用 allowlist 同 denylist 控制邊啲 server 可以用。

信任一個 server 之前要睇嘅安全邊界

MCP server 喺你部機度可以讀到啲乜

stdio 類型嘅 server 跑喺你當下用戶嘅權限下,呢點好多 developer 冇認真諗過。理論上佢可以讀你嘅 .env、SSH key、AWS 憑證——所有你呢個 account access 到嘅嘢。Claude Code 自己都有啲防護——寫操作被限制喺 working directory 內,網絡請求要審批。Anthropic 工程團隊嘅安全 blog詳細寫咗 sandboxing 機制,文件系統隔離同網絡隔離係配合工作嘅。佢哋內部數據顯示,sandboxing 將權限提示減少咗 84%,呢個對日常工作流嚟講差別好大。

佢可以執行啲乜、寫啲乜

MCP tool 可以包含任意嘅執行能力。一個駁喺生產 database 度嘅 "run SQL" 工具,係真係會對生產數據執行查詢嘅。呢個唔係假設——我見過有 setup:一個配置唔啱嘅 tool 攞到對線上客戶 database 嘅寫權限。接任何 server 之前,你要清清楚楚知道佢暴露咗邊啲 tool、每個 tool 實際做到啲乜。 唔肯定嘅就留喺 ask mode,唔好貪方便自動批准。

審批之前要審嘅幾樣

喺信任一個 server 之前,我通常做三件事:睇源碼(去 GitHub 睇主入口檔案,確認佢實際做緊乜)、評估維護狀態(一個三日前先發布嘅 package,同一個維護咗兩年嘅 package——風險完全係兩個層次)、睇權限聲明(按 MCP 授權規範,server 應該聲明自己要嘅 scope——任何超出合理邊界嘅都要警惕)。

常見問題同點樣修

server 加完之後唔出現

最常見嘅原因:scope 寫錯咗。 喺項目 A 目錄度用 --scope local 加嘅 server,切到項目 B 就睇唔到。用 claude mcp list 確認 scope,要全域可用就轉 --scope user。仲有一樣要留意嘅:workspace 係保留名,用佢做 server name 會畀跳過,仲會出 warning。

tool 調用靜默失敗

先睇下 output 係咪超咗預設 10,000 token 嘅上限。Claude Code 超限會出 warning,但好易漏睇。設 MAX_MCP_OUTPUT_TOKENS=50000 可以拉高上限。另一個可能性係連接斷咗——HTTP/SSE server 會用 exponential backoff 自動重連(最多 5 次),但 stdio server 唔會自動重連。

local 同 project 設定衝突

同名 server 同時喺 local 同 project scope 度時,local 覆蓋 project。 呢個係設計如此,但你唔知就會奇怪點解 .mcp.json 嘅改動唔生效。用 claude mcp get <name> 睇實際生效嘅係邊個設定。

每次新會話都要重新批准權限

如果當初冇揀 "Always allow",審批唔會留低。用 /permissions 管理你嘅永久 allowlist。Claude Code GitHub repo 有 PreToolUse hooks 嘅文檔,可以做更細粒度嘅自動審批邏輯。

連上之後仲唔夠嘅地方

MCP 畀嘅係工具,但保唔住已經行得通嘅方案

呢個係我日常用落感受最深嘅一個局限。MCP 解決嘅係「連接」問題——佢解決唔到「記憶」問題。可能你今日花 20 分鐘將一套 database 查詢加報表生成嘅 workflow 調好,聽日打開新 session,所有 context 都冇晒。你要重新解釋要 query 邊啲表、output 咩格式、處理邊啲 edge case。MCP 協議冇任何 session 持久化機制,每一次連接都係無狀態嘅。呢個唔係 bug——呢條係設計邊界。

點解團隊仲喺度跨 session、跨機器重複修同一件事

Developer A 摸清咗某個 server 嘅正確用法,磕過某個 edge case,將流程跑順。但呢份辛苦換返嚟嘅知識冇地方落腳。一個禮拜後 Developer B 加入項目,撞到嘅係一模一樣嘅問題,花嘅係一模一樣嘅 debug 時間。.mcp.json 共享嘅係 configuration——唔係「點樣用」同「上次壞咗我哋點修」。CLAUDE.md 檔案可以緩解一部分,但佢係靜態嘅、要手動維護。MCP 將自己分內嘅事做得好好,但只要 workflow 稍為複雜啲,遲早會撞到 context 流失同經驗重複嘅問題。

FAQ

MCP 同 plugin 係咪同一樣嘢?

唔完全係。MCP 係一個開放嘅協議標準,定義嘅係 AI 應用點同外部工具溝通。Plugin 係 Claude Code 一個更上層嘅概念,可以包含 MCP server 設定以及其他類型嘅 extension。Anthropic 嘅官方發布頁有 MCP 最早嘅 launch post。

用 MCP server 要 API key 嗎?

睇個 server 點。本地 stdio server 通常唔需要任何認證。Remote HTTP server 一般要憑證——要麼 Bearer token(用 --header 傳),要麼 OAuth(自動處理)。

隊友睇唔睇到我嘅 MCP server?

只有 --scope project 嘅設定會寫入 .mcp.json 畀團隊睇到。local(預設)同 user scope 都係私人嘅。

local、project、user scope 有咩分別?

local(預設):只對你、只喺當前項目目錄可見。project:寫入項目根目錄嘅 .mcp.json,透過版本控制同成個團隊共享。user:對你、喺你部機上嘅所有項目可見。要留意舊版本入面 local 叫 "project"、user 叫 "global"——名稱後嚟改過,唔好畀啲舊 blog 或者舊 guide 嗰啲舊叫法搞亂。

點解 Claude Code 成日要我重新批准同一個 tool?

新 session 預設唔會繼承臨時批准。用 "Always allow" 或者 /permissions 將 tool 加入永久 allowlist。企業 setup 入面,managed-settings.json 嘅 deny rule 會覆蓋你本地嘅 allow rule,呢個亦都會令到反覆被拒。

Previous Posts:

相關文章