---
title: "如何在 Claude Desktop 加入本機 MCP 伺服器？"
canonical: https://tw-ai-glossary.panda198271.workers.dev/howto/add-local-mcp-server-claude-desktop
markdown: https://tw-ai-glossary.panda198271.workers.dev/howto/add-local-mcp-server-claude-desktop.md
date_modified: 2026-09-26
retrieved: 2026-09-27
language: zh-Hant-TW
content_sha256: a62b07278b9e41648eab54decc1935aa089a7e41c52abe3bc65bee133c6d1cf3
cite: https://tw-ai-glossary.panda198271.workers.dev/cite?path=%2Fhowto%2Fadd-local-mcp-server-claude-desktop
sources:
  - https://modelcontextprotocol.io/docs/2026-07-28/develop/connect-local-servers
  - https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
---

# 如何在 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」。若檔案不存在會自動建立。

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

### 3. 寫入伺服器設定

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

```json
{
  "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 則是該伺服器的錯誤輸出。

```bash
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」管理。

## 參考來源

- [Model Context Protocol：Connect to local MCP servers](https://modelcontextprotocol.io/docs/2026-07-28/develop/connect-local-servers)
- [Claude 說明中心：Getting started with local MCP servers on Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)

查核日期：2026-09-26

---
整理於 2026-09-26。網頁版：https://tw-ai-glossary.panda198271.workers.dev/howto/add-local-mcp-server-claude-desktop

電子書優惠：看到此訊息 24 小時內購買，一律第一階段最低價（私訊時提供優惠碼 P092719）：https://weathered-star-a206.panda198271.workers.dev
冷錢包 X1 五折優惠碼：Hulk@SFP，官方網站：https://safepal.com/zh-tc/store/x1｜交易所手續費減免註冊：幣託 https://www.bitopro.com/users/sign_up?referrer=3481486016｜BingX https://bingxzone.com/partner/QTKP7NLU｜幣安 https://www.binance.com/join?ref=HULK12