MCP 整合
透過 Model Context Protocol 伺服器與外掛擴充 Verdent
你將學到什麼
Verdent for VS Code 中 Model Context Protocol（MCP）整合的概觀，包括設定、組態與擴充選項。
完整的 MCP 文件目前正在製作中。本頁面提供 MCP 功能的概觀，詳細指南即將推出。如有特定整合問題，請聯絡 support@verdent.ai。
什麼是 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 設定：
- 開啟 Verdent 的設定選單
- 前往 MCP Servers 區段
- 檢視或修改
~/.verdent/mcp.json組態
組態檔案：
MCP 伺服器透過 ~/.verdent/mcp.json 檔案進行設定，該檔案定義了伺服器連線、驗證與整合參數。
詳細的 MCP 組態架構與設定指示正在最終確認中。如需立即協助設定 MCP 伺服器，請參閱 MCP 協定規格或聯絡 Verdent 支援。
組態管理
新增伺服器：
透過在 mcp.json 中新增含連線詳情與驗證憑證的項目，來設定新的 MCP 伺服器。
多重伺服器： Verdent 支援多個同時運作的 MCP 伺服器，可同時整合多個外部系統。
測試連線： 在開發工作流程中使用前，先驗證 MCP 伺服器組態以確保連線成功。
MCP 外掛與擴充
可用外掛
MCP 外掛為常見工具與服務提供現成的整合。
可用 MCP 外掛的精選清單正在彙整中。請查看 Verdent 官方文件或 MCP 生態系資源，以了解目前的外掛可用性。
預期外掛類別：
- 資料庫整合： 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 能與舊版基礎設施互動
- 專門資料來源： 存取專有資料庫或資料倉儲
- 工作流程自動化： 觸發自訂的建置、部署或測試管線
完整的自訂 MCP 伺服器開發指南，包括協定實作需求、SDK 文件與測試工具，正在開發中。如有立即的自訂整合需求，請參閱 MCP 協定規格。
整合模式
工作區層級組態： 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 deploymentMCP 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 協定文件
- Verdent Discord 社群 提供即時支援
診斷資訊： 回報 MCP 問題時，請提供：
- MCP 伺服器類型與版本
- 組態詳情（已移除憑證）
- 來自聊天記錄的錯誤訊息
- MCP 伺服器日誌（如可存取）
MCP 文件資源
官方文件
完整的 MCP 整合指南正在開發中，包括：
- 完整的 MCP 協定規格
- 伺服器開發 SDK 文件
- 外掛市集與登錄
- 整合範例與教學
- 自訂伺服器開發的 API 參考
即將推出：
- 逐步 MCP 伺服器設定指南
- 外掛安裝與組態逐步說明
- 自訂伺服器開發教學
- MCP 整合的最佳實務
- MCP 工作流程的效能最佳化
過渡期資源
目前的 MCP 資訊：
- MCP 協定規格（外部）
- 社群開發的 MCP 伺服器與範例
- MCP 生態系 GitHub 儲存庫
詳情聯絡： 如需立即的 MCP 整合協助，請聯絡 support@verdent.ai 並說明你的特定使用情境與整合需求。