Guide > MCP로 결제연동

KCP MCP로 결제연동

VS Code, Cursor 같은 AI 개발도구로 NHN KCP 결제모듈을 더 빠르고 정확하게 연동할 수 있습니다. NHN KCP는 AI 개발도구와 에이전트가 연동에 필요한 정보를 정확히 참고할 수 있도록 llms.txt 파일과 전용 MCP 서버를 제공합니다.

사용 중인 에디터에 KCP 결제연동 MCP 서버를 등록하면, AI가 관련 문서를 직접 검색하고 연동 과정에서 궁금한 점을 바로 확인할 수 있습니다. 아래에 원클릭 자동연결 및 mcp.json 설정을 통한 수동연결을 통해 KCP MCP를 사용할 수 있습니다.

1. 요구사항

Node.js LTS 20+ (권장)
npm 9+ (npx 포함)
LLM+MCP 지원 에디터 (선택): VS Code, Cursor, Windsurf 등

2. 내 개발 언어 환경 준비하기

MCP 서버를 설치하기 전에, 먼저 내 결제 백엔드가 사용하는 개발 언어를 로컬에서 실행할 수 있어야 합니다.
아래에서 사용하시는 언어를 선택하면, 초보 개발자·비개발자도 따라 할 수 있는 로컬 실행 가이드로 이동합니다.

JSP JSP PHP PHP ASP ASP .NET .NET JS Node.js PY Python

KCP MCP 서버 자체는 Node.js·npm 환경에서 동작합니다. 어떤 언어로 결제 백엔드를 만들든, MCP 서버를 쓰려면 아래 3. Node.js와 npm 설치 단계를 함께 진행해 주세요.

3. Node.js와 npm 설치 방법

KCP MCP 서버는 npm으로 배포되므로, Node.js와 npm은 반드시 설치되어 있어야 합니다.

Node.js를 설치하면 npm(Node Package Manager)도 함께 자동으로 설치됩니다. 별도로 npm을 따로 설치할 필요는 없습니다.

용어	쉽게 말하면
터미널	명령어를 입력하는 창. Windows는 `PowerShell`, Mac은 `터미널` 앱입니다.
Node.js	MCP 서버를 돌리는 실행 환경. 컴퓨터에 한 번만 설치하면 됩니다.
npm / npx	패키지를 받아 실행하는 도구. Node.js 설치 시 함께 들어옵니다.

Windows macOS

nodejs.org에 접속해 "LTS(Long Term Support)" 버전을 다운로드합니다.
설치 완료 후, 시작 메뉴에서 '명령 프롬프트(cmd)'를 열고 아래 명령어로 버전을 확인합니다.

터미널을 열고 brew install node@20을 실행하거나 nodejs.org에서 macOS용 설치 파일을 받아 실행합니다.
설치 후 터미널에서 아래 명령어로 버전을 확인합니다.

terminal

node -v
npm -v

4. npm 버전이 확인되지 않는 경우

일반적으로 Node.js를 설치하면 npm도 자동으로 함께 설치됩니다. 그러나 일부 환경에서는 npm이 누락될 수 있습니다. (예: 오래된 macOS 버전 등) 이 경우 아래 방법 중 하나로 해결할 수 있습니다.

방법 1. npm만 별도로 재설치

terminal

npm install -g npm

방법 2. Node.js를 최신 LTS 버전으로 다시 설치

nodejs.org에서 LTS(Long Term Support) 버전을 다운로드해 재설치하면 npm이 함께 포함됩니다. 설치 후 아래 명령어로 npm이 정상적으로 인식되는지 확인하세요.

terminal

npm -v

5. 코드에디터에서 KCP MCP 서버 연동하기

VS Code Cursor Windsurf

VS Code 설치 방법

VS Code 공식 사이트에서 다운로드하여 설치합니다.

VS Code 설정 방법

원클릭 자동연결 바로가기

원클릭 자동연결

VS Code에서 MCP 서버를 원클릭으로 연결하는 방법 영상

nhnkcp-paykit-mcp

CONFIGURATION

Name:: nhnkcp-paykit-mcp
Type:: stdio
Command:: npx
Arguments:: -y @nhnkcp-dev/paykit-mcp@latest

