如何在 Claude Desktop 加入本機 MCP 伺服器？

在 Claude Desktop 的「設定 → Developer → Edit Config」打開 claude_desktop_config.json，在 mcpServers 中寫入伺服器名稱、啟動指令與參數，存檔後完全結束並重開 Claude Desktop，即可在對話框的連接器選單看到該伺服器。

需要準備什麼？

• 最新版 Claude Desktop（macOS 或 Windows）
• Node.js（官方範例的 Filesystem 伺服器以 npx 執行，建議 LTS 版）
• 文字編輯器

步驟

1. 打開 Claude Desktop 設定

   點選系統選單列上的 Claude 選單（不是對話視窗內的設定）並選擇「Settings…」。

2. 開啟設定檔

   在左側切換到「Developer」分頁，按「Edit Config」。若檔案不存在會自動建立。

   macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 寫入伺服器設定

   在 mcpServers 下新增一筆，key 是顯示名稱，command 是啟動指令，args 是參數。以下是官方 Filesystem 伺服器範例，最後兩個參數是允許存取的資料夾，請換成你的使用者名稱。

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/Users/username/Desktop",
           "/Users/username/Downloads"
         ]
       }
     }
   }

4. 完全重新啟動 Claude Desktop

   存檔後要完全結束應用程式再開啟，只關閉視窗不會重新載入設定。

5. 確認伺服器已連線

   點對話輸入框左下角的「Add files, connectors, and more」圖示，移到「Connectors」並進入「Manage connectors」，應可看到剛加入的伺服器與其工具。

6. 連不上時查看紀錄檔

   mcp.log 記錄連線狀況，mcp-server-伺服器名稱.log 則是該伺服器的錯誤輸出。

   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

常見錯誤

• JSON 格式錯誤（多一個逗號或少一個括號）會讓所有伺服器都無法載入
• args 中的路徑使用相對路徑；官方要求使用絕對路徑
• Windows 路徑沒有寫成雙反斜線（\\）
• 給 Filesystem 伺服器過大的資料夾權限；它以你的使用者權限執行，可讀寫該範圍內所有檔案

常見問題

Claude Desktop 的 MCP 紀錄檔在哪裡？

依 MCP 官方文件，macOS 在 ~/Library/Logs/Claude，Windows 在 %APPDATA%\Claude\logs。mcp.log 是整體連線紀錄，mcp-server-名稱.log 是個別伺服器的 stderr 輸出。

不想手動改 JSON，有更簡單的安裝方式嗎？

有。Claude Desktop 支援桌面擴充功能（.mcpb 檔），可像安裝瀏覽器擴充功能一樣安裝本機 MCP 伺服器，並在「Settings → Extensions」管理。

相關名詞

模型上下文協議、AI 代理人

參考來源

• Model Context Protocol：Connect to local MCP servers
• Claude 說明中心：Getting started with local MCP servers on Claude Desktop

查核日期：2026-09-26。API：/api/howto?id=add-local-mcp-server-claude-desktop