AI
AI 에이전트와 카카오페이 결제 오픈 API 연동하기: MCP Agent Toolkit 개발기
두줄요약
카카오페이는 AI 에이전트가 결제 API를 호출할 수 있도록 MCP 기반 Agent Toolkit을 개발했습니다. 표준 프로토콜과 멀티 프레임워크 지원으로 결제 연동의 확장성과 호환성을 높였습니다.
핵심 내용
- 카카오페이 결제 API를 AI 에이전트와 연동하기 위해 Model Context Protocol(MCP)을 도입한 개발기
- OpenAI function calling, LangChain tool 방식의 프레임워크 종속성과 확장성 한계를 보완하기 위한 표준화 접근
- 결제 준비, 승인, 취소, 조회와 정기결제까지 총 8개 Tool을 설계해 자연어 기반 결제 처리를 지원
- LangChain, OpenAI, Vercel AI SDK, MCP 호스트 연동과 챗봇 데모를 통해 실제 활용 구조를 제시
구조와 흐름
- 사용자 자연어 요청에서 의도와 파라미터를 추출해 적절한 Tool 호출로 연결
- MCP Server가 카카오페이 Open API 요청 형식으로 변환해 실행하고 결과를 LLM에 반환
- Shared Core, API Client, Handler, Configuration, Tools Registry로 멀티 프레임워크 공통 구조를 분리
선택 이유
- 특정 AI 프레임워크에 묶이지 않는 호환성 확보
- 새로운 도구와 프레임워크를 추가하기 쉬운 확장성 확보
- 표준 프로토콜 기반으로 유지보수성과 개발 생산성 개선
적용해볼 점
- AI 에이전트 연동 범위와 권한을 Tool 단위로 명확히 분리
- 표준 프로토콜과 공통 코어를 중심으로 여러 프레임워크를 함께 지원하는 구조 검토
- 실제 챗봇 예제로 사용자 경험과 운영 가능성까지 함께 확인