AI
토스페이먼츠 결제 시스템 연동을 돕는 MCP 서버 구현기
두줄요약
AI 코딩 도구의 결제 연동 정확도를 높이기 위해 토스페이먼츠가 MCP 서버를 구현한 과정을 공유했습니다. 문서 청크화와 BM25 검색으로 맥락을 제공해 Hallucination을 줄이고 연동 품질을 개선했습니다.
문제 상황
- AI 기반 코딩 도구만으로 토스페이먼츠 결제 연동 코드를 생성하면 정확도 저하와 스펙 오류 발생
- 긴 문서와 분산된 맥락 때문에 중요한 정보 유실, Hallucination 증가
해결 방법
- MCP 서버로 개발자 센터 문서 맥락을 AI 도구에 제공하는 구조 구성
- llms.txt, 문서 청크 분할, BM25 기반 검색, 인접 청크 윈도우 전달로 탐색 품질 개선
- v1/v2 문서 분리와 문서 ID 조회 도구로 질의 흐름 세분화
성능/운영 포인트
- 로컬 기반 MCP로 여러 클라이언트에서 재사용 가능한 연동 환경 구성
- 문서 버전업을 CI/CD와 함께 따라가도록 설계
- 문서 길이, 한국어 토큰화, 검색 정밀도에 따른 개선 여지 확인
적용해볼 점
- 결제 연동 같은 복잡한 API 문서는 AI용 검색 맥락을 별도 설계할 필요
- 도메인별 문서 분리와 키워드 가중치 조정으로 추가 개선 가능