핵심 요약
토스가 Swagger MCP 서버를 도입해 API 스펙 공유를 자동화하고, LLM 컨텍스트를 활용해 개발 생산성을 높인 경험을 공유합니다.
주요 경험
- SSE의 세션 끊김 문제를 해결하기 위해 Stateless Streamable-HTTP와 ASYNC 실행 모드를 적용했습니다.
- Tools를 @Tool 애너테이션 기반으로 선언적으로 개발하고 현재 시간을 LLM에 제공하는 등 컨텍스트를 보강했습니다.
- Swagger MCP 구현은 SwaggerCenter를 통한 서비스 목록 조회, API 스펙의 간소화 및 단계별 정보 추출과 컴포넌트 스키마 참조 처리로 API 공유를 체계화했습니다.
얻은 인사이트
- LLМ에 충분한 API 정보 제공과 필요 시 RAG 구성을 통해 도메인 지식을 보완하는 것이 중요하다는 것을 확인했습니다.
- 자동화(GitHub Actions)와 디버깅 도구(MCP Inspector)로 개발 생산성이 크게 증가했습니다.
- 컨텍스트 관리 중심의 도구 설계가 생산성 향상에 직접 기여하는 것을 확인했습니다.
