2026 年 Claude Code MCP 設定：7 種現成設定與逐步安裝

Ailoot 的其他使用說明請參閱文件。

MCP 伺服器是什麼？Claude Code 為什麼需要它？#

Anthropic 於 2024 年 11 月 25 日宣布推出 MCP 開放標準。一年之內，這項通訊協定就成為業界標準：OpenAI、Google DeepMind 和 Microsoft 都支援它。官方的 modelcontextprotocol/servers 儲存庫包含 MCP 專案本身提供的參考伺服器（Filesystem、Memory、Sequential Thinking、Fetch 等）；GitHub、Notion、Stripe、Linear、Cloudflare 和 Sentry 等供應商則在自己的儲存庫中發布 MCP 伺服器。社群索引中收錄的伺服器數量已達數千個。

從技術上來說，MCP 透過 JSON-RPC 2.0 運作。架構很簡單：Claude Code 是用戶端，任何服務都可以是伺服器，而兩者之間的 MCP 伺服器包含三種項目：AI 可呼叫的 tools、AI 可讀取的 resources，以及現成的範本 prompts。

這對 vibe coder 之所以重要，是因為 MCP 出現以前，Claude 與每個第三方服務的連線都得個別整合，並使用各自的包裝程式。有了 MCP，連接 Postgres、Slack 和 GitHub 只要執行三個相似的命令；不再需要某項服務時，也同樣容易解除連線。

MCP 和 Skills、子代理有什麼不同？#

以下簡表可協助你釐清差異：

實用判斷方式：如果某項工作只要指定一次，之後以文字流程重複執行，它就是 Skill。如果 AI 需要外部系統的即時回應，就用 MCP。如果任務很長、分支很多，並需要另一個獨立的思考脈絡，就用子代理。

另外兩種機制的詳細介紹：Claude Code Skills：如何建立自己的程式庫和Claude Code 子代理：5 個現成範例。

Claude Code MCP 設定：5 分鐘內執行第一個命令#

官方文件中的完整語法如下：

claude mcp add <name> [options] -- <command> [args...]

支援三種傳輸方式：--transport stdio（預設值，本機程序）、--transport http（遠端 HTTP），以及 --transport sse（已標示為棄用；只有伺服器尚未遷移時才使用）。

透過 --scope 旗標可選擇三種範圍：

• local — 僅限目前的專案資料夾（預設值）。
• project — 寫入 .mcp.json、提交至儲存庫，並提供給整個團隊使用。
• user — 在這台電腦上的所有專案中全域使用。

以下是使用 MCP 專案參考 Filesystem 伺服器的最簡範例。大約半分鐘即可啟動：

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list

執行 list 後，如果命令指定的資料夾存在，清單中就會出現 filesystem；如果資料夾不存在，伺服器就無法啟動。它可以查看 Claude Code 的工作資料夾，也就是你啟動 Claude Code 的資料夾。下文 5.2 會說明原因，以及這個伺服器真正有用的情況。

若要確認 MCP 已連線，請在 Claude Code 工作階段中執行 /mcp。畫面會顯示所有伺服器、狀態和工具清單。Ailoot 的其他使用說明請參閱文件。所選 MCP 伺服器的 README 也會列出專屬命令。

stdio 還是 HTTP：該選哪種傳輸方式？#

依主要條件比較如下：

簡單原則：儲存在磁碟或本機資料庫的內容使用 stdio；雲端內容使用 HTTP。SSE 已被官方棄用，請勿選用。

適合創業者的 7 個現成 MCP 伺服器#

5.1. GitHub MCP — GitHub 官方伺服器

功能：讓 Claude Code 存取 issue、pull request、儲存庫檔案和 action 執行記錄。此伺服器為開放原始碼，在 GitHub 上有超過 30,000 顆星。

安裝（透過 OAuth 使用 HTTP）：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

如果需要使用 PAT token，而非 OAuth，也可以透過 Docker 使用 stdio。

範例：「讀取標記為 bug 的未結案 issue，依元件分類，並建議處理順序。」Claude 會呼叫 GitHub MCP，讀取所有 issue，並回傳依優先順序排列的清單。

儲存庫：github/github-mcp-server。

5.2. Filesystem MCP — MCP 專案的參考伺服器

功能：讓 AI 存取電腦上指定資料夾中的檔案。此伺服器由 MCP 專案本身發布；npm 登錄資料列出的作者是 Model Context Protocol a Series of LF Projects, LLC。

安裝（stdio），並固定版本：

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects

