@portone/mcp-server 0.14.0 → 0.15.0-alpha.0

package/assets/docs/opi/ko/support/contact.md

@@ -8,16 +8,4 @@ targetVersions:
 
 포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요.
 
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-- V1: <support@portone.io>
-- V2: <tech.support@portone.io>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-- V2: <tech.support@portone.io>
-- V1: <support@portone.io>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+- <tech.support@portone.io>

package/assets/docs/opi/ko/support/pg-terms.md

@@ -0,0 +1,233 @@
+---
+title: 용어 사전
+description: 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+## 결제 대행 관련
+
+### PG (Payment Gateway)
+
+PG는 온라인 결제에서 결제 정보를 송수신하고 정산을 매개하는 서비스입니다. 온라인 결제를 받기 위해서는 PG사와의 계약과 연동이 필요합니다. 법적으로는 전자금융업상 전자지급결제대행업에 해당합니다.
+
+PG에 따라 신용카드, 계좌이체, 가상계좌, 휴대폰 결제 등 다양한 결제 수단을 이용할 수 있으며, "결제의 관문"이라는 이름처럼 알맞은 시스템으로 결제 정보를 전달합니다.
+
+### 포트원 원 페이먼트 인프라 (OPI)
+
+다양한 PG의 파편화된 인터페이스를 통일하여 현대적인 연동 경험을 제공하는 **결제 오케스트레이션 서비스**입니다. 이를 통해 PG를 쉽게 연동 및 추가/변경하고, 다중 PG 시스템을 운영할 수 있습니다.
+
+<div class="hint" data-style="info">
+
+OPI 서비스는 결제 정보를 송수신하지만 자금 이동에는 관여하지 않습니다.
+
+</div>
+
+### PG 상점 아이디 (MID)
+
+PG에서 상점에 부여하는 고유 식별자입니다. PG와의 계약을 통해 발급되며, 결제 수단, 과세 여부, 수수료 등 여러 설정이 MID 단위로 관리됩니다. PG 정책에 따라서는 이용 서비스 및 세부 설정별로 여러 개의 MID를 발급하기도 합니다.
+
+포트원을 이용할 때에는 채널을 추가할 때 MID를 입력합니다.
+
+<div class="hint" data-style="info">
+
+**PG사별 상점 아이디 명칭**
+
+- KG이니시스: 상점 아이디(MID)
+- 카카오페이: 고객사 코드(CID)
+- 네이버페이: 파트너 ID (하위 식별자로 체인 ID 존재)
+- 토스페이먼츠: 상점 아이디(MID)
+- NHN KCP: 사이트 코드
+
+</div>
+
+### 포트원 상점 아이디 (storeId)
+
+포트원 관리자 콘솔에서 확인할 수 있는 상점 식별자입니다. 연동 시 `storeId`라는 이름으로 많은 API에 등장합니다.
+
+포트원 V1에서는 고객사 식별코드라는 별도 값을 이용합니다.
+
+## 결제 방식 관련 용어
+
+### 간편결제사
+
+네이버페이, 카카오페이, 토스페이, 페이코와 같이 신용카드나 계좌번호 등의 결제 정보를 등록해 비밀번호 입력, 지문 인식만으로 결제할 수 있는 서비스를 제공하는 사업자입니다.
+
+### PG 제휴 간편결제
+
+간편결제사와 직접 계약을 맺지 않고 일반 PG사와의 계약만으로 간편결제사의 서비스 이용이 가능한 서비스입니다. 구매자가 보기에는 동일한 간편결제사의 결제창이 호출됩니다.
+
+<div class="hint" data-style="warning">
+
+**PG 제휴 간편결제 주의사항**
+
+PG 제휴로 간편결제를 이용할 경우 간편결제 포인트 적립이 안 되는 등 일부 기능을 사용할 수 없는 경우가 있습니다.
+
+</div>
+
+### 인증결제
+
+신용카드, 간편결제, 계좌이체, 휴대폰 결제 등에서 결제 정보가 본인임을 확인하는 과정을 거친 이후 결제되는 방식을 총칭합니다. 쇼핑몰 등에서 이용되는 일회성 결제로 가장 일반적인 결제 방식입니다.
+
+### 키인결제
+
+카드 번호 등 결제 정보를 구매자로부터 직접 입력받아 API 호출을 통해 결제를 일으키는 비인증결제 방식입니다.
+
+### 빌링결제
+
+구매자에게 최초 1회 결제 정보를 입력받아 빌링키를 발급함으로써, 이후에 고객사에서 임의 시점에 결제를 반복하여 일으키는 결제 방식입니다. 결제를 일으킬 때에는 별도로 사용자 인증이 필요 없으므로 비인증결제에 속합니다. 정기결제 등을 구현하기 위해 사용합니다.
+
+<div class="hint" data-style="warning">
+
+**빌링키 사용 제한**
+
+빌링키는 해당 빌링키를 발급한 PG에서만 사용 가능합니다. 또, 빌링키를 다른 포트원 상점 또는 다른 PG MID로 이관하려면 별도 요청이 필요합니다.
+
+</div>
+
+## 거래 식별 관련 용어
+
+### 결제 ID (paymentId, 고객사 주문번호)
+
+결제를 요청할 때 고객사가 채번한 고유 번호입니다. V1에서는 `merchant_uid`라는 이름을 사용합니다.
+
+### PG 거래번호 (TID)
+
+PG사가 채번한 거래 번호입니다. PG사에 따라 취소 건에도 별도의 거래 번호를 부여할 수 있습니다.
+
+### 카드 승인번호
+
+승인 성공 시 카드사가 부여한 8자리 숫자로, 매입을 진행하거나 취소를 할 때 필요합니다. 당일에 한 카드사에 유니크하나 몇몇 카드사는 당일에 중복되는 경우도 있습니다.
+
+## 카드 결제
+
+신용/체크/선불카드를 통한 결제는 인증, 승인, 매입의 과정을 거칩니다.
+
+### 인증 (Authentication)
+
+인증결제에서, 카드 소유주가 본인임을 확인하는 과정입니다. 웹에서 비밀번호를 입력하거나 앱에서 지문 인식을 하는 등 카드사마다 방식이 다릅니다.
+
+### 승인 (Authorization)
+
+승인 거래가 생성되고, 카드 한도를 차감합니다. 실제로 대금이 이동하지는 않습니다.
+
+포트원에서는 인증이 완료되면 자동으로 승인을 진행합니다. 또는, V2에서 수동 승인 기능을 이용하면 인증 후 승인 요청을 별도로 할 수 있습니다.
+
+### 매입 (Capture)
+
+매입은 승인된 카드 거래의 대금을 청구하는 일을 말합니다. 일반적으로 PG가 매일 정해진 시간에 승인 건들을 모아 자동으로 매입합니다.
+
+결제 승인 시점과 상품 공급 시점이 크게 다른 상점에서는 자동 매입을 끄고 PG에 건별로 매입을 요청하는 수동 매입을 이용할 수 있습니다. 매입이 오랫동안 일어나지 않으면 자동으로 승인이 취소됩니다. 포트원에서는 아직 수동 매입을 지원하지 않습니다.
+
+카드 결제를 취소할 경우 원리상 매입 전 취소와 매입 후 취소가 구분되고, 매입 후 취소는 보통 3\~4 영업일이 소요됩니다.
+
+## 카드 관련 용어
+
+### 카드사 유형
+
+신용, 체크카드와 관련된 개념으로 발급사, 매입사, 네트워크(브랜드)가 있습니다.
+
+- **발급사**: 카드를 발급한 회사
+- **매입사**: 상점과 계약하여 카드 거래 매입을 담당하는 회사
+- **네트워크**: 매입사와 발급사 사이를 중개하는 인프라 (비자, 마스터카드, JCB, 아메리칸 익스프레스, 다이너스 클럽, 디스커버, 유니온페이 등)
+
+국내는 카드에 따라 매입사가 하나로 정해져 있기 때문에 PG가 각 매입사와 계약을 맺습니다.
+
+<div class="hint" data-style="info">
+
+**예시: 카카오뱅크 카드**
+
+- 발급사: 카카오뱅크
+- 매입사: 국민카드
+- 네트워크: 없음 (해외 사용 시 비자, 마스터카드 등 선택)
+
+</div>
+
+### PLCC (Private Label Credit Card)
+
+상업자표시 신용카드로, 카드명에 특정 브랜드를 표기한 것을 말합니다. 제휴 업체와 함께 카드 상품을 공동으로 기획하여 비용과 수익을 분담하며, 제휴사의 충성도 높은 고객을 확보할 수 있는 장점이 있습니다.
+
+**PLCC 예시:**
+
+- 스타벅스 현대카드
+- 배민 현대카드
+- 11번가 신한카드
+
+### 제휴카드
+
+카드사가 특정 기업 혹은 단체와 협약을 맺어 발급하는 카드입니다. 카드사는 제휴사 카드 상품을 출시하고 마케팅 비용이나 카드 수익 등을 모두 관리하며, 반면 제휴사는 카드 모집만 담당합니다.
+
+## 기타 결제 관련 용어
+
+### 가상계좌
+
+은행이 고객사에 발급한 입금 전용 계좌로, 고객사는 납부자와 가상계좌 번호를 일대일로 매핑하여 발급합니다. 보통 가상계좌는 입금 시 바로 삭제되며 해당 계좌번호는 재활용되어 다른 납부자에게 발급될 수 있습니다.
+
+### 고정식 가상계좌
+
+전기요금 고지서처럼 납부자가 하나의 입금 계좌번호를 부여받아 지속적으로 입금하고자 할 때 이용하는 가상계좌입니다.
+
+### 에스크로
+
+구매자의 구매 확인 의사인 구매결정을 통보받은 후 판매자에게 결제 대금을 지급하는 안전한 결제 서비스입니다. 2006년 4월 1일부터 에스크로 의무화 시행에 따라 가상계좌, 계좌이체와 같은 모든 현금 거래에는 의무적으로 적용해야 합니다.
+
+## 취소
+
+결제 완료 이후에 API나 콘솔을 통해 결제를 취소할 수 있습니다. 결제 금액의 일부만 취소하는 것도 가능합니다.
+
+가상계좌 환불이나 휴대폰 익월 환불의 경우 환불받을 계좌를 입력해야 합니다.
+
+환불 가능 기한이 지난 등의 이유로 PG를 통한 취소가 불가능한 경우에는 고객사에서 직접 구매자에게 자체 환불 처리해야 합니다.
+
+### 카드
+
+매입 전 취소의 경우 즉시 환불됩니다. 매입 후 취소는 일반적으로 3\~4 영업일이 소요됩니다.
+
+### 계좌이체
+
+즉시 환불됩니다.
+
+### 가상계좌
+
+환불받을 계좌를 입력해야 환불이 가능합니다. 일반적으로 2 영업일이 소요됩니다.
+
+### 휴대폰
+
+결제가 일어난 해당 월에만 취소가 가능합니다. 실제 지불 전이므로 즉시 취소됩니다. 일부 PG에서는 익월 환불이라 하여 해당 월이 지난 뒤에도 계좌로 환불하는 기능을 제공합니다.
+
+## 세금 관련 용어
+
+### 부가가치세
+
+일반적으로 매출 발생시 10%의 부가가치세를 국가에 납부해야 합니다. 또한, PG 서비스 수수료에도 10%의 부가가치세가 발생합니다. 수수료에 대한 부가가치세는 매입 세액에 속합니다.
+
+<div class="hint" data-style="info">
+
+**정산 수수료 계산 예시**
+
+1,000원의 결제에 대해 3%의 수수료를 적용한다면:
+
+- 수수료: 30원
+- 수수료 부가세: 3원 (수수료의 10%)
+- 정산 금액: 967원
+
+</div>
+
+### 면세
+
+세금을 부과하지 않는 소득을 의미합니다. 저소득층의 세금 부담 경감 또는 기타 정책적 목적으로 일부 재화나 용역의 공급에 대해 부가가치세를 면제하는 것을 말합니다. 대표적으로 기초생활필수품, 문화 관련 재화, 용역 등이 있습니다.
+
+### 영세율
+
+일정한 재화 또는 용역의 공급에 대해 0의 세율을 적용하는 제도로, 수출업자, 기타 외화 획득 사업자 등이 영세사업자로 적용됩니다.
+
+## 할인 관련 용어
+
+### 즉시할인
+
+상품의 가격에 즉시 할인 금액을 적용하여 할인된 금액을 결제하는 방식입니다.
+
+### 청구할인
+
+본래의 상품 가격을 결제했다가 조건 충족 시 결제 대금의 할인된 금액이 반영되는 방식입니다. 청구할인은 할인 여부를 챙겨봐야 하기 때문에 즉시할인이 납부자에게 더 선호됩니다.

