# MCP 整合 (/zh-Hant/docs/verdent-for-vscode/advanced-features/mcp)

> 透過 Model Context Protocol 伺服器與外掛擴充 Verdent



### 你將學到什麼 [#你將學到什麼]

Verdent for VS Code 中 Model Context Protocol（MCP）整合的概觀，包括設定、組態與擴充選項。

<Info>
  完整的 MCP 文件目前正在製作中。本頁面提供 MCP 功能的概觀，詳細指南即將推出。如有特定整合問題，請聯絡 [support@verdent.ai](mailto:support@verdent.ai)。
</Info>

***

## 什麼是 MCP（Model Context Protocol）？ [#什麼是-mcpmodel-context-protocol]

Model Context Protocol（MCP）是一套整合系統，透過連接外部工具、資料來源與服務來擴充 Verdent 的功能。

**核心概念：**
MCP 讓 Verdent 能與其內建工具集以外的系統互動，實現與下列項目的無縫整合：

* 外部 API 與網路服務
* 資料庫系統
* 雲端平台（AWS、Azure、GCP）
* 專案管理工具
* CI/CD 管線
* 自訂內部工具

**架構：**
MCP 伺服器作為 Verdent 與外部系統之間的橋樑。每個 MCP 伺服器都會公開特定功能，讓 Verdent 能在編碼工作階段中呼叫，類似於 `file_read` 或 `bash` 等內建工具。

**組態儲存：**
MCP 伺服器組態儲存於 `~/.verdent/mcp.json`，並透過設定選單進行管理。

***

## MCP 整合的優勢 [#mcp-整合的優勢]

### 擴充功能 [#擴充功能]

**存取外部系統：**
將 Verdent 連接到內建功能無法提供的工具與服務。在不離開編碼工作流程的情況下，查詢資料庫、與雲端服務互動，或整合專案專屬的 API。

**自訂工具開發：**
建立符合專案獨特需求的 MCP 伺服器。為內部工具、專有 API 或特定領域系統打造專門的整合。

### 互通性 [#互通性]

**生態系運用：**
善用日益成長的 MCP 生態系。社群開發的 MCP 伺服器為熱門工具與服務提供現成的整合。

**標準化協定：**
MCP 為工具整合提供一致的介面，確保新功能能與 Verdent 既有的工具系統順暢整合。

### 工作流程自動化 [#工作流程自動化]

**無縫整合：**
MCP 伺服器會成為 Verdent 工具集的一部分。代理會在適當時自動使用 MCP 工具，你也可以針對特定任務明確呼叫它們。

**情境感知操作：**
MCP 整合能理解你的程式碼庫上下文，根據目前開發狀態與外部系統進行智慧互動。

***

## 設定 MCP 伺服器 [#設定-mcp-伺服器]

### 組態流程 [#組態流程]

**存取 MCP 設定：**

1. 開啟 Verdent 的設定選單
2. 前往 **MCP Servers** 區段
3. 檢視或修改 `~/.verdent/mcp.json` 組態

**組態檔案：**
MCP 伺服器透過 `~/.verdent/mcp.json` 檔案進行設定，該檔案定義了伺服器連線、驗證與整合參數。

<Note>
  詳細的 MCP 組態架構與設定指示正在最終確認中。如需立即協助設定 MCP 伺服器，請參閱 MCP 協定規格或聯絡 Verdent 支援。
</Note>

### 組態管理 [#組態管理]

**新增伺服器：**
透過在 `mcp.json` 中新增含連線詳情與驗證憑證的項目，來設定新的 MCP 伺服器。

**多重伺服器：**
Verdent 支援多個同時運作的 MCP 伺服器，可同時整合多個外部系統。

**測試連線：**
在開發工作流程中使用前，先驗證 MCP 伺服器組態以確保連線成功。

***

## MCP 外掛與擴充 [#mcp-外掛與擴充]

### 可用外掛 [#可用外掛]

MCP 外掛為常見工具與服務提供現成的整合。

<Info>
  可用 MCP 外掛的精選清單正在彙整中。請查看 Verdent 官方文件或 MCP 生態系資源，以了解目前的外掛可用性。
</Info>

**預期外掛類別：**

* **資料庫整合：** PostgreSQL、MySQL、MongoDB 查詢工具
* **雲端服務：** AWS、Azure、GCP API 互動
* **開發者工具：** GitHub、GitLab、Jira、Linear 整合
* **CI/CD 平台：** Jenkins、GitHub Actions、CircleCI
* **監控服務：** Datadog、New Relic、Sentry
* **通訊：** Slack、Discord、Microsoft Teams 通知

### 外掛安裝 [#外掛安裝]

**安裝方式：**
外掛透過 MCP 設定介面進行安裝與設定，通常需要：

* 外掛識別碼或來源
* 組態參數
* 驗證憑證（如適用）

**相依性管理：**
MCP 外掛可能對外部服務或函式庫有相依性。安裝程序會盡可能自動處理相依性解析。

***

## 自訂 MCP 伺服器開發 [#自訂-mcp-伺服器開發]

### 建立自訂伺服器 [#建立自訂伺服器]

進階使用者可以建立自訂 MCP 伺服器，以整合專有工具或特定領域系統。