Claude Code 連線時，會把自己的工作資料夾傳給伺服器，並取代命令中指定的所有內容。Claude Code 的工作資料夾包括啟動時所在的資料夾，以及透過 /add-dir 命令或 --add-dir 旗標新增的資料夾。你無法透過這個命令，為伺服器指定另一個放有 mockup 的資料夾。不過，命令中的資料夾仍必須存在，否則伺服器無法啟動。

因此，在 Claude Code 中，這個伺服器大多和內建工具重複。若要存取另一個資料夾，只要使用 /add-dir 即可；新增後，Claude Code 自己的工具也能讀取該資料夾。對於沒有內建檔案存取功能的程式，這個伺服器會更有用。在 Claude Desktop 中則可能遇到另一個問題：伺服器工具使用舊版 schema 格式，因而遭到拒絕。此問題目前仍未解決。

無論在命令中或透過 /add-dir，都只授權實際需要的資料夾。不要授予磁碟根目錄的存取權，那是第一個安全漏洞。

範例：先執行 /add-dir ~/Documents/design，再說：「將 ~/Documents/design/landing-v3/ 中所有 mockup 移到目前的專案，並依照 hero-*.png 命名規則重新命名。」

5.3. Postgres MCP — DBHub（Bytebase）

功能：將 Claude 連接到 Postgres、MySQL、SQL Server、MariaDB 或 SQLite。它支援唯讀模式，避免 AI 代理只用一個命令就刪除資料庫。它常被用來取代 Anthropic 已封存的參考伺服器 server-postgres。

安裝（HTTP，唯讀）：

claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly

連接正式環境資料庫時，務必使用具有唯讀權限的獨立使用者，並透過 VIEW 或中介 API 路由匿名化個人資料。不要用具有寫入權限的帳號連接正式環境資料庫。

範例：「查詢過去一個月訂閱狀態為 expired 的客戶，並列出付款總額最高的前 20 名。」

儲存庫：bytebase/dbhub。

5.4. Slack MCP — 團隊溝通

功能：讓 Claude 讀取 Slack 頻道並傳送訊息。適合用於自動化，例如：「建置成功後，在 #releases 發文」或「從 #engineering 整理每週摘要」。

安裝（透過 npx 包裝程式使用 stdio，例如 @modelcontextprotocol/server-slack 或供應商提供的同類工具）：

claude mcp add slack \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -e SLACK_TEAM_ID=T0... \
  -- npx -y @modelcontextprotocol/server-slack

授權使用 Slack Bot Token；可在 Slack 端透過 scopes 限制存取權。只授予 AI chat:read 和 chat:write:user，它就無法編輯工作區設定。生態系變化很快，請查看所選伺服器的 README，確認目前的命令。

範例：「每天早上 9:00 將前一天已合併的 PR 清單傳送到 #daily。」

5.5. Notion MCP — 知識庫

功能：讓 Claude 存取 Notion 頁面和資料庫。它是專案之外的知識庫：如果你在那裡保存筆記、客戶名冊或編輯方針，AI 就能讀取。

安裝（透過 OAuth 使用 HTTP）：

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

也可以改用 Anthropic 官方的 @makenotion/claude-code-notion-plugin 外掛程式。

範例：「在 Notion 的『Customers』資料庫中，找出狀態為『active』且超過兩週沒有通話的人，並為每個人草擬一封電子郵件。」

Notion 指南：developers.notion.com/guides/mcp。

5.6. Sentry MCP — 錯誤追蹤

功能：將 Claude 連接到正式系統中的錯誤。網頁發生 500 錯誤時，你可以問：「顯示這個專案在 Sentry 中最新的 10 個問題，並說明每個問題的根本原因。」Claude 就會立即提供分析。

安裝（HTTP）：

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

授權透過 Sentry OAuth 進行。存取權可限制在特定專案。

範例：「找出過去 24 小時最常發生的三個問題，用淺白英文說明發生了什麼，並建議修正方法。」

儲存庫：getsentry/sentry-mcp。

5.7. Playwright MCP — 瀏覽器工作流程

功能：讓 Claude 使用瀏覽器。AI 可以開啟網頁、點擊、填寫表單並擷取螢幕截圖。適合用於 UI 檢查、發布後的手動測試和工作流程解析。

安裝（stdio）：

claude mcp add playwright -- npx -y @playwright/mcp@latest

2026 年 5 月 7 日發布的 v0.0.75 版本由 Microsoft 積極維護（超過 32,000 顆星）。

範例：「開啟我們網站的首頁，檢查所有卡片是否正確顯示，並擷取桌面和手機版的螢幕截圖。」

儲存庫：microsoft/playwright-mcp。