package/assets/docs/platform/ko/guides/dictionary.md

@@ -1,20 +1,140 @@
 ---
 title: 용어 사전
-description: ''
+description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
 ---
 
-|   용어   |                                             설명                                             |                                                         비고                                                        |
-|:--------:|:--------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|
-|   콘솔   |  포트원의 거래내역을 확인하고 파트너와 정산을 등록하고 내역을 확인 할 수 있는 솔루션입니다.  |                                   [관리자콘솔 바로가기](https://admin.portone.io)                                   |
-|  고객사  |                   포트원의 결제서비스를 이용하고 있는 포트원의 고객입니다.                   |                                                                                                                     |
-|  파트너  |              고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 입니다.              |                                                                                                                     |
-|결제사정산|          포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산          |                                                                                                                     |
-|파트너정산|                      결제사정산 이후에 고객사가 파트너에게 내려주는 정산                     |                                                                                                                     |
-|   계약   |            고객사와 파트너 사이에 정산이 이루어지기 위한 조건(중개수수료, 주기 등)           |                                                                                                                     |
-|  영업일  |                            은행이 영업을 하는 날로, 휴일이 아닌 날                           |10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11,12,13일의 전영업일은 10일이고, 10,11,12일의 후영업일은 13일입니다.|
-|  달력일  |                                    휴일과 상관없는 단순일                                    |                                                                                                                     |
-|  수수료  |                               절차 및 중개 등 때 수수하는 금전                               |                                                                                                                     |
-|  부가세  |상품(재화)의 거래나 서비스(용역)의 제공과정에서 얻어지는 부가가치(이윤)에 대하여 과세하는 세금|                일반과세자는 10%의 세율이 적용함으로, 수수료가 3천원 일 경우, 부가세는 300원으로 계산                |
-|할인분담금|                    할인금액에 대해 고객사와 파트너가 나누어 부담하는 금액                    |                                                                                                                     |
-|   정률   |                        수수료를 계산하는 방식으로 백분율을 곱하는 방식                       |                               3만원에 대해 3%의 수수료로 계약 했을 시, 수수료는 900원                               |
-|   정액   |                수수료를 계산하는 방식으로 고정된 금액 또는 건수에 곱하는 방식                |                                                   판매 건당 1천원                                                   |
+
+
+## **서비스 용어**
+
+### 정산금 계산 자동화
+
+파트너에게 정산할 금액을 자동 계산하고 관리하는 대표 서비스입니다.
+파트너를 등록하여 파트너 정보를 관리하고, 플랫폼 정책에 맞는 각종 계약을 등록할 수 있으며, 선택한 파트너와 계약을 기반으로 자동 정산금 계산을 지원합니다.
+
+### 지급대행 서비스
+
+전자금융거래법을 준수하기 위해 PG 정산금의 수취 및 이체를 대행하는 서비스로
+안전하고 편리한 지급대행 서비스를 지원합니다. 포트원 지급대행은 일반 PG사와 다르게 즉시(바로)지급과 자유로운 예약지급 설정으로 보다 유연한 관리가 가능합니다.
+
+### 전자세금계산서 서비스
+
+역발행과 정발행을 지원하는 전자세금계산서 서비스입니다.
+세금계산서 발행 뿐만 아니라 히스토리 관리, 일괄(대량) 발행을 지원합니다.
+
+<div class="hint" data-style="info">
+
+파트너 정산 자동화 솔루션 안에서 3가지의 서비스를 제공하고 있습니다.
+
+</div>
+
+---
+
+## **공통 용어**
+
+### 고객사 / 파트너
+
+고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
+
+파트너는 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 (하위셀러) 입니다.
+
+### 사업자 휴폐업 조회
+
+파트너의 사업자등록번호 유효성과 영업 상태를 확인하는 서비스입니다. 사업자 휴폐업 조회를 사전에 진행하여 비즈니스의 안전성과 신뢰성을 확보할 수 있습니다. 또한 미리 휴폐업을 조회하지 못해 생기는 리소스 낭비를 줄일 수 있습니다.
+
+### 영업일
+
+은행이 영업을 하는 날로, 휴일이 아닌 날입니다.
+
+<div class="hint" data-style="success">
+
+예를 들어, 10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11, 12, 13일의 전 영업일은 10일이고, 10, 11, 12일의 후 영업일은 13일입니다.
+
+</div>
+
+---
+
+## **정산금 계산 자동화 용어**
+
+### 계약
+
+고객사와 파트너 사이에 정산이 이루어지기 위한 조건입니다. 계약은 파트너 정산 자동화의 정산 정책 관리 페이지에서 등록할 수 있습니다. 계약 등록을 통해 플랫폼 중개 수수료를 설정하거나 부가세 분담 주체, 정산 주기 등을 설정할 수 있으며, 각 플랫폼사의 정책에 맞게 커스터마이징이 가능합니다.
+
+### 수수료
+
+절차 및 중개 등을 지원할 때 수수하는 금전입니다.
+플랫폼사에서는 중개수수료와 추가수수료 등을 수취합니다. **중개수수료**는 플랫폼이 거래 중개 서비스에 대해 부과하는 수수료이고, **추가수수료**는 PG사 수수료, 마케팅 채널 수수료 등 특정 서비스에 대해 부과하는 수수료입니다.
+
+### 원천 징수세
+
+소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
+
+---
+
+## **지급대행 서비스 용어**
+
+### 결제사 정산
+
+포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산입니다.
+
+### 파트너 정산
+
+결제사 정산 이후에 고객사가 파트너에게 내려주는 정산입니다.
+
+### 일괄지급
+
+여러 파트너에게 동시에 정산금을 지급하는 기능으로, 한 번의 실행으로 대량 송금이 가능합니다. 정산일을 설정하고 정산할 건을 선택하여 일괄지급할 수 있습니다.
+
+### 즉시지급(바로지급)과 예약지급
+
+**즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
+**예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
+
+<div class="hint" data-style="warning">
+
+단, 은행 점검 시간에는 지급 및 예약이 불가합니다.
+
+</div>
+
+---
+
+## **세금계산서 서비스 용어**
+
+### 세금계산서 역발행
+
+세금계산서 발행 주체인 공급자(파트너)가 아니라, 공급받는자(플랫폼)가 공급자 대신 세금계산서를 작성하여 공급자에게 발행을 요청하는 기능입니다.
+
+플랫폼사가 직접 파트너에게 지급할 정산대금 정보를 작성하고, 해당 내용을 바탕으로 공급자는 이메일을 통해 검토만 하고 승인할 수 있는 구조이기 때문에 파트너와의 소통을 줄일 수 있습니다.
+
+### 발행 취소
+
+세금계산서를 국세청으로 전송하기 전까지 발행을 취소할 수 있는 기능으로, '발행 요청' 상태의 세금계산서 우측에 있는 '발행 취소' 버튼을 눌러 취소할 수 있습니다.
+
+<div class="hint" data-style="warning">
+
+세금계산서 내역 관리의 **삭제** 버튼은 발행 취소와 다른 기능으로 세금계산서의 상태가 실패, 거절, 취소 등의 최종 상태일 경우에만 적용됩니다.
+
+</div>
+
+### 수정 발행
+
+세금계산서가 국세청으로 전송되면 (전송 완료 상태) 수정 발행으로 취소 및 수정이 가능합니다. 단, 수정 발행 시 사유 확인이 필요합니다.
+
+### 재전송
+
+역발행 세금계산서의 승인을 요청하는 메일을 파트너에게 다시 전송하는 기능입니다.
+
+### 지연 발행
+
+세금계산서 지연 발행 상태는 재화 또는 용역을 공급한 날이 속한 달의 다음 달 10일까지 세금계산서를 발급하지 않고, 그 기간을 넘겨 발행하면 지연 발행에 해당합니다.
+
+예를 들어, 9월 16일에 재화나 용역을 제공했다면, 다음 달인 10월 10일까지 세금계산서를 발행해야 합니다. 이 기한을 넘겨 발행하면 지연 발행에 해당합니다.
+
+<div class="hint" data-style="info">
+
+지연 발행 시에는 가산세가 부과됩니다.
+
+- 공급자는 지연 발행 가산세로 공급가액의 1%를 부담하게 됩니다.
+- 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
+
+</div>

package/assets/docs/platform/ko/guides/process.md

@@ -7,7 +7,7 @@ description: ''
 
 <div class="hint" data-style="etc">
 
-📘  **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스 입니다.**
+📘  **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스입니다.**
 
 </div>
 

package/assets/docs/platform/ko/guides/webhook.md

@@ -141,7 +141,7 @@ app.post("/webhook/taxinvoice", (req, res) => {
 ### 설정 요청 절차
 
 1. 웹훅 수신 URL을 준비해주세요.
-2. 기술지원 이메일(<support.b2b@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
+2. 기술지원 이메일(<tech.support@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
 3. 테스트 모드 설정이 완료되었다는 회신을 받으면 테스트 모드에서 웹훅 정상 작동 여부를 확인해주세요
 4. 운영 환경에도 적용을 요청하신 뒤 운영 환경에서 웹훅 정상 작동 여부를 확인해주세요.
 

package/assets/docs/platform/ko/using-ai-tools.md

@@ -13,78 +13,54 @@ targetVersions:
 포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
 AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
 
-### 1. MCP 서버 등록하기
+이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
+아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
 
-포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
+- 채널 목록 조회
+- 테스트 채널 추가
+- 하위 상점 조회
+- 결제 내역 조회
 
-Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
+### DXT를 이용한 설치
 
-```json
-{
-  // ...
+[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
 
-  "mcpServers": {
-    // ...
+1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
+2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
+3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
 
-    "portone-mcp-server": {
-      "command": "uvx",
-      "args": ["portone-mcp-server@latest"]
-    }
-  }
-}
-```
-
-<div class="hint" data-style="info">
-
-사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
-
-</div>
-
-설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
-
-#### 포트원 기능 사용하기
-
-MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
-
-- 결제 내역 단건/다건 조회
-- 본인인증 내역 단건/다건 조회
+<div class="hint" data-style="warning">
 
-연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
+**Claude Desktop에서 DXT 파일 사용 시 주의사항**
 
-```json
-{
-  // ...
+현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
 
-  "mcpServers": {
-    // ...
+이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
 
-    "portone-mcp-server": {
-      "command": "uvx",
-      "args": ["portone-mcp-server@latest"],
-      // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
-      "env": {
-        "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
-      }
-    }
-  }
-}
-```
+</div>
 
-<div class="hint" data-style="warning">
+### MCP 서버 등록하기
 
-**API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
+1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
 
-내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
+2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
 
-</div>
+   ```jsonc
+   "mcpServers": {
 
-<div class="hint" data-style="warning">
-
-**MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
+     // 기존 설정
 
-이 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
+     "portone-mcp-server": {
+       "command": "npx",
+       "args": [
+         "-y",
+         "@portone/mcp-server@latest"
+       ]
+     }
+   }
+   ```
 
-</div>
+3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
 
 <div class="hint" data-style="warning">
 
@@ -95,7 +71,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
 
 </div>
 
-### 2. MCP 서버 활용하기
+### MCP 서버 활용하기
 
 사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
 

package/assets/docs/release-notes/api-sdk/2023-07-10.md

@@ -5,13 +5,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
 
 ## 주요 업데이트 사항
 
-### **결제 모듈 V1**✔️ 나이스페이먼츠의 새로운 결제창을 이용할 수 있습니다
+### **결제 모듈 V1**✔️ 나이스정보통신의 새로운 결제창을 이용할 수 있습니다
 
-포트원을 통해 나이스페이먼츠의 새로운 결제창(이하 ‘(신) 나이스페이먼츠’)을 이용할 수 있습니다. 이번
+포트원을 통해 나이스정보통신의 새로운 결제창(이하 ‘(신) 나이스정보통신’)을 이용할 수 있습니다. 이번
 업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
 호출을 지원합니다.
 
-(신) 나이스페이먼츠에서 이용 가능한 간편결제는 다음과 같습니다.
+(신) 나이스정보통신에서 이용 가능한 간편결제는 다음과 같습니다.
 
 - 카카오페이
 - 네이버페이
@@ -24,12 +24,12 @@ writtenAt: 2023-07-12T00:00:00.000Z
 
 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
 
-(신) 나이스페이먼츠 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
+(신) 나이스정보통신 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
 
-[→ (신)나이스페이먼츠 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
+[→ (신)나이스정보통신 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
 
-[→ (신)나이스페이먼츠 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
+[→ (신)나이스정보통신 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
 
-기존에 나이스페이먼츠를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
+기존에 나이스정보통신를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
 안내드리겠습니다.

package/assets/docs/release-notes/api-sdk/2023-07-31.md

@@ -11,4 +11,4 @@ KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는
 할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
 
 본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
-[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
+[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)

package/assets/docs/release-notes/api-sdk/2023-08-31.md

@@ -16,7 +16,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
 선택할수 있도록 하였습니다.
 
 본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
-[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
+[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
 
 ### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
 
@@ -26,4 +26,4 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
 - (신)스마트로
 - KSNET
 - (신)페이팔 일반결제/정기결제
-- (신)나이스페이먼츠
+- (신)나이스정보통신

package/assets/docs/release-notes/api-sdk/2024-01-08.md

@@ -5,11 +5,11 @@ writtenAt: 2024-01-08T00:00:00.000Z
 
 ## 주요 업데이트 사항
 
-### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스페이먼츠 결제를 지원합니다.
+### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스정보통신 결제를 지원합니다.
 
-이제 포트원 V2를 통해 나이스페이먼츠 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
+이제 포트원 V2를 통해 나이스정보통신 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
 
-나이스페이먼츠에서 지원하는 결제수단 아래와 같습니다.
+나이스정보통신에서 지원하는 결제수단 아래와 같습니다.
 
 - 카드
 
@@ -33,4 +33,4 @@ writtenAt: 2024-01-08T00:00:00.000Z
 
 이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
 
-나이스페이먼츠 연동에 대해 자세히 알고 싶다면 [→ 나이스페이먼츠 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
+나이스정보통신 연동에 대해 자세히 알고 싶다면 [→ 나이스정보통신 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.

package/assets/docs/release-notes/api-sdk/2024-06-03.md

@@ -32,7 +32,7 @@ writtenAt: 2024-06-03T00:00:00.000Z
 
 **지원 결제대행사**
 
-- 나이스페이먼츠
+- 나이스정보통신
 - KG이니시스
 - 토스페이먼츠
 - 스마트로

package/assets/docs/release-notes/api-sdk/2024-09-05.md

@@ -17,7 +17,6 @@ writtenAt: 2024-09-05T00:00:00.000Z
 - 토스
 - 카카오
 - 네이버
-- 페이코
 - 금융결제원
 - KB국민은행
 - 신한은행