總覽
這項解決方案可滿足標準化、安全且可擴充機制的需求，將 Model Context Protocol (MCP) 伺服器整合至 Distributed Cloud 軟體專用 (GDC) 環境，並部署 kagent 做為代理式 AI 平台。
核心問題在於，缺乏統一介面，無法將大型語言模型 (LLM) 應用程式，連結至受監管 GDC 叢集內的店面資料來源和工具。這個架構提供「自備」(BYO) 框架，可讓開發人員部署自訂 MCP 伺服器，將特定企業功能公開為 AI 代理的工具。
這項架構涵蓋 kagent 與 MCP 伺服器之間的通訊協定，以及 GDC 上的元件拓撲。不含第三方 MCP 伺服器的內部邏輯。
本文件的目標對象包括 GDC 平台管理員、AI 應用程式開發人員，以及負責核准外部工具整合的安全性審查人員。
特點與功能
kagent 提供彈性的架構，讓組織使用 BYO MCP 伺服器，將 LLM 與本機或專屬工具整合。有了這項功能，代理就能與專門的資料來源互動，並在 GDC 叢集範圍內執行複雜工作。
功能元件和職責
此架構包含下列功能元件：
- AI 代理平台 (kagent)：做為中央自動調度管理工具。管理代理工作階段的生命週期、將使用者查詢轉送至 LLM，並透過 MCP 用戶端協調工具執行。
- LLM：處理自然語言理解和推論。它會判斷何時需要特定工具來完成要求，並產生呼叫該工具所需的參數。
- MCP 伺服器：透過 MCP 將特定工具公開為獨立服務。它會處理與後端企業系統或資料存放區互動的低階邏輯。
介面和資料流程
端對端架構仰賴標準化介面，以維持互通性和安全性：
- MCP 傳輸：kagent 會透過支援的 MCP 傳輸 (例如可串流 HTTP (或 HTTP 搭配 SSE) 或
stdio)，使用標準化 JSON-RPC 與 MCP 伺服器通訊。這個介面定義了工具的探索、描述和叫用方式。 - 資料流程：要求生命週期包含下列步驟：
- 使用者向 kagent 傳送提示詞。
- kagent 會將提示詞轉送至 LLM。
- LLM 識別出工具呼叫，並將其傳回 kagent。
- kagent 會將要求轉送至 MCP 伺服器。
- MCP 伺服器會對本機資料來源執行工具，並傳回結果。
- kagent 將結果傳回 LLM，生成最終回覆。
架構
為示範如何部署及使用 BYO MCP 伺服器，本參考架構採用開放原始碼 Nextcloud 應用程式、其 MCP 伺服器，以及 Solo Enterprise for kagent 上的 Nextcloud 代理。
本範例使用 vLLM 提供 Gemma 4 模型。
這個架構會在 GDC 環境中連結 Nextcloud、kagent 和 Gemma 4 模型。在這項設定中，kagent 會使用 Nextcloud 做為資料存放區，讓 Gemma 4 模型能透過標準化 MCP 介面，存取及處理 Nextcloud 中的資訊。
Nextcloud 是開放原始碼的自託管協作和雲端儲存空間平台，支援地端部署，可協助您控管使用者資料並維護隱私。它是 openDesk 的元件。
Nextcloud 包含下列功能：
- 檔案同步與共用：儲存檔案、透過專屬應用程式在電腦和行動裝置之間同步處理檔案，以及使用連結共用檔案。
- 效率提升工具：使用內建的日曆、聯絡人、工作管理和電子郵件用戶端。
- 協作：將 Collabora Online 或 ONLYOFFICE 等辦公套件直接整合至 Nextcloud，即時共同編輯文件、試算表和簡報。
- 擴充性：從應用程式商店安裝外掛程式，新增密碼管理工具、看板或音樂播放器等功能。
這項解決方案需要 GDC 搭配 kagent 和 vLLM，才能提供 Gemma 4 模型。下圖說明驗證設定：