자동연결을 클릭하면 VS Code가 실행되고, 위와 같이 MCP 서버 설치 화면으로 넘어가며 Install 버튼을 클릭하면 설치가 시작됩니다.

mcp.json 설정을 통한 수동연결

VS Code에서 MCP 서버를 수동으로 연결하는 방법 영상

"Help" > "Show All Commands" 커맨드 검색 창을 오픈합니다. (단축키: Ctrl+Shift+P)
커맨드 검색 창에서 mcp.json을 검색하고 "MCP: Open User Configuration" 항목을 선택합니다.

해당 파일에서 아래와 같이 mcpServer를 설치하면, 아래 추가 절차를 따라 Copilot에게 도구를 지정할 수 있습니다.

mcp.json

{
  "servers": {
    "nhnkcp-paykit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nhnkcp-dev/paykit-mcp@latest"
      ],
      "type": "stdio"
    }
  }
}

채팅 패널 좌측 하단의 Set Mode에서 "Ask" → "Agent"로 변경합니다.
Agent 모드에서 "Configure Tools"를 선택하면 설치된 MCP Server: nhnkcp-paykit-mcp를 사용할 수 있습니다.

Cursor 설치 방법

Cursor 공식 사이트에서 다운로드하여 설치합니다.

Cursor 설정 방법

원클릭 자동연결 바로가기

원클릭 자동연결

Cursor에서 MCP 서버를 원클릭으로 연결하는 영상

자동연결을 클릭하면 Cursor가 실행되고, 위와 같이 MCP 서버 설치 화면으로 넘어가며 Install 버튼을 클릭하면 설치가 시작됩니다.

mcp.json 설정을 통한 수동연결

Cursor에서 MCP 서버를 수동으로 연결하는 영상

Cursor 우측 상단의 'Toggle AI Pane' 버튼으로 채팅 화면을 띄운 뒤, ··· 버튼을 누르고 나오는 메뉴에서 'Chat Settings'를 클릭합니다.
채팅 설정 화면으로 이동하면, 좌측 네비게이션에서 'Tools & Integrations'를 클릭합니다.
'Tools & Integrations' 화면에서 'Add Custom MCP' 버튼을 클릭합니다.

'Add Custom MCP' 클릭 시 생성되는 mcp.json 파일에 아래와 같이 mcpServers를 설정합니다.

mcp.json

{
  "mcpServers": {
    "nhnkcp-paykit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nhnkcp-dev/paykit-mcp@latest"
      ],
      "env": {}
    }
  }
}

등록한 MCP 서버는 'Tools & Integrations' 메뉴에서 연결 상태를 확인할 수 있으며, 상태 표시가 초록불이면 연결 완료입니다.
채팅창 좌측 하단에서 채팅 모드를 "Agent"로 설정한 뒤 질의하면, KCP 결제모듈 연동 방법을 자세히 안내받을 수 있습니다.

Windsurf 설치 방법

Windsurf 공식 사이트에서 다운로드하여 설치합니다.

Windsurf 설정 방법

mcp.json 설정을 통한 수동연결

Windsurf에서 MCP 서버를 수동으로 연결하는 영상

Windsurf 우측 상단의 'Toggle Cascade Side Bar' 버튼으로 채팅 화면을 띄운 뒤, 채팅창 상단에서 'Customizations' 버튼을 누릅니다. 그 후 나오는 창에서 가장 우측의 옵션 버튼을 클릭하여 mcp_config.json 파일을 생성하고 편집할 준비를 합니다.

mcp_config.json 파일에 아래와 같이 mcpServers를 설정합니다.

mcp_config.json

{
  "mcpServers": {
    "nhnkcp-paykit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nhnkcp-dev/paykit-mcp@latest"
      ]
    }
  }
}

채팅 화면 하단에서 채팅 설정을 'Code'로 변경한 뒤 질의하면, KCP 결제모듈 연동 방법을 자세히 안내받을 수 있습니다.

상단 탭에서 사용하시는 에디터를 선택하면 해당 에디터의 연동 방법을 확인할 수 있습니다. 세 에디터 모두 동일한 command·args 설정으로 연동됩니다.

결제 수단·기능을 명시해 주세요

에러 코드는 그대로 붙여 넣기 해주세요

작업(생성·발급 등)을 구체적으로 기재해 주세요

예시 질문이 복사되었습니다