MCP 外掛安裝指南
了解如何安裝與設定 MCP(Model Context Protocol)伺服器,透過外部工具、資料來源和整合服務來擴展 Claude 的功能。
Model Context Protocol(MCP)是由 Anthropic 所建立的開放標準,用於統一 AI 模型連接外部資料來源與工具的方式。MCP 常被形容為「AI 的 USB-C」,提供了一個通用介面,讓 Claude 能與您的本機檔案、資料庫、API 及開發工具進行互動。
截至 2026 年,MCP 已獲得 Anthropic、OpenAI、Google 和 Microsoft 的支援,成為 AI 代理的事實標準整合協定。目前生態系中已有超過 593 個 MCP 伺服器可供使用,涵蓋 Anthropic 官方套件到社群開發的整合服務。
前置需求
Node.js(LTS 版本)
大多數 MCP 伺服器需要透過 npx 執行。請從 nodejs.org 下載安裝。
Python / uv(選用)
部分 MCP 伺服器以 Python 開發,使用 uvx 取代 npx。
Claude Desktop
必須先安裝 Claude Desktop 應用程式,支援 macOS 和 Windows。
無需付費訂閱
MCP 伺服器適用於所有 Claude 方案,包括免費版。
設定檔位置
MCP 伺服器的設定存放在 claude_desktop_config.json 檔案中。檔案位置依作業系統而異:
~/Library/Application Support/Claude/claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json 提示
您不需要手動建立此檔案。Claude Desktop 可以自動為您產生——請參閱下方的安裝步驟。
逐步安裝教學
啟動 Claude Desktop
在您的電腦上開啟 Claude Desktop 應用程式。
開啟設定
點擊漢堡選單 → File → Settings(或使用鍵盤快捷鍵)。
切換到開發者分頁
在設定面板中,點擊左側欄的 「Developer」 分頁。
點擊「Edit Config」
這會在您的預設文字編輯器中開啟(或建立)claude_desktop_config.json 檔案。
新增 MCP 伺服器設定
在 mcpServers 鍵下新增您需要的 MCP 伺服器(請參閱下方的設定格式說明)。
儲存並重新啟動
儲存設定檔後,完全重新啟動 Claude Desktop 以使變更生效。
驗證安裝
在 Claude Desktop 介面中尋找槌子圖示 🔨。點擊它可以查看所有可用的 MCP 工具。
設定格式
設定檔使用簡單的 JSON 結構。每個 MCP 伺服器定義在 mcpServers 鍵下:
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "@package/server-name"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
} {
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
} {
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-brave-api-key"
}
}
}
} 熱門 MCP 伺服器
以下是生態系中最廣泛使用的 MCP 伺服器:
| 伺服器 | 套件名稱 | 用途 |
|---|---|---|
| Filesystem | @modelcontextprotocol/server-filesystem | 讀寫本機檔案、建立文件、整理資料夾 |
| GitHub | @modelcontextprotocol/server-github | 讀取程式碼庫、檢視 PR、追蹤工作流程 |
| PostgreSQL | @modelcontextprotocol/server-postgres | 唯讀資料庫存取與結構檢視 |
| Brave Search | @modelcontextprotocol/server-brave-search | 網頁搜尋功能 |
| Puppeteer | @modelcontextprotocol/server-puppeteer | 瀏覽器自動化與網頁爬取 |
| Sequential Thinking | @modelcontextprotocol/server-sequential-thinking | 動態推理與逐步問題解決 |
| Slack | @anthropic/mcp-server-slack | Slack 工作區整合 |
| Google Drive | @anthropic/mcp-server-gdrive | Google 文件、試算表與雲端硬碟整合 |
| Docker | @anthropic/mcp-server-docker | 容器管理與編排 |
| Memory | @modelcontextprotocol/server-memory | 跨對話的持久記憶 |
傳輸協定
MCP 支援不同的傳輸機制,用於 Claude 與 MCP 伺服器之間的通訊:
stdio(標準輸入/輸出)
Claude Desktop 的預設傳輸方式。用戶端會將 MCP 伺服器作為本機程序啟動,並透過 stdin/stdout 進行通訊。設定檔中的 command 和 args 欄位即定義此方式。
StreamableHTTP
適用於網頁和遠端存取的建議協定。支援多個並行用戶端,是已棄用的 SSE 傳輸方式的後繼者。
language 適用於遠端/網頁伺服器SSE(Server-Sent Events)
已棄用,由 StreamableHTTP 取代。新的整合請避免使用。
安全性注意事項
重要提醒
MCP 伺服器在本機執行,可存取您的系統。2026 年 1 月,Anthropic 官方 Git MCP 伺服器曾發現重大安全漏洞。請務必遵循安全性最佳實踐。
僅從可信來源安裝 — 使用 Anthropic 官方套件或維護活躍的知名社群伺服器。
保持伺服器更新 — 定期執行 npx @package/server-name 以取得最新的安全性修補。
使用環境變數存放機密資訊 — 切勿將 API 金鑰直接寫在設定檔中。請使用 env 欄位或系統環境變數。
限制檔案系統存取範圍 — 使用檔案系統伺服器時,僅授權存取您實際需要的特定目錄。
移除未使用的伺服器 — 每個 MCP 伺服器都會增加攻擊面。請移除不再使用的伺服器。
疑難排解
重新啟動後槌子圖示未出現 expand_more
這通常表示設定檔有 JSON 語法錯誤。常見問題包括:
- 伺服器項目之間缺少或多餘逗號
- 括號或大括號不匹配
- 使用單引號而非雙引號
請在 jsonlint.com 驗證您的 JSON,或使用 node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"
MCP 伺服器無法啟動 expand_more
請檢查以下事項:
- 確認已安裝 Node.js 且
npx在您的 PATH 中可用 - 嘗試在終端機中手動執行 npx 指令以查看錯誤輸出
- 確認套件名稱是否正確(拼寫錯誤很常見)
- 對於需要 API 金鑰的伺服器,請確認金鑰有效且已正確設定在
env欄位中
權限被拒絕錯誤 expand_more
MCP 伺服器會繼承 Claude Desktop 程序的權限:
- 在 macOS 上,請檢查「系統設定」→「隱私權與安全性」中的相關權限
- 確認設定檔中指定的目錄對您的使用者帳號是可存取的
- 對於檔案系統伺服器,請確認
args中的路徑存在且可讀取
探索 MCP 生態系
目前已有超過 593 個 MCP 伺服器可供使用,幾乎涵蓋各種使用情境。您可以在 modelcontextprotocol.io 瀏覽官方 MCP 伺服器目錄,或查看 GitHub 上社群整理的清單以獲取最新資訊。