코리아 에이전트 맵Korea Agent Map

AI 코딩 에이전트로 내 서비스에 카드 결제를 연동할 수 있을까?Can an AI coding agent integrate Korean card payments into my service?

지금 가능Works today

토스페이먼츠, 포트원, NHN KCP가 공식 MCP 서버를 내놓아 Claude Code·Cursor·Codex가 공식 문서를 검색하며 결제 연동 코드를 작성합니다. 다만 실제 결제를 받으려면 PG사 가맹 계약과 심사를 사람이 직접 거쳐야 합니다.

Toss Payments, PortOne and NHN KCP ship official MCP servers so Claude Code, Cursor or Codex can search their docs while writing integration code. To take real payments you still need a PG merchant contract and review, done by a human.

연결하는 방법How to connect an agent

  1. 공식 MCPOfficial MCP

    토스페이먼츠 연동 가이드 MCPToss Payments integration-guide MCP

    npx -y @tosspayments/integration-guide-mcp@latest를 AI 도구의 MCP 설정에 추가하면 AI가 토스페이먼츠 문서를 직접 검색해 결제위젯·정기결제 코드를 작성합니다. 테스트 키로 샌드박스에서 먼저 확인할 수 있습니다.Add npx -y @tosspayments/integration-guide-mcp@latest to your AI tool's MCP config; the AI searches Toss Payments docs to write widget or billing code. You can test with sandbox keys first.

    필요한 것You need Node.js테스트 키(무료)Free test keys실결제 시 가맹 계약Merchant contract for live payments

    @tosspayments/integration-guide-mcp ↗
  2. 공식 MCPOfficial MCP

    포트원 MCP 서버PortOne MCP server

    npx -y @portone/mcp-server@latest를 추가하면 AI가 포트원 개발자센터 문서로 KG이니시스·NHN KCP·토스페이먼츠 등 여러 PG 연동 코드를 작성합니다. 콘솔에 로그인하면 결제 내역 조회와 테스트 채널 추가도 요청할 수 있습니다.Add npx -y @portone/mcp-server@latest; the AI uses PortOne docs to write integrations for multiple PGs (KG Inicis, NHN KCP, Toss Payments, etc.). After console login it can also list payments and add test channels.

    필요한 것You need Node.js 22.6+포트원 콘솔 계정PortOne console accountPG사 계약PG contract

    portone-io/mcp-server ↗
  3. 공식 MCPOfficial MCP

    NHN KCP 결제연동 MCPNHN KCP payment MCP

    KCP 개발자센터 안내대로 @nhnkcp-dev/paykit-mcp를 VS Code·Cursor에 등록하면 AI가 KCP 문서를 검색하며 연동을 돕습니다. JSP·PHP·Python·Node.js 등 언어별 로컬 실행 가이드도 함께 제공합니다.Register @nhnkcp-dev/paykit-mcp in VS Code or Cursor per KCP's developer center; the AI searches KCP docs while integrating. Language-specific local-run guides (JSP, PHP, Python, Node.js, etc.) are included.

    필요한 것You need Node.js 20+KCP 가맹 계약(실결제 시)KCP merchant contract (for live)

    @nhnkcp-dev/paykit-mcp ↗

주의할 점Before you start

  • MCP는 문서 검색과 코드 작성을 돕는 도구입니다. 가맹 계약, 카드사 심사, 정산 계좌 등록은 사람이 직접 해야 합니다.These MCPs help with docs and code; merchant contracts, card-issuer review and settlement setup are still human steps.
  • 결제 승인 전 서버에서 금액을 검증하는 코드가 들어갔는지 꼭 확인하세요. AI가 만든 코드는 배포 전 검토가 필요합니다.Make sure the code verifies the amount server-side before approving a payment; review AI-written code before deploying.
  • 시크릿 키는 서버에만 두고, 콘솔 조회 결과를 외부 AI에 보낼 때는 고객 개인정보가 섞이지 않게 하세요.Keep secret keys server-side only, and avoid sending customer personal data from console lookups to an external AI.

참고한 출처Sources

공개 자료를 바탕으로 2026.10.12에 정리했습니다. 모든 방법을 직접 실행해 검증한 결과는 아니며, 도구 소개가 공식 지원이나 안전을 보장하지 않습니다. 이용 약관과 최신 문서를 함께 확인해 주세요.Compiled from public sources on 2026.10.12. Not every path was executed by us; listing a tool does not guarantee official support or safety. Check the terms and current docs. 정정 제보Suggest a correction

실제 사례Reported cases

개발Software·발표·출시Announcements·출처 날짜Source date

토스페이먼츠가 결제 연동용 MCP 서버를 냈다Toss Payments shipped an MCP server for payment integration

토스페이먼츠가 결제 연동을 AI 챗봇 자연어로 처리하게 하는 MCP 서버를 도입해 연동 기간을 10분 내로 줄인다고 밝혔다.Toss Payments introduced an MCP server so developers can integrate payments via natural-language AI chat, claiming setup in about 10 minutes.

ClaudeCursor토스
토스페이먼츠 · 토스피드 ↗
돈·세금·행정Money, tax & admin·기업·기관Organizations·출처 날짜Source date

카카오페이가 결제 API용 MCP Agent Toolkit을 만들었다Kakao Pay built an MCP Agent Toolkit for its payment API

카카오페이는 결제 준비·승인·취소·조회·정기결제 등 8개 Tool로 AI 에이전트가 결제 Open API를 호출하게 했고 LangChain, OpenAI, Vercel AI SDK 연동을 보여줬다.Kakao Pay built an MCP toolkit with 8 tools (ready, approve, cancel, query, subscription) so agents can call its payment Open API, with LangChain, OpenAI and Vercel AI SDK integrations.

LangChain카카오페이
카카오페이 · Velopers (카카오페이 기술블로그 요약) ↗

새 가이드와 사례를 격주 뉴스레터로 받아보기Get new guides and reports every two weeks