**開發方式：**
自訂 MCP 伺服器實作 MCP 協定規格，公開 Verdent 可呼叫的工具功能。

**自訂伺服器的使用情境：**

* **內部 API 整合：** 連接至公司專屬的 API 與服務
* **舊系統橋接：** 讓 Verdent 能與舊版基礎設施互動
* **專門資料來源：** 存取專有資料庫或資料倉儲
* **工作流程自動化：** 觸發自訂的建置、部署或測試管線

<Note>
  完整的自訂 MCP 伺服器開發指南，包括協定實作需求、SDK 文件與測試工具，正在開發中。如有立即的自訂整合需求，請參閱 MCP 協定規格。
</Note>

### 整合模式 [#整合模式]

**工作區層級組態：**
MCP 伺服器可在工作區層級設定以進行專案專屬整合，讓團隊能透過版本控制分享 MCP 組態。

**工具互通性：**
MCP 提供的工具能與 Verdent 的內建工具（`file_read`、`bash`、`spawn_subagent`）無縫整合，實現結合多種工具類型的複雜工作流程。

***

## MCP 工作流程範例 [#mcp-工作流程範例]

### 資料庫查詢整合 [#資料庫查詢整合]

**情境：** 查詢生產資料庫以偵錯資料問題。

**MCP 方式：**

```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]
```

MCP 資料庫伺服器負責處理驗證、查詢驗證與結果格式化。

### 雲端服務互動 [#雲端服務互動]

**情境：** 檢查 AWS Lambda 函式日誌中的錯誤。

**MCP 方式：**

```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]
```

MCP AWS 伺服器管理驗證、API 呼叫與日誌解析。

### CI/CD 管線監控 [#cicd-管線監控]

**情境：** 在部署變更前檢查建置狀態。

**MCP 方式：**

```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment
```

MCP CI/CD 伺服器追蹤管線狀態並提供即時回饋。

***

## 安全性考量 [#安全性考量]

### 驗證與授權 [#驗證與授權]

**憑證管理：**
MCP 伺服器負責處理對外部服務的驗證。憑證安全地儲存在 MCP 組態中，絕不會暴露於聊天記錄或程式碼中。

**權限範圍限定：**
為 MCP 伺服器設定最低必要權限。盡可能使用唯讀存取，並限制具破壞性的操作。

### 安全操作 [#安全操作]

**指令審查：**
涉及 MCP 工具的操作可在手動接受模式（Manual Accept Mode）下於執行前審查，提供可見性與控制權。

**稽核日誌：**
MCP 伺服器操作會出現在 Verdent 的聊天記錄中，建立外部系統互動的稽核軌跡。

***

## MCP 整合疑難排解 [#mcp-整合疑難排解]

### 常見問題 [#常見問題]

**連線失敗：**

* 確認與 MCP 伺服器之間的網路連線
* 檢查 `mcp.json` 中的驗證憑證
* 確保 MCP 伺服器正在執行且可存取
* 驗證組態檔案語法

**權限錯誤：**

* 確認 API 金鑰或憑證具備所需權限
* 檢查服務配額或速率限制
* 確認防火牆規則允許 MCP 流量

**工具呼叫問題：**

* 確保 MCP 伺服器正確公開預期的工具
* 檢查工具參數格式是否符合伺服器預期
* 查看 MCP 伺服器日誌以了解錯誤詳情

### 取得協助 [#取得協助]

**支援管道：**

* Verdent 支援：[support@verdent.ai](mailto:support@verdent.ai)
* [MCP 協定文件](https://modelcontextprotocol.io)
* [Verdent Discord 社群](https://discord.com/invite/NGjXEZcbJq) 提供即時支援

**診斷資訊：**
回報 MCP 問題時，請提供：

* MCP 伺服器類型與版本
* 組態詳情（已移除憑證）
* 來自聊天記錄的錯誤訊息
* MCP 伺服器日誌（如可存取）

***

## MCP 文件資源 [#mcp-文件資源]

### 官方文件 [#官方文件]

<Info>
  完整的 MCP 整合指南正在開發中，包括：

  * 完整的 MCP 協定規格
  * 伺服器開發 SDK 文件
  * 外掛市集與登錄
  * 整合範例與教學
  * 自訂伺服器開發的 API 參考
</Info>

**即將推出：**

* 逐步 MCP 伺服器設定指南
* 外掛安裝與組態逐步說明
* 自訂伺服器開發教學
* MCP 整合的最佳實務
* MCP 工作流程的效能最佳化

### 過渡期資源 [#過渡期資源]

**目前的 MCP 資訊：**

* MCP 協定規格（外部）
* 社群開發的 MCP 伺服器與範例
* MCP 生態系 GitHub 儲存庫

**詳情聯絡：**
如需立即的 MCP 整合協助，請聯絡 [support@verdent.ai](mailto:support@verdent.ai) 並說明你的特定使用情境與整合需求。

***

## 另請參閱 [#另請參閱]

<CardGroup cols="2">
  <Card title="工具參考" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    內建工具功能
  </Card>

  <Card title="擴充性" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    其他擴充方式
  </Card>

  <Card title="組態設定" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Verdent 設定與偏好
  </Card>

  <Card title="最佳實務" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    有效的提示詞技巧
  </Card>
</CardGroup>