AI 에이전트와 카카오페이 결제 Open API 연동하기: MCP Agent Toolkit 개발기

AI 에이전트가 function calling을 통해 외부 시스템을 조작할 수 있게 되면서, 결제 시스템과의 연동이 핵심 과제로 부상했다. 카카오페이는 기존 OpenAI function calling이나 LangChain tool 방식의 프레임워크 종속성과 확장성 한계를 해결하기 위해 **Model Context Protocol(MCP)**을 도입했다.

MCP는 AI 모델과 외부 도구 간의 표준화된 통신 프로토콜이다. 이를 통해 Claude, GPT 등 다양한 LLM과 Claude Desktop, Cursor 같은 호스트 환경에서 프레임워크에 구애받지 않고 결제 기능을 사용할 수 있다.

카카오페이는 결제 및 정기결제 프로세스를 지원하기 위해 총 8개의 Tool을 설계하여 제공한다.

• 결제 관련: 데모 결제, 결제 준비, 승인, 상태 조회, 취소
• 정기결제 관련: 정기결제 요청, 상태 조회, 비활성화

전체 아키텍처는 AI Agent가 **MCP Server(Agent Toolkit)**를 거쳐 KakaoPay API를 호출하는 구조로, 개발자가 다양한 AI 환경에서 표준화된 방식으로 결제 기능을 구현할 수 있도록 돕는다.