REST API의 컨텍스트 한계를 극복한 MCP 기반 AI Agent 최적화 설계

Context

개발자 중심의 REST API 설계가 AI Agent의 자율적 판단에 필요한 도메인 컨텍스트 부족을 야기함. 단순한 JSON 구조 제공만으로는 Agent의 잘못된 추측과 런타임 오류를 방지하기 어려운 구조적 한계 존재.

Technical Solution

• 기존 REST API를 유지한 채 AI 전용 인터페이스인 MCP Server를 레이어로 추가하는 Wrapper 구조 설계
• 단순 Endpoint 호출 대신 의도(Intent) 중심의 Tool 정의를 통해 Agent에게 실행 목적과 입력/출력 스키마를 명시적으로 제공
• 정적 데이터 접근을 위한 Resource 정의를 도입하여 Agent가 필요한 컨텍스트를 스스로 탐색하고 추출하는 메커니즘 구현
• 재사용 가능한 Prompt Template 설계를 통해 Agent의 추론 경로를 최적화하고 일관된 상호작용 패턴 유지
• OAuth 2.0 기반의 권한 모델을 MCP Tool에 그대로 투영하여 사용자 권한 범위를 초과하는 Agent의 동작을 원천 차단