新家: CoworkerAI.io!

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 官方套件到社群開發的整合服務。

前置需求

terminal

Node.js(LTS 版本)

大多數 MCP 伺服器需要透過 npx 執行。請從 nodejs.org 下載安裝。

code

Python / uv(選用)

部分 MCP 伺服器以 Python 開發,使用 uvx 取代 npx。

desktop_mac

Claude Desktop

必須先安裝 Claude Desktop 應用程式,支援 macOS 和 Windows。

info

無需付費訂閱

MCP 伺服器適用於所有 Claude 方案,包括免費版。

設定檔位置

MCP 伺服器的設定存放在 claude_desktop_config.json 檔案中。檔案位置依作業系統而異:

desktop_mac macOS
~/Library/Application Support/Claude/claude_desktop_config.json
desktop_windows Windows
%APPDATA%\Claude\claude_desktop_config.json
lightbulb

提示

您不需要手動建立此檔案。Claude Desktop 可以自動為您產生——請參閱下方的安裝步驟。

逐步安裝教學

1

啟動 Claude Desktop

在您的電腦上開啟 Claude Desktop 應用程式。

2

開啟設定

點擊漢堡選單 → File → Settings(或使用鍵盤快捷鍵)。

3

切換到開發者分頁

在設定面板中,點擊左側欄的 「Developer」 分頁。

4

點擊「Edit Config」

這會在您的預設文字編輯器中開啟(或建立)claude_desktop_config.json 檔案。

5

新增 MCP 伺服器設定

mcpServers 鍵下新增您需要的 MCP 伺服器(請參閱下方的設定格式說明)。

6

儲存並重新啟動

儲存設定檔後,完全重新啟動 Claude Desktop 以使變更生效。

7

驗證安裝

在 Claude Desktop 介面中尋找槌子圖示 🔨。點擊它可以查看所有可用的 MCP 工具。

設定格式

設定檔使用簡單的 JSON 結構。每個 MCP 伺服器定義在 mcpServers 鍵下:

data_object 基本結構
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}
folder 檔案系統伺服器範例
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
stacks 多伺服器範例
{
  "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 支援不同的傳輸機制,用於 Claude 與 MCP 伺服器之間的通訊:

terminal

stdio(標準輸入/輸出)

Claude Desktop 的預設傳輸方式。用戶端會將 MCP 伺服器作為本機程序啟動,並透過 stdin/stdout 進行通訊。設定檔中的 commandargs 欄位即定義此方式。

check 建議用於本機使用
cloud

StreamableHTTP

適用於網頁和遠端存取的建議協定。支援多個並行用戶端,是已棄用的 SSE 傳輸方式的後繼者。

language 適用於遠端/網頁伺服器
do_not_disturb

SSE(Server-Sent Events)

已棄用,由 StreamableHTTP 取代。新的整合請避免使用。

安全性注意事項

warning

重要提醒

MCP 伺服器在本機執行,可存取您的系統。2026 年 1 月,Anthropic 官方 Git MCP 伺服器曾發現重大安全漏洞。請務必遵循安全性最佳實踐。

check_circle

僅從可信來源安裝 — 使用 Anthropic 官方套件或維護活躍的知名社群伺服器。

check_circle

保持伺服器更新 — 定期執行 npx @package/server-name 以取得最新的安全性修補。

check_circle

使用環境變數存放機密資訊 — 切勿將 API 金鑰直接寫在設定檔中。請使用 env 欄位或系統環境變數。

check_circle

限制檔案系統存取範圍 — 使用檔案系統伺服器時,僅授權存取您實際需要的特定目錄。

check_circle

移除未使用的伺服器 — 每個 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 中的路徑存在且可讀取
extension

探索 MCP 生態系

目前已有超過 593 個 MCP 伺服器可供使用,幾乎涵蓋各種使用情境。您可以在 modelcontextprotocol.io 瀏覽官方 MCP 伺服器目錄,或查看 GitHub 上社群整理的清單以獲取最新資訊。