---
title: MCP 整合
description: 透過 Model Context Protocol 伺服器與外掛擴充 Verdent
---



### 你將學到什麼

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

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

---

## 什麼是 MCP（Model 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 整合的優勢

### 擴充功能

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

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

### 互通性

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

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

### 工作流程自動化

**無縫整合：**
MCP 伺服器會成為 Verdent 工具集的一部分。代理會在適當時自動使用 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 外掛為常見工具與服務提供現成的整合。

<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 協定規格，公開 Verdent 可呼叫的工具功能。

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

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

### 整合模式

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

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

---

## 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 管線監控

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

**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.json` 中的驗證憑證
- 確保 MCP 伺服器正在執行且可存取
- 驗證組態檔案語法

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

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

### 取得協助

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

**診斷資訊：**
回報 MCP 問題時，請提供：
- MCP 伺服器類型與版本
- 組態詳情（已移除憑證）
- 來自聊天記錄的錯誤訊息
- MCP 伺服器日誌（如可存取）

---

## MCP 文件資源

### 官方文件

<Info>
完整的 MCP 整合指南正在開發中，包括：
- 完整的 MCP 協定規格
- 伺服器開發 SDK 文件
- 外掛市集與登錄
- 整合範例與教學
- 自訂伺服器開發的 API 參考
</Info>

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

### 過渡期資源

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

**詳情聯絡：**
如需立即的 MCP 整合協助，請聯絡 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>