NHN KCP PayKit MCP Server

NHN KCP 결제 시스템 연동 가이드를 제공하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 AI 어시스턴트가 NHN KCP 결제 연동 문서에 쉽게 접근할 수 있도록 도와줍니다. VS Code Copilot, Cursor, Windsurfe등과 같은 AI 개발 도구에서 사용할 수 있습니다.

주요 기능

제공 도구

1. search-docs

결제 연동 문서를 검색하고 전체 내용을 조회합니다.

• 구체적인 구현 방법이 필요할 때
• 코드 예시와 파라미터 상세 정보가 필요할 때

2. search-docs-summary

문서 제목과 요약만 빠르게 조회합니다.

• 어떤 문서가 있는지 둘러볼 때
• 다수의 검색 결과에서 원하는 문서를 선택할 때

3. get-doc

특정 문서 ID로 전체 내용을 조회합니다.

• search-docs-summary로 찾은 문서의 상세 내용을 볼 때
• 특정 문서를 직접 조회할 때

설정

MCP 설정

MCP 설정 파일에 다음을 추가하세요:

VS Code / Cursor / Windsurf (mcp.json):

{
  "mcpServers": {
    "nhnkcp-paykit": {
      "command": "npx",
      "args": ["@nhnkcp-dev/paykit-mcp"]
      // 로그 수집을 원하는 경우 아래 설정 추가
      // "env": {
      //   "LOG_FILE_PATH": "C:\\logs\\paykit"  // Windows
      // }
    }
  }
}

사용 예시

MCP 서버가 연결되면 다음과 같은 질문을 AI에게 할 수 있습니다:

결제 연동 방법

• "표준결제창 연동 방법을 알려줘"
• "모바일 표준결제 필수 파라미터가 뭐야?"
• "네이버페이 호출하는 방법 알려줘"
• "카드사 다이렉트 결제 연동 코드 예시를 작성해줘"

자동결제/정기결제

• "배치키로 자동결제하는 방법을 알려줘"
• "정기결제 배치키 발급 방법은?"
• "자동결제 승인 요청 파라미터 알려줘"

문서 탐색

• "카드 결제 관련 가이드가 뭐가 있지?"
• "간편결제 문서 목록 보여줘"
• "에스크로 관련 문서 찾아줘"

오류 해결

• "E0010 오류코드에 대해 설명해줘"

라이선스

MIT License

지원

• 개발지원센터: https://developer.kcp.co.kr