概要
このソリューションは、kagent をエージェント型 AI プラットフォームとしてデプロイした Distributed Cloud ソフトウェアのみ（GDC）環境に Model Context Protocol（MCP）サーバーを統合するための、標準化された安全でスケーラブルなメカニズムの必要性に対応します。
対処すべき主な問題は、規制対象の GDC クラスタ内で大規模言語モデル（LLM）アプリケーションをローカル データソースやツールに接続するための統合インターフェースがないことです。このアーキテクチャは、デベロッパーが特定のエンタープライズ機能を AI エージェントのツールとして公開するカスタム MCP サーバーをデプロイできるようにする Bring Your Own（BYO）フレームワークを提供します。
このアーキテクチャでは、kagent と MCP サーバー間の通信プロトコルと、GDC のコンポーネント トポロジについて説明します。サードパーティの MCP サーバーの内部ロジックは除外されます。
このドキュメントの対象読者は、GDC プラットフォーム管理者、AI アプリケーション デベロッパー、外部ツールの統合の承認を担当するセキュリティ レビュー担当者です。
特長と機能
kagent は、組織が BYO MCP サーバーを使用して LLM をローカル ツールや独自のツールと統合できる柔軟なフレームワークを提供します。この機能により、エージェントは特殊なデータソースとやり取りし、GDC クラスタの境界内で複雑なタスクを実行できます。
機能コンポーネントと責任
このアーキテクチャには、次の機能コンポーネントが含まれています。
- AI エージェント プラットフォーム（kagent）: 中央オーケストレーターとして機能します。エージェント セッションのライフサイクルを管理し、ユーザークエリを LLM にルーティングして、MCP クライアントを介してツールの実行を調整します。
- LLM: 自然言語理解と推論を処理します。リクエストを処理するために特定のツールが必要なタイミングを判断し、そのツールを呼び出すために必要なパラメータを生成します。
- MCP サーバー: スタンドアロン サービスとして MCP を介して特定のツールを公開します。バックエンドのエンタープライズ システムまたはデータ リポジトリとやり取りする低レベルのロジックを処理します。
インターフェースとデータフロー
エンドツーエンドのアーキテクチャは、相互運用性とセキュリティを維持するために、標準化されたインターフェースに依存しています。
- MCP トランスポート: kagent は、サポートされている MCP トランスポート（Streamable 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 に直接統合して、ドキュメント、スプレッドシート、プレゼンテーションをリアルタイムで共同編集します。
- 拡張性: アプリストアからプラグインをインストールして、パスワード マネージャー、カンバンボード、音楽プレーヤーなどの機能を追加できます。
このソリューションでは、Gemma 4 モデルをサービングする kagent と vLLM を備えた GDC が必要です。次の図は、検証の設定を示しています。
その他の教材
- Distributed Cloud ソフトウェアのみのリファレンス実装に kagent 用の Solo Enterprise をデプロイする
- 独自の MCP サーバーを kagent リファレンス実装に導入する