NICEPAY 결제 연동을 위한 MCP 툴 (https://start.nicepay.co.kr)
npm install @nicepay/start-api-mcp@nicepay/start-api-mcp 패키지는 NICEPAY FOR START API와 질문 데이터를 기반으로, Model Context Protocol 환경에서 사용할 수 있는 결제 API Tool과 QnA Tool을 제공합니다.
- Github Nicepay 프롬프트 가이드 보기
- Github Nicepay API 문서 보기
> 프롬프트 가이드, API 문서를 참고하면 빠른 진행이 가능합니다.
---
mcpServers 항목에 추가한 뒤, MCP 시스템을 재시작합니다. ``json`
"mcpServers": {
"nicepay-start-api-mcp": {
"command": "npx",
"args": [
"-y",
"@nicepay/start-api-mcp@latest"
]
}
}
> Node.js 20.0.0 이상이 필요합니다.
---
#### 사전 준비 사항
| 항목 | 내용 |
|----------------|----------------------------------------------------------------------|
| 관리자 계정 | https://start.nicepay.co.kr 로그인 필요 |
| 개발 정보 접근 | 로그인 후 개발정보 메뉴에서 API 키 발급, 테스트 로그 조회 등 가능 |
---
1. NICEPAY 관리자 사이트 접속 → https://start.nicepay.co.kr
2. 로그인 후 좌측 메뉴에서 개발정보 클릭
3. KEY 정보 항목에서 아래 정보를 확인하거나 신규 발급 가능:
- Client Key / Secret Key: API 인증용 고유 키
- 신규 발급 시 두 키가 함께 생성되며, Base64 인코딩하여 사용
> 운영용 키는 외부에 노출되지 않도록 주의하세요.
---
NICEPAY는 테스트와 운영 환경을 도메인 기준으로 완전히 분리하여 제공합니다.
| 구분 | API 도메인 URL | 설명 |
|------------|-----------------------------------------|---------------------------|
| 샌드박스 | https://sandbox-api.nicepay.co.kr | 개발 및 테스트 전용 환경 |https://api.nicepay.co.kr
| 운영(Live) | | 실제 결제 처리 환경 |
> API 호출 시 환경에 맞는 도메인을 정확히 사용해야 합니다.
---
| Tool 이름 | API 이름 | 설명 |
|-----------------------------------|----------------------------------|------|
| create_payment_window | 결제창 호출 | NICEPAY JS SDK를 사용해 브라우저에서 결제창을 호출합니다. |
| approve_payment | 결제 승인 | 결제 인증 후 거래를 승인 처리합니다. |
| cancel_payment | 결제 취소 | 전체 또는 부분 결제를 취소합니다. |
| create_billing_key | 빌링키 발급 | 암호화된 카드 정보를 이용해 정기결제용 빌링키를 발급합니다. |
| approve_billing_payment | 빌링키 결제 승인 | 발급된 빌링키를 통해 정기결제를 승인합니다. |
| expire_billing_key | 빌링키 만료 | 더 이상 사용하지 않는 빌링키를 만료(삭제) 처리합니다. |
| create_cash_receipt | 현금영수증 발급 | 현금 결제 건에 대한 현금영수증을 발급합니다. |
| cancel_cash_receipt | 현금영수증 취소 | 이미 발급된 현금영수증을 취소합니다. |
| get_cash_receipt_status | 현금영수증 상태 조회 | 현금영수증의 처리 상태를 조회합니다. |
| find_payment_by_order_id | 거래 내역 조회 | 주문번호를 기준으로 결제 내역을 조회합니다. |
| get_terms | 약관 조회 | 전자금융거래, 개인정보 수집 등 관련 약관 내용을 조회합니다. |
| get_card_promotions | 카드 이벤트 조회 | 카드사의 포인트 적립 및 무이자 혜택 정보를 조회합니다. |
| list_interest_free_installments | 무이자 할부 정보 조회 | 카드사별 무이자 할부 조건을 조회합니다. |
| search_nicepay_qna | QnA 유사질문 검색 | NICEPAY 연동과 관련된 FAQ 데이터셋을 기반으로 조회하여, 유사한 QnA 응답을 반환합니다. |
> create_payment_window Tool은 브라우저 기반으로 실행되는 클라이언트용 Tool입니다. 서버에서는 사용할 수 없습니다.
---
---