개요
이 솔루션은 kagent가 에이전트 AI 플랫폼으로 배포된 Distributed Cloud 소프트웨어 전용(GDC) 환경에 모델 컨텍스트 프로토콜(MCP) 서버를 통합하기 위한 표준화되고 안전하며 확장 가능한 메커니즘의 필요성을 해결합니다.
해결해야 할 핵심 문제는 규제 대상 GDC 클러스터 내에서 대규모 언어 모델(LLM) 애플리케이션을 현지화된 데이터 소스 및 도구에 연결하기 위한 통합 인터페이스가 없다는 점입니다. 이 아키텍처는 개발자가 특정 엔터프라이즈 기능을 AI 에이전트의 도구로 노출하는 커스텀 MCP 서버를 배포할 수 있는 BYO(Bring Your Own) 프레임워크를 제공합니다.
이 아키텍처는 kagent와 MCP 서버 간의 통신 프로토콜과 GDC의 구성요소 토폴로지를 다룹니다. 서드 파티 MCP 서버의 내부 로직은 제외됩니다.
이 문서의 타겟 잠재고객에는 GDC 플랫폼 관리자, AI 애플리케이션 개발자, 외부 도구 통합 승인을 담당하는 보안 검토자가 포함됩니다.
특징 및 기능
kagent는 조직이 BYO MCP 서버를 사용하여 LLM을 로컬 또는 독점 도구와 통합할 수 있는 유연한 프레임워크를 제공합니다. 이 기능을 사용하면 에이전트가 GDC 클러스터 경계 내에서 특수 데이터 소스와 상호작용하고 복잡한 작업을 수행할 수 있습니다.
기능 구성요소 및 책임
아키텍처에는 다음 기능 구성요소가 포함됩니다.
- AI 에이전트 플랫폼(kagent): 중앙 조정자 역할을 합니다. 에이전트 세션의 수명 주기를 관리하고, 사용자 쿼리를 LLM으로 라우팅하고, MCP 클라이언트를 통해 도구 실행을 조정합니다.
- LLM: 자연어 이해 및 추론을 처리합니다. 요청을 처리하는 데 특정 도구가 필요한 시점을 결정하고 해당 도구를 호출하는 데 필요한 파라미터를 생성합니다.
- MCP 서버: MCP를 통해 특정 도구를 독립형 서비스로 노출합니다. 백엔드 엔터프라이즈 시스템 또는 데이터 저장소와 상호작용하는 하위 수준 로직을 처리합니다.
인터페이스 및 데이터 흐름
엔드 투 엔드 아키텍처는 표준화된 인터페이스를 사용하여 상호 운용성과 보안을 유지합니다.
- MCP 전송: kagent는 스트리밍 가능한 HTTP(또는 SSE를 사용하는 HTTP) 또는
stdio와 같은 지원되는 MCP 전송을 통해 표준화된 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에 직접 통합하여 문서, 스프레드시트, 프레젠테이션을 실시간으로 공동 수정합니다.
- 확장성: 앱 스토어에서 플러그인을 설치하여 비밀번호 관리자, Kanban 보드, 음악 플레이어와 같은 기능을 추가할 수 있습니다.
이 솔루션에는 kagent가 있는 GDC와 Gemma 4 모델을 제공하는 vLLM이 필요합니다. 다음 다이어그램은 검증 설정을 보여줍니다.
