# 2026 年 Claude Code MCP 設定：7 種現成設定與逐步安裝 > Claude Code MCP 設定指南：用 claude mcp add 在 5 分鐘內連線，認識 7 個伺服器、stdio 與 HTTP、專案設定範圍，並透過 hooks 設定允許清單。 Source: https://ailoot.ai/blog/zh-hant-tw/mcp-servers-claude-code/ Canonical: https://ailoot.ai/blog/zh-hant-tw/mcp-servers-claude-code/ Language: zh-Hant-TW Publisher: Ailoot (https://ailoot.ai/) Translation: guide-172 Revision: sha256-5b3c5dc059b87f5bd4b5cd1cc9ae4d35aa4986e313e0cf17cf8d13765858e568 Ailoot 的其他使用說明請參閱[文件](https://ailoot.ai/docs/)。 ## MCP 伺服器是什麼？Claude Code 為什麼需要它？
重點 MCP（Model Context Protocol）是 Anthropic 推出的開放標準，讓 Claude Code 能透過統一介面存取外部工具與資料。它用一個通訊協定取代十種不同的 API。Anthropic 稱它為「AI 應用程式的 USB-C」：接上連接埠，Claude 就能查看你的資料庫、電子郵件、通訊軟體或程式碼儲存庫。
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`。
USB-C 提供連接各種周邊裝置的標準方式；同樣地，MCP 提供連接 AI 模型與各種資料來源和工具的標準方式。
— Model Context Protocol，https://modelcontextprotocol.io/
這對 vibe coder 之所以重要，是因為 MCP 出現以前，Claude 與每個第三方服務的連線都得個別整合，並使用各自的包裝程式。有了 MCP，連接 Postgres、Slack 和 GitHub 只要執行三個相似的命令；不再需要某項服務時，也同樣容易解除連線。 ## MCP 和 Skills、子代理有什麼不同？
重點 這三種機制看起來相似，但解決的是不同問題。Skills 是以程式碼形式保存的工作流程和提示詞。子代理是各自擁有獨立上下文的專業「同事」。MCP 則透過外部工具，讓 Claude 存取服務和資料。它們的 token 成本也不同：Skill 最便宜，MCP 通常較貴。MCP 一開始只會把工具名稱和伺服器指示放進上下文；Claude 需要時才載入完整說明。大部分成本來自服務回應：內容可能很長，而且會留在對話中。
以下簡表可協助你釐清差異： | 機制 | 說明 | 適用情境 | Token 成本 | |----|----|----|----| | Skill | `.claude/skills/` 中放有指示和提示詞的檔案 | 重複執行某個工作流程：寫電子郵件、整理報告、發布貼文 | 低。符合觸發條件時載入 | | 子代理 | 擁有自身上下文和工具的獨立代理 | 長時間的並行任務：審查、稽核、研究 | 中。使用自己的上下文 | | MCP 伺服器 | 透過 JSON-RPC 提供工具和資源的服務 | 需要即時存取資料：資料庫、電子郵件、通訊軟體、儲存庫 | 中或高。只有工具名稱留在上下文中；需要時才載入說明，而且服務回應可能很長 | 實用判斷方式：如果某項工作只要指定一次，之後以文字流程重複執行，它就是 Skill。如果 AI 需要外部系統的即時回應，就用 MCP。如果任務很長、分支很多，並需要另一個獨立的思考脈絡，就用子代理。 另外兩種機制的詳細介紹：[Claude Code Skills：如何建立自己的程式庫](https://ailoot.ai/blog/zh-hant-tw/claude-code-skills-library/)和[Claude Code 子代理：5 個現成範例](https://ailoot.ai/blog/zh-hant-tw/claude-code-subagents/)。 ## Claude Code MCP 設定：5 分鐘內執行第一個命令
重點 所有情況都使用相同語法：`claude mcp add [name] -- [launch command]`。伺服器會出現在 `claude mcp list` 清單中。接著 Claude 會探索伺服器提供的工具，並在對話中開始使用。不必手動編輯設定，一切都透過 CLI 完成。
官方文件中的完整語法如下： ```bash claude mcp add [options] -- [args...] ``` 支援三種傳輸方式：`--transport stdio`（預設值，本機程序）、`--transport http`（遠端 HTTP），以及 `--transport sse`（已標示為棄用；只有伺服器尚未遷移時才使用）。 透過 `--scope` 旗標可選擇三種範圍： - `local` — 僅限目前的專案資料夾（預設值）。 - `project` — 寫入 `.mcp.json`、提交至儲存庫，並提供給整個團隊使用。 - `user` — 在這台電腦上的所有專案中全域使用。 以下是使用 MCP 專案參考 Filesystem 伺服器的最簡範例。大約半分鐘即可啟動： ```bash 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 的其他使用說明請參閱[文件](https://ailoot.ai/docs/)。所選 MCP 伺服器的 README 也會列出專屬命令。 ## stdio 還是 HTTP：該選哪種傳輸方式？
重點 stdio 是在你電腦上執行的本機程序，不需要網路，也不需要 OAuth。HTTP 是遠端服務，透過 token 或 OAuth 存取，並可在不同裝置間共用。若透過 `npx` 或 `uvx` 安裝 MCP 伺服器，就使用 stdio。若服務有自己的公開服務位址，就使用 HTTP。SSE 已被官方標示為棄用，請勿依賴它。
依主要條件比較如下： | 條件 | stdio | HTTP | |----|----|----| | 執行位置 | 本機（Claude Code 的子程序） | 遠端伺服器 | | 授權 | 不需要 | OAuth 2.1 或 Bearer token | | 網路連接埠 | 無 | 公開位址 | | 使用情境 | Filesystem、Postgres、本機工具 | GitHub、Slack、Notion、Linear、Sentry | | 重新連線 | 不需要 | 指數退避，最多 5 次嘗試 | | 部署方式 | 在本機安裝套件 | 供應商的服務 | 簡單原則：儲存在磁碟或本機資料庫的內容使用 stdio；雲端內容使用 HTTP。SSE 已被官方棄用，請勿選用。 ## 適合創業者的 7 個現成 MCP 伺服器
重點 以下七種設定涵蓋 vibe coder 80% 的工作：程式碼（GitHub）、檔案（Filesystem）、資料庫（透過 DBHub 連接 Postgres）、團隊溝通（Slack）、知識庫（Notion）、錯誤追蹤（Sentry），以及瀏覽器工作流程（Playwright）。每種設定都附上一行安裝命令，以及實際對話中可以如何要求 Claude 完成工作的範例。
### 5.1. GitHub MCP — GitHub 官方伺服器 功能：讓 Claude Code 存取 issue、pull request、儲存庫檔案和 action 執行記錄。此伺服器為開放原始碼，在 GitHub 上有超過 30,000 顆星。 安裝（透過 OAuth 使用 HTTP）： ```bash 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](https://github.com/github/github-mcp-server)。 ### 5.2. Filesystem MCP — MCP 專案的參考伺服器 功能：讓 AI 存取電腦上指定資料夾中的檔案。此伺服器由 MCP 專案本身發布；npm 登錄資料列出的作者是 Model Context Protocol a Series of LF Projects, LLC。 安裝（stdio），並固定版本： ```bash 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，唯讀）： ```bash claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly ``` 連接正式環境資料庫時，務必使用具有唯讀權限的獨立使用者，並透過 VIEW 或中介 API 路由匿名化個人資料。不要用具有寫入權限的帳號連接正式環境資料庫。 範例：「查詢過去一個月訂閱狀態為 `expired` 的客戶，並列出付款總額最高的前 20 名。」 儲存庫：[bytebase/dbhub](https://github.com/bytebase/dbhub)。 ### 5.4. Slack MCP — 團隊溝通 功能：讓 Claude 讀取 Slack 頻道並傳送訊息。適合用於自動化，例如：「建置成功後，在 `#releases` 發文」或「從 `#engineering` 整理每週摘要」。 安裝（透過 npx 包裝程式使用 stdio，例如 `@modelcontextprotocol/server-slack` 或供應商提供的同類工具）： ```bash 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）： ```bash 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](https://developers.notion.com/guides/mcp/get-started-with-mcp)。 ### 5.6. Sentry MCP — 錯誤追蹤 功能：將 Claude 連接到正式系統中的錯誤。網頁發生 500 錯誤時，你可以問：「顯示這個專案在 Sentry 中最新的 10 個問題，並說明每個問題的根本原因。」Claude 就會立即提供分析。 安裝（HTTP）： ```bash claude mcp add --transport http sentry https://mcp.sentry.dev/mcp ``` 授權透過 Sentry OAuth 進行。存取權可限制在特定專案。 範例：「找出過去 24 小時最常發生的三個問題，用淺白英文說明發生了什麼，並建議修正方法。」 儲存庫：[getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp)。 ### 5.7. Playwright MCP — 瀏覽器工作流程 功能：讓 Claude 使用瀏覽器。AI 可以開啟網頁、點擊、填寫表單並擷取螢幕截圖。適合用於 UI 檢查、發布後的手動測試和工作流程解析。 安裝（stdio）： ```bash claude mcp add playwright -- npx -y @playwright/mcp@latest ``` 2026 年 5 月 7 日發布的 v0.0.75 版本由 Microsoft 積極維護（超過 32,000 顆星）。 範例：「開啟我們網站的首頁，檢查所有卡片是否正確顯示，並擷取桌面和手機版的螢幕截圖。」 儲存庫：[microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)。 請查看所選 Playwright MCP 版本的 README，了解如何使用固定版本的命令、多個並行工作階段所需的旗標，以及常見的安裝錯誤。 ## 如何使用 PreToolUse Hook 控管安全性
重點 MCP 讓 AI 擁有很大的權限：可以寫入資料庫、傳送訊息和刪除檔案。PreToolUse hook 可控制匹配工具呼叫，但 SQL 前綴 regex 不是資料庫授權，只有 Postgres matcher 也不涵蓋 Slack 或檔案。先用真實服務與檔案權限，再分開測 hook 的確切範圍。
SQL 前綴黑名單不是唯讀權限邊界：小寫、註解、`UPDATE`、`INSERT`、`ALTER`、多敘述及有副作用函式，都不受三個大寫前綴涵蓋。資料庫應給獨立唯讀角色，在可丟棄測試資料庫驗證 grants；hook 只是額外工具呼叫控制。 以下刻意採窄範圍**隔離範例**：在審查及測試更具體政策之前，拒絕三個具名 MCP 家族的全部呼叫，讀寫都阻擋。請匹配實際伺服器／工具名；更名伺服器、內建 Bash 或其他 connector 不在範圍。將各規則放在 `.claude/settings.json`： ```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 決策契約](https://code.claude.com/docs/en/hooks#pretooluse-decision-control)，不是舊的頂層 `decision: approve/block`： ```bash #!/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](https://ailoot.ai/blog/zh-hant-tw/claude-code-plan-mode/) 指南也更詳細地介紹了相同方法，內容包含類似的「執行前檢查」邏輯。 ## 工具超過 40 個，Claude 搞不清楚時該怎麼辦？
重點 七個伺服器很容易帶來 50–100 個工具。Claude Code 預設使用 Tool Search：啟動時，只有工具名稱和伺服器指示會進入上下文；Claude 需要某個工具時才載入完整說明。如果搜尋功能關閉，所有說明會一次載入；工具數量超過約 40 個後，Claude 就開始混淆：不是選錯工具，就是在一般命令就能處理的情況下改用 MCP。
根據 [Claude Code 文件](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)，目前此功能預設已啟用，不需要手動開啟。 以下情況例外，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 減少上下文](https://ailoot.ai/blog/zh-hant-tw/claude-code-token-limits-saving/)。 ## 什麼時候不需要 MCP：Skill、子代理或 CLI 哪個更合適？
重點 以 token 成本而言，MCP 是提供 Claude 外部能力最昂貴的方式。如果現成 CLI 工具（`gh issue list`、`psql`、`curl`）或一頁式 Skill 就能處理工作，請改用它們，不要建立 MCP 伺服器。原則是：只有 AI 需要與服務即時雙向互動時，MCP 才值得使用；若只需要一次性的回應，就不需要 MCP。
依 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 個反模式
重點 以下是 vibe coder 剛開始使用 MCP 的頭幾週最容易遇到的六種具體錯誤。每種反模式都可以在一分鐘內檢查：開啟 `claude mcp list`、檢視清單，並確認 scopes 和 hooks。大部分問題只要移除不必要的伺服器即可解決，不必再新增伺服器；本節是一份由上而下檢查的簡短清單。
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 使用量限制追蹤](https://ailoot.ai/blog/zh-hant-tw/claude-code-token-limits-saving/)觀察使用量的變化。 ## MCP 連線失敗時如何除錯
重點 最常見的問題包括 OAuth callback 無法運作、伺服器名稱與現有名稱衝突，或執行 `add` 後工具沒有出現在 `claude mcp list` 中。標準排查流程可以解決這些問題：用 `list` 查看已連線項目，用 `status` 檢查狀態指示；若顯示紅色，則用 `logs` 查看 stack trace。調整 `--scope` 或 ENV 變數後，請重新啟動所有項目。
逐步檢查清單： 1. **伺服器是否顯示在清單中？** ```bash claude mcp list ``` 如果沒有，表示 `claude mcp add` 未完成。最常見的原因是 `--scope`：你在 `local` 範圍中新增了伺服器，卻從另一個專案檢查。 2. **伺服器狀態是否為綠色？** ```bash claude mcp status ``` 紅色表示程序未啟動（stdio），或伺服器沒有回應（HTTP）。 3. **伺服器記錄中有沒有有用的資訊？** ```bash claude mcp logs ``` 如果看到 stack trace，問題通常出在套件上（`npx` 找不到套件，或 Node 版本低於 20）。 4. **OAuth callback 是否沒有返回？** 問題通常在 `--callback-port` 或網路過濾器。請轉送指定的連接埠： ```bash 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 伺服器與外掛程式市集
重點 用完七個現成伺服器後，接下來有三個步驟：若要在團隊間共用 MCP，可為自建 HTTP 伺服器設定 OAuth；為獨特服務撰寫自己的 MCP；以及連接 Anthropic 的 Plugin Marketplace。Marketplace 於 2025 年 10 月 9 日推出，將 MCP 封裝成只需一個命令就能安裝的外掛程式。
對不想記住安裝命令的人來說，Plugin Marketplace 可以加快設定流程。其格式是 `.claude-plugin/marketplace.json` manifest，可在一個套件中描述一組伺服器。 從市集中安裝外掛程式： ```bash claude plugin install ``` 一個外掛程式可同時包含多個 MCP 伺服器、Skills 和子代理，為特定情境（例如電子商務、行銷或法務部門）打包一套設定。 依據 `modelcontextprotocol.io` 規格撰寫自己的 MCP 伺服器。最小範本會使用 Anthropic 的 Python 或 TypeScript SDK；接著描述工具並連接傳輸方式。其複雜度大致相當於使用 FastAPI 撰寫 REST API。 如果專案已經有[設定好的 CLAUDE.md](https://ailoot.ai/blog/zh-hant-tw/claude-md-template/)，也了解[上下文工程](https://ailoot.ai/blog/zh-hant-tw/context-engineering/)，新增自建 MCP 只要一天。若還沒有，最好先學好基礎。
### 來源 - [Model Context Protocol — 官方網站](https://modelcontextprotocol.io/) - [Anthropic 推出 MCP — 2024 年 11 月 25 日](https://www.anthropic.com/news/model-context-protocol) - [Claude Code MCP 文件](https://code.claude.com/docs/en/mcp) - [Claude Code：MCP Tool Search](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search) - [Claude Code Plugins 公告 — 2025 年 10 月 9 日](https://claude.com/blog/claude-code-plugins) - [Code with Claude 2026](https://claude.com/code-with-claude) - [modelcontextprotocol/servers — 官方登錄庫](https://github.com/modelcontextprotocol/servers) - [github/github-mcp-server](https://github.com/github/github-mcp-server) - [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp) - [bytebase/dbhub — Postgres MCP](https://github.com/bytebase/dbhub) - [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp) - [makenotion/claude-code-notion-plugin](https://github.com/makenotion/claude-code-notion-plugin) - [Notion MCP 指南](https://developers.notion.com/guides/mcp/get-started-with-mcp) - [Anthropic Claude Code 儲存庫 — issues 和變更記錄](https://github.com/anthropics/claude-code)
若要繼續使用各種模型，請前往 [Ailoot](https://ailoot.ai/)。 ## 常見問題：2026 年 Claude Code MCP 設定：7 種整合與安裝指南 ### 這個 hook 能讓正式資料庫唯讀嗎？ 不能。它隔離具名 MCP 家族的全部呼叫，不分類 SQL。資料庫唯讀應來自經驗證 grants 的獨立角色，hook 只作額外控制。 ### 如何測試 hook 範圍？ 隔離工作階段中，匹配工具名的讀寫都應被拒，包含小寫或註解開頭 SQL。再確認無關工具在 matcher 外；未涵蓋路徑需自己的權限或政策。 ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。