請查看所選 Playwright MCP 版本的 README，了解如何使用固定版本的命令、多個並行工作階段所需的旗標，以及常見的安裝錯誤。

如何使用 PreToolUse Hook 控管安全性#

SQL 前綴黑名單不是唯讀權限邊界：小寫、註解、UPDATE、INSERT、ALTER、多敘述及有副作用函式，都不受三個大寫前綴涵蓋。資料庫應給獨立唯讀角色，在可丟棄測試資料庫驗證 grants；hook 只是額外工具呼叫控制。

以下刻意採窄範圍隔離範例：在審查及測試更具體政策之前，拒絕三個具名 MCP 家族的全部呼叫，讀寫都阻擋。請匹配實際伺服器／工具名；更名伺服器、內建 Bash 或其他 connector 不在範圍。將各規則放在 .claude/settings.json：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}

指令碼存為 .claude/hooks/deny-unapproved-mcp.sh。它遵循官方 PreToolUse 決策契約，不是舊的頂層 decision: approve/block：

#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'

腳本不解析或分類 SQL，匹配呼叫一律拒絕。連接珍貴資料前先隔離測試：工具名匹配時，SELECT 1、小寫 delete、註解開頭 UPDATE、Slack 讀取或傳送，以及 Filesystem .env 讀取都須被拒。其他家族工具不在範例內，應明確驗證該獨立邊界。

允許資料庫唯讀工作時，採已驗證 grants，再以審查後真實工具政策取代隔離。Slack 只讀任務用無發送權憑證；檔案則限制允許根目錄與程序權限。不要宣稱這個 hook 能擋其他工具、shell、提示附件或代理能改寫的政策檔。

Claude Code 的 Plan Mode 指南也更詳細地介紹了相同方法，內容包含類似的「執行前檢查」邏輯。

工具超過 40 個，Claude 搞不清楚時該怎麼辦？#

根據 Claude Code 文件，目前此功能預設已啟用，不需要手動開啟。

以下情況例外，Claude Code 會立即載入所有工具：透過第三方 proxy 工作（ANTHROPIC_BASE_URL 設為 Anthropic 以外的位址）、在 Google Cloud 使用低於 4.5 世代的模型，以及在 Azure 上部署 Microsoft Foundry。ENABLE_TOOL_SEARCH 變數可以改變行為：

• 未設定 — 延後載入所有 MCP 工具，需要時才載入。
• true — 行為相同，另外 Claude Code 會嘗試透過 proxy 啟用搜尋。
• auto — 門檻模式：所有工具說明加起來不到上下文視窗的 10% 時，立即載入；超過後則延後載入。
• auto:N — 行為相同，但可自訂百分比門檻，例如 auto:5。
• false — 舊版行為；立即將所有工具放入上下文。

若有重要工具必須永遠保持可見，可在 .mcp.json 中伺服器說明旁加入 alwaysLoad: true 旗標。這類工具從一開始就會占用上下文，因此只應用於 Claude 幾乎每次回應都需要的工具。

如果有五個以上的 MCP 伺服器，而且 Claude 會搞不清楚該呼叫哪個工具，請先確認搜尋功能是否遭到停用：查看設定中是否有 ENABLE_TOOL_SEARCH=false，並確認目前是否透過 proxy 工作。

你也可以參考使用 /compact 減少上下文。

什麼時候不需要 MCP：Skill、子代理或 CLI 哪個更合適？#

依 token 成本和複雜度排列如下：

1. 透過 Bash 執行 CLI 命令 — 幾乎免費。AI 執行 gh pr list、psql -c 或 curl，取得和一般終端機使用者類似的回應。
2. Skill — 成本低。這是附有操作指示的現成提示詞範本，說明要呼叫什麼，以及如何處理結果。符合資料夾名稱中的觸發條件時載入。
3. 子代理 — 中等。為長時間任務提供獨立上下文，並使用自己的 token 工作階段。
4. MCP 伺服器 — 成本高。上下文中只保留工具名稱，但 Claude 找到工具並準備呼叫前，會載入工具說明；服務回應也可能很長：Claude Code 會在工具回應超過 10,000 個 token 時發出警告。使用 HTTP 時還需要 OAuth 工作階段。

一個反直覺的建議：解析網頁、使用 git、開啟 PDF，以及使用開放原始碼工具時，請選 CLI，不要選 MCP。AI 呼叫終端機命令和人一樣容易，而且 token 只花在命令與命令回應上，不需要負擔工具說明或伺服器額外開銷。

以下兩種情況適合使用 MCP：

