管理跟分享 MCP Server
用 scope 組織 server、跟團隊分享
⏱ 預估 ~5 分鐘
01 · 讀一讀
你加 MCP server 時，選一個 scope 決定誰能看、存哪。
Local(預設)— 私人，只在目前專案。存在 ~/.claude.json 你專案路徑下。用在個人開發 server 或有敏感憑證的 server。
Project — 透過 repo root 的 .mcp.json 跟團隊共享。Commit 到 git,clone repo 的每個人拿到同樣 server。團隊標準工具用這個。
User — 你所有專案都能用。存在 ~/.claude.json。適合你到處用的個人工具（像 GitHub 或個人資料庫）。
重點整理
- Local(預設)：私人，只目前專案
- Project：透過 repo 裡的 .mcp.json 跟團隊共享、commit 到 git
- User：個人，所有你的專案都能用
- 用 --scope local|project|user 選
02 · 看程式碼
--scope 旗標控制 server 設定存哪。
Local scope(預設 — 只你、這個專案)
claude mcp add --transport http stripe https://mcp.stripe.com
Project scope(透過 git 跟團隊共享)
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
User scope(你、所有專案)
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/
Local 是預設 — 你不用 --scope local。Project scope 在你 repo 建一個 .mcp.json 檔，隊友 pull 時拿到。User scope 放在家目錄設定，跟著你到處跑。
03 · 看程式碼
你用 --scope project 時，Claude Code 在你 repo root 建一個 .mcp.json 檔。長這樣 — 你可以 commit 到 git。
.mcp.json(commit 到 repo)
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"db": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}
注意 ${DATABASE_URL} 語法 — 環境變數在執行時展開，你可以分享設定不曝露秘密。每個隊友在自己環境設 DATABASE_URL。檔案結構照 Claude Code 自動讀的標準格式。
04 · 讀一讀
Server 設定好後，你用幾個簡單指令管理。
claude mcp list 顯示所有 server。claude mcp get <name> 顯示一個 server 細節。claude mcp remove <name> 移除 server。
在 Claude Code 裡，打 /mcp 看 server 狀態、跟 OAuth server 驗證、或排除連線問題。Server 沒回應時，/mcp 是你第一個診斷的地方。
重點整理
- claude mcp list — 看所有設定的 server
- claude mcp get <name> — 一個 server 的細節
- claude mcp remove <name> — 移除 server
- /mcp 在 Claude Code 裡 — 狀態、auth、排除問題
05 · 選擇題
你團隊每個人都要用同一個 Sentry MCP server。你要設定 commit 到 git，新團員自動拿到。用哪個 scope?
- Local(預設)
- Project
- User
- Global
06 · 分類拖拉
你有三個不同 MCP server 要設。配對每個到對的 scope，看誰需要。
(本節為互動練習，請啟用 JavaScript 體驗)
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案，非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。