A1 · Homeplus · 2024

Admin MCP

관리자 시스템 MCP 구축

기존 관리자 시스템의 인증·권한 체계를 유지하면서 80여 개의 업무 API를 MCP Tool로 전환하고, LLM 기반의 유연한 데이터 조회·분석 환경을 구축했습니다.

Admin API → MCP Tools

새로 추가한 AI 전용 인증 체계

Live

내부 관리자 실사용

01 Problem

기존 관리자 시스템은 사전에 정의된 화면과 지표를 중심으로 데이터를 조회하는 구조였습니다. 새로운 관점의 분석이나 화면에 없는 지표가 필요하면 별도의 조회 기능이나 분석 화면을 개발해야 했습니다.

LLM이 관리자 시스템의 데이터와 업무 기능을 활용해 자연어 요청에 따라 정보를 조회·분석하는 환경을 목표로 했습니다.

다만 관리자 API를 LLM과 직접 연계하면 사용자별 인증·권한 정책을 유지하기 어렵고, 기존 시스템의 변경 범위가 커질 수 있었습니다. 기존 보안 체계를 재사용하면서 AI 기능을 점진적으로 확장할 수 있는 아키텍처가 필요했습니다.

01기존 인증·권한 체계 재사용
AI 전용 인증 체계를 추가하는 대신 Reverse Proxy를 통해 기존 인증 정보를 재사용하는 구조를 선택했습니다.
인증된 사용자의 권한 정보를 MCP 호출 과정에 전달하고, 실제 관리자 API 실행 시점에도 기존 권한 정책이 적용되도록 설계해 AI 도입에 따른 접근제어 문제를 해결했습니다.
02MCP Adapter로 기존 시스템과 AI 영역 분리
기존 REST API를 MCP에 직접 결합하지 않고 별도의 Adapter 계층을 두어 관리자 API를 MCP Tool 단위로 Wrapping했습니다.
MCP Tool 명세와 기존 업무 API를 독립적으로 관리할 수 있고, LLM이 내부 API 구조에 직접 의존하지 않아 시스템 간 결합도를 낮췄습니다.
03MCP Tool 탐색과 동적 선택
LLM이 사용 가능한 Tool 목록과 기능 요약을 먼저 확인한 뒤, 사용자 요청에 적합한 Tool을 선택하도록 구성했습니다.
자연어 질문에 따라 필요한 Tool을 호출하고, 반환된 데이터를 LLM이 취합·분석합니다. 사전에 정의된 화면이나 지표에 한정되지 않고 다양한 관점에서 데이터를 탐색할 수 있게 되었습니다.

Admin User

Reverse Proxy

Auth · Role 전달

LLM Agent

AWS Bedrock

MCP Server

Tool Discovery

MCP Adapter

Admin API ×80

기존 권한 정책

기존 인증 정보가 Reverse Proxy → MCP → Admin API까지 그대로 전달됩니다.