• 服務是封閉式的：例如 Slack、Notion、Sentry、Linear。雖然也有 CLI 工具，但 MCP 透過 OAuth 和 scope 控制，可提供更細緻的存取權。
• 需要即時雙向互動：AI 連接 Postgres、檢查 schema、提出後續查詢、取得資料，再採取下一步動作。若使用 CLI，就得手動執行 10 個命令。

MCP 連線的 6 個反模式#

1. MCP 工具櫃。 你抱著「以防萬一」的心態連接了 10 個伺服器，結果 Claude 搞不清楚該呼叫哪個工具，而且伺服器回應塞滿上下文。解決方法：目前的專案只保留 3–5 個伺服器，並使用 claude mcp remove 移除其餘伺服器。

2. 正式資料庫的寫入權限。 你在連接 Postgres MCP 與正式資料庫時，沒有使用 --readonly、獨立使用者或允許清單 hook。只要一個提示詞「刪除測試記錄」，正式資料就會被刪除。解決方法：獨立資料庫角色搭已驗證唯讀 grants、適用時使用伺服器唯讀模式，以及經測試工具呼叫控制；DROP|TRUNCATE|DELETE 前綴黑名單不足以授權。

3. 未匿名化的個人識別資訊（PII）。 你直接連接了含有客戶電子郵件、電話號碼和護照資料的資料庫。Claude 會看到這些資料，而資料也會進入 Anthropic 的記錄。解決方法：使用 VIEW 或中介 API 路由，回傳 j***@gmail.com 這類遮罩後的資料。

4. 用 MCP 取代 Skill。 你需要「建立 X 格式的銷售報告」；這是用現成提示詞 Skill 就能處理的例行工作。不要為此建立 MCP 伺服器。

5. 用 MCP 取代開放原始碼 CLI。 你需要將 PDF 轉成文字，而 pdftotext 就能做到。不要建立「PDF MCP」，那只會浪費 token。

6. 沒有追蹤 token 成本。 你可以在 claude mcp list 查看已連接的伺服器，卻看不到每次對話用了多少資源。一週後，你才發現「MCP 消耗了 40% 的上下文，而我一直都在為此付費」。解決方法：定期停用未使用的伺服器，並透過 Claude Code 使用量限制追蹤觀察使用量的變化。

MCP 連線失敗時如何除錯#

逐步檢查清單：

1. 伺服器是否顯示在清單中？

   claude mcp list
   

   如果沒有，表示 claude mcp add 未完成。最常見的原因是 --scope：你在 local 範圍中新增了伺服器，卻從另一個專案檢查。

2. 伺服器狀態是否為綠色？

   claude mcp status <name>
   

   紅色表示程序未啟動（stdio），或伺服器沒有回應（HTTP）。

3. 伺服器記錄中有沒有有用的資訊？

   claude mcp logs <name>
   

   如果看到 stack trace，問題通常出在套件上（npx 找不到套件，或 Node 版本低於 20）。

4. OAuth callback 是否沒有返回？ 問題通常在 --callback-port 或網路過濾器。請轉送指定的連接埠：

   claude mcp add --transport http --callback-port 8765 [name] [url]
   

5. 工具名稱是否衝突？ 兩個伺服器提供相同名稱的工具，Claude 因而呼叫錯誤的工具。請使用 Tool Search（參閱前一個 H2），或以 claude mcp remove 手動移除多餘的伺服器。

6. 看不到 claude.ai 擴充功能（連接器）？ 這是已知問題：使用 API key 時，claude.ai 網頁介面中的擴充功能（連接器）無法在 Claude Code 中使用。解決方法：透過 CLI 而非網頁介面連接 MCP。

接下來：OAuth、自建 MCP 伺服器與外掛程式市集#

對不想記住安裝命令的人來說，Plugin Marketplace 可以加快設定流程。其格式是 .claude-plugin/marketplace.json manifest，可在一個套件中描述一組伺服器。

從市集中安裝外掛程式：

claude plugin install <plugin-name>

一個外掛程式可同時包含多個 MCP 伺服器、Skills 和子代理，為特定情境（例如電子商務、行銷或法務部門）打包一套設定。

依據 modelcontextprotocol.io 規格撰寫自己的 MCP 伺服器。最小範本會使用 Anthropic 的 Python 或 TypeScript SDK；接著描述工具並連接傳輸方式。其複雜度大致相當於使用 FastAPI 撰寫 REST API。

如果專案已經有設定好的 CLAUDE.md，也了解上下文工程，新增自建 MCP 只要一天。若還沒有，最好先學好基礎。

若要繼續使用各種模型，請前往 Ailoot。