> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> 新增、匯入和管理 Model Context Protocol 伺服器，給模型接上外部工具。

MCP（Model Context Protocol）讓模型安全地呼叫外部工具和資料來源，例如拉網頁、查文件、訪問資料庫。

在 CC GUI 開啟 **設定 → MCP 伺服器**。完整能力以 Claude Code 為主。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/mcp-list.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=02bc8ea41390ec615a59ae42a09bf452" alt="MCP 伺服器列表" width="100%" data-path="images/vscode/mcp-list.png" />

## 新增伺服器

點 **新增**，有三條路。

### 手動配置

貼上 MCP Servers 的 JSON。優先用 `npx` 或 `uvx` 拉起本地程序。

兩種傳輸：

| 型別         | 怎麼連         | 例子                                           |
| ---------- | ----------- | -------------------------------------------- |
| stdio      | 本地程序的標準輸入輸出 | `npx -y @modelcontextprotocol/server-memory` |
| HTTP / SSE | 遠端 URL      | 你自己的 MCP 服務地址                                |

作用域：

* **全域性**：寫入 `~/.claude.json`，所有專案可用
* **僅本專案**：只對當前工作區生效

<Warning>
  配置會在你的電腦上跑命令。新增前先核對來源、引數和環境變數。
</Warning>

### 從 MCP 市場新增

市場按登錄檔列出可安裝伺服器，可按名稱、發行者、標籤搜尋。

* **可安裝**：能直接生成配置
* **僅瀏覽**：只有後設資料，要自己按倉庫說明手動加

新增前看清命令、URL、請求頭和環境變數佔位符。無法識別的命令會額外標風險。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/mcp-marketplace.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=053c22947dfc5d1be92ecf0f24915c4a" alt="MCP 市場" width="100%" data-path="images/vscode/mcp-marketplace.png" />

### 從 GitHub Copilot 匯入

把 Copilot 的 MCP JSON 貼進去，根鍵是 `servers`：

```json theme={null}
{
  "servers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "my-mcp-server"]
    }
  }
}
```

先預覽再匯入。重名時會自動改名，並在預覽裡標出來。

## 內建預設

手動配置裡還有常用預設：

* Web 內容獲取
* 時間和時區
* 知識圖譜 / 記憶
* 順序思考
* Context7 文件檢索

預設只是起點，仍要確認命令和許可權。

## 看狀態和工具

每張伺服器卡片顯示：

| 狀態   | 含義           |
| ---- | ------------ |
| 已連線  | 可用           |
| 連線中  | 正在握手         |
| 需要認證 | 還要登入或補 Token |
| 連線失敗 | 看錯誤詳情和日誌     |
| 未知   | 還沒檢測完        |

點進卡片可以：

* 啟用 / 停用
* 檢視工具列表
* 開啟連線日誌
* 複製配置或主頁 / 文件連結
* 編輯、刪除

點 **重新整理伺服器狀態** 會重新檢測全部伺服器。工具列表會先走快取，需要最新資料時再強制重新整理。

## 在對話裡用

伺服器啟用並連線後，Claude Code 會按任務自動選工具。你不必在輸入框裡手寫呼叫。

許可權仍受當前執行模式約束。預設模式下，MCP 工具也可能先彈出確認。見 [執行模式與許可權](/zh-Hant/vscode/chat/modes)。