@portone/mcp-server 0.15.0-alpha.1 → 0.15.0-alpha.3

package/assets/docs/v2-docs-full.md

@@ -15446,6 +15446,12 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
 
 </div>
 
+<div class="hint" data-style="info">
+
+웹훅 URL 삭제는 [기술지원 메일](mailto:tech.support@portone.io)로 요청해 주세요.
+
+</div>
+
 ### 2. 결제 파라미터 설정
 
 포트원 SDK의 `PortOne.requestPayment()` 혹은 `PortOne.requestIssueBillingKey()` 함수 파라미터 중
@@ -19142,22 +19148,28 @@ versionVariants:
 
 ## Android SDK
 
-Android 네이티브 환경에서 사용 가능한 SDK 입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
+Android 네이티브 환경에서 사용 가능한 SDK입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
 
 - [GitHub 링크](https://github.com/portone-io/android-sdk)
 
 ## iOS SDK
 
-iOS 네이티브 환경에서 사용 가능한 SDK 입니다. SwiftUI와 UIKit을 지원하며, 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
+iOS 네이티브 환경에서 사용 가능한 SDK입니다. SwiftUI와 UIKit을 지원하며, 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
 
 - [GitHub 링크](https://github.com/portone-io/ios-sdk)
 
 ## React Native
 
-React Native 환경에서 사용 가능한 SDK 입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
+React Native 환경에서 사용 가능한 SDK입니다. 해당 Git 레포지토리의 README.md 파일을 참고하여 사용하실 수 있습니다.
 
 - [GitHub 링크](https://github.com/portone-io/react-native-sdk)
 
+## Flutter
+
+Flutter 환경에서 사용 가능한 SDK는 제공하고 있지 않으나, Flutter을 사용하여 직접 연동하는 방법에 참고가 되도록 샘플 프로젝트를 제공하고 있습니다.
+
+- [GitHub 링크](https://github.com/portone-io/portone-sample/tree/main/flutter)
+
 
 # https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request
 
@@ -25923,18 +25935,6 @@ targetVersions:
 
 
 
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="danger">
-
-2024년 9월 1일부로 포트원 V1 API에 대해 일부 보안 규격이 지원 종료됩니다.
-
-자세한 사항은 [TLS 지원 범위](https://developers.portone.io/opi/ko/support/tls-support?v=v1)를 참고해주세요.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
-
 ## 연동 준비하기
 
 결제 연동 전 회원 가입부터 채널 연동 방법까지 확인할 수 있습니다.

package/assets/docs/website-links.md

@@ -4,7 +4,7 @@ description: PortOne 개발자센터 웹사이트 내 존재하는 문서들의
 targetVersions:
   - v1
   - v2
-date: 2025-11-25
+date: 2025-12-16
 author: PortOne
 ---
 
@@ -174,7 +174,8 @@ author: PortOne
 - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis): KG이니시스 결제창 연동 가이드입니다.
 - [카카오페이](https://developers.portone.io/opi/ko/integration/pg/v1/kakaopay): 카카오페이 연동 방법을 안내합니다.
 - [NHN KCP(신모듈) 본인인증 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/kcp-v2-identity-verification): NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
-- [KG모빌리언스](https://developers.portone.io/opi/ko/integration/pg/v1/kg): KG모빌리언스 결제 연동 방법을 안내합니다.
+- [KG모빌리언스 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg-mobilians-v2): KG모빌리언스 (신모듈) 결제 연동 방법을 안내합니다.
+- [KG모빌리언스 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg): KG모빌리언스 (구모듈) 결제 연동 방법을 안내합니다.
 - [이지페이(KICC)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc): 이지페이(KICC) 결제창 연동 방법을 안내합니다.
 - [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme): KSNET 결제창 연동 가이드입니다.
 - [연동 주의사항](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/warning): KSNET 연동 시 주의사항을 확인할 수 있습니다.

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.1",
   "name": "portone-mcp-server",
-  "version": "0.15.0-alpha.1",
+  "version": "0.15.0-alpha.3",
   "description": "PortOne MCP Server for Developers",
   "author": {
     "name": "PortOne",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portone/mcp-server",
-  "version": "0.15.0-alpha.1",
+  "version": "0.15.0-alpha.3",
   "description": "포트원 사용자를 위한 MCP (Model Context Protocol) 서버입니다. 포트원 개발자센터, 헬프센터 등 공식 문서 내용을 LLM(Large Language Model)에 제공해 정확한 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.",
   "main": "server/index.js",
   "type": "module",

package/server/index.js

@@ -15,7 +15,7 @@ import { GraphQLClient } from "graphql-request";
 // package.json
 var package_default = {
   name: "@portone/mcp-server",
-  version: "0.15.0-alpha.1",
+  version: "0.15.0-alpha.3",
   description: "\uD3EC\uD2B8\uC6D0 \uC0AC\uC6A9\uC790\uB97C \uC704\uD55C MCP (Model Context Protocol) \uC11C\uBC84\uC785\uB2C8\uB2E4. \uD3EC\uD2B8\uC6D0 \uAC1C\uBC1C\uC790\uC13C\uD130, \uD5EC\uD504\uC13C\uD130 \uB4F1 \uACF5\uC2DD \uBB38\uC11C \uB0B4\uC6A9\uC744 LLM(Large Language Model)\uC5D0 \uC81C\uACF5\uD574 \uC815\uD655\uD55C \uC815\uBCF4\uB97C \uBC14\uD0D5\uC73C\uB85C \uC0AC\uC6A9\uC790\uC758 \uC5F0\uB3D9 \uBC0F \uC9C8\uC758\uB97C \uB3D5\uB3C4\uB85D \uD569\uB2C8\uB2E4.",
   main: "server/index.js",
   type: "module",
@@ -1060,7 +1060,8 @@ import z8 from "zod";
 // src/tools/utils/docPathToUrl.ts
 function docPathToUrl(path) {
   if (path.startsWith("help/")) {
-    return `${HELP_CENTER_URL}/category/${path.slice(5)}`;
+    const slug = path.slice(path.lastIndexOf("/") + 1, -3);
+    return `${HELP_CENTER_URL}/content/${slug}`;
   }
   return `${DEVELOPERS_URL}/${path}`;
 }

package/assets/docs/_components/ko/docs-for-llms.md

@@ -1,21 +0,0 @@
----
-title: LLM을 위한 개발자센터 문서 디렉터리 지원
-description: LLM을 위한 개발자센터 문서 디렉터리와 사용 방법을 설명합니다.
-targetVersions:
-  - v1
-  - v2
----
-
-Cursor, Windsurf, Claude Code와 같이 코드베이스 맥락을 자동으로 분석하는 AI 도구를 사용하는 경우,
-LLM을 위한 포트원 문서 디렉터리를 다운받아 작업 중인 코드베이스 내에 위치시키는 방식으로도 활용할 수 있습니다.
-
-이 경우, 위 AI 도구들이 제공하는 임베딩 기반 색인과 RAG (Retrieval Augmented Generation) 검색이 자동적으로 적용되어
-보다 원활히 원하는 결과를 얻으실 수 있습니다.
-
-(파일: LLM 전용 포트원 문서 디렉터리 다운로드)
-
-### 사용 방법
-
-1. 위 링크를 눌러 LLM 전용 포트원 문서 압축 파일을 다운로드합니다.
-2. 압축을 해제하고, 해당 디렉터리를 작업 중인 코드베이스 내에 위치시킵니다.
-3. 포트원 관련 질의 시 AI에게 해당 디렉터리를 태그하여 질의합니다.

package/assets/docs/_components/ko/llms-txt-support.md

@@ -1,15 +0,0 @@
----
-title: llms.txt 표준 지원
-description: 포트원이 지원하는 llms.txt 표준에 대한 내용입니다.
-targetVersions:
-  - v1
-  - v2
----
-
-포트원 개발자센터 웹사이트는 [llms.txt 표준](https://llmstxt.org)을 준수하며, LLM이 문서 정보를 쉽게 조회할 수 있도록 지원하고 있습니다.
-
-- [llms.txt](https://developers.portone.io/llms.txt): LLM을 위한 가이드 및 문서 목차를 포함합니다.
-- [llms-full.txt](https://developers.portone.io/llms-full.txt): llms.txt에 더해 모든 문서 내용을 추가로 포함합니다.
-- [llms-small.txt](https://developers.portone.io/llms-small.txt): llms.txt에 더해 모든 문서의 메타 정보만 추가로 포함합니다.
-
-llms.txt, llms-small.txt를 사용하는 AI 어시스턴트의 프롬프트에 포함하거나, llms-full.txt를 파일로 업로드해 질의하는 방식으로도 활용이 가능합니다.

package/assets/docs/_components/ko/using-mcp-server.md

@@ -1,60 +0,0 @@
----
-title: 포트원 MCP (Model Context Protocol) 서버 사용하기
-description: 포트원이 제공하는 MCP (Model Context Protocol) 서버 사용 방법을 안내합니다.
-targetVersions:
-  - v1
-  - v2
----
-
-포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
-
-포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
-AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
-
-### 1. MCP 서버 등록하기
-
-포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
-
-Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
-
-```json
-{
-  // ...
-
-  "mcpServers": {
-    // ...
-
-    "portone-mcp-server": {
-      "command": "uvx",
-      "args": ["portone-mcp-server"]
-    }
-  }
-}
-```
-
-<div class="hint" data-style="info">
-
-사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
-
-</div>
-
-설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
-
-### 2. MCP 서버 활용하기
-
-사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
-
-#### 개발 관련 프롬프트 예시
-
-- _"포트원 V2 Python 서버 SDK를 사용해서 서버 연동 코드를 작성해줘"_
-- _"포트원 V2 Kotlin 서버 SDK를 사용해 웹훅 검증을 구현해줘"_
-- _"포트원 V1 브라우저 SDK를 사용한 페이팔 결제창 호출을 구현해줘"_
-- _"파트너정산 자동화 서비스에 파트너 등록하는 코드를 타입스크립트로 구현해줘"_
-- _"포트원 V2 본인인증 기능 연동해줘"_
-
-#### 전반적인 질의 예시
-
-- _"포트원 V2와 V1의 차이점을 설명해줘"_
-- _"포트원 V2가 지원하는 PG사 목록 보여줘"_
-- _"포트원 API의 하위호환성 정책 설명해줘"_
-- _"포트원 파트너정산 자동화 서비스가 제공하는 기능들을 요약해줘"_

package/assets/docs/help/core-service/payment-type/crossborder.md

@@ -1,132 +0,0 @@
----
-title: 크로스보더(Cross-border) 서비스 안내
-category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
-seo:
-  title: 크로스보더 서비스 안내
-  description: >-
-    해외 현지에 특화 결제서비스인 포트원의 크로스보더를 소개합니다. 여러 국가의 고객에게 온라인 결제를 한 번에 제공하며, 현지 법인 설립
-    없이도 해외 고객으로부터 결제를 받을 수 있다는 큰 장점을 가지고 있습니다.
-  keywords:
-    - 해외결제
-    - 크로스보더
-tags:
-  - 해외결제
-  - 크로스보더
-pgCompanies:
-  - 공통
-searchTags:
-  - 글로벌
-  - Cross broder
-  - 해외결제
-  - 크로스보더
-datetime: 2024-01-25T15:00:00.000Z
----
-
-<Callout content="" title="해외 현지에 특화된 결제서비스인 포트원의 크로스보더(Cross-border) 서비스를 안내드립니다" />
-
-### **서비스 소개**
-
-- Cross-border 서비스는 한 번에 여러 국가의 고객에게 온라인결제를 제공할 수 있는 결제솔루션입니다.
-- 일반적인 해외결제와 다르게 현지 법인 설립 없이도 해외 고객으로부터 결제를 받을 수 있다는 것이 가장 큰 장점입니다.
-
-### **서비스 특징**
-
-- 신용카드, 현지 간편결제, 계좌이체, QR Code결제 등 국가별 고객이 선호하는 다양한 결제수단을 제공합니다
-- 결제서비스 제공 국가의 언어, 화폐, 관세가 적용된 결제창을 제공합니다.
-
-### **이용 절차**
-
-
-
-**1. 도입문의 제출**
-
-- 해외 결제 서비스 ‘이용 예정 국가’ 및 ‘결제수단’, ‘해외 월 거래액’을 작성하여 제출합니다. 국가별 지원 결제수단 가이드를 참고해주세요. (ex : 베트남/ZaloPay, 인도네시아/LinkAja/Dana, 1억/10만달러 이상)
-
-
-
-<Callout icon="" title="도입문의 바로가기" content=" " />
-
-**2. 온보딩 안내**
-
-- 포트원 전문 상담사가 최적의 결제사와 결제수단을 제안 드립니다. (신청 후 약 1영업일 내)
-
-<Highlight text="크로스보더" />
-
-- 현지 법인 없이 해외결제를 이용해야 하는 기업
-- 카드 결제를 보편적으로 사용하지 않는 국가의 현지 결제수단으로 결제가 필요한 형태
-- 지원 국가 및 PG사 : 아래의 국가별 지원 결제수단 가이드 참고
-
-<Highlight text="일반 해외 결제" />
-
-- 포트원 코리아\_전자결제(PG) 서비스 신청 절차 진행
-- 해외 카드(해외VISA/MASTER/JCB/AMEX/DINERS) 수단 제공 서비스
-- 지원 PG사 : 페이팔/ 엑심베이 / 페이먼트월
-- 참고 :  [일반 해외결제 전자결제 신청방법 보러가기↗](https://help.portone.io/category/procedure/pg-application)
-
-**3. 이용계약서 작성 및 KYC 심사 진행**
-
-- PSP(결제수단제공업체) 계약 및 KYC(고객본인확인제도) 심사용 사업자 기본정보 작성하여 아래 제출처로 제출합니다. 제출된 서류는 포트원 코리아(KR) 온보딩 담당자가 ‘KYC 심사’ 하여 포트원 글로벌 가입절차와 연동방법을 안내 드립니다.
-- **제출처 : <onboarding@portone.io>**
-
-<Callout content="**KYC** **전** **운영** **사이트** **내** **필수** **요건**
-
-1. 상품 등록 필수
-2. 배송 정책 명시
-3. 취소 및 환불 정책 명시
-4. 주문(결제)페이지와 결제 기능 구현" title="참고사항" icon="💡" />
-
-**4. 글로벌 콘솔 가입 및 테스트환경 연동**
-
-글로벌 콘솔(Admin Portal) 가입 후 테스트 연동을 위한 [포트원 글로벌 콘솔 ↗](https://admin.portone.cloud/)(Admin Portal) 채널(PSP) 정보 설정한 뒤 결제 테스트 진행
-
-<Callout title="글로벌 관리자콘솔 이용 방법 보러가기 ↗" icon="" content="" />
-
-**5. 실 운영환경 연동**
-
-- 포트원 코리아 담당자’가 실운영용 ‘결제 ID’ 및 ‘연동키’를 발급하여 안내드리면 연동키를 활용하여\
-  [포트원 글로벌 콘솔 ↗](https://admin.portone.cloud/) 내 실 운영용 채널(PG)정보를 설정하여 연동을 진행합니다.
-- 결제 ID는 KYC 심사 완료 후 발급됩니다.
-
-**6. 서비스 오픈**
-
-- 연동 및 충분한 내부 테스트 후 서비스를 오픈해주세요.
-
-### **크로스보더 와 일반 해외결제 비교**
-
-<Callout title="크로스보더와 해외결제는 다음과 같은 차이점이 있습니다." />
-
-1. **크로스보더**
-
-- 현지 법인 없이 해외결제를 이용해야 하는 기업
-- 카드 결제를 보편적으로 사용하지 않는 국가의 현지 결제수단으로 결제가 필요한 형태
-- 지원 국가 및 PG사 : 아래의 국가별 지원 결제수단 가이드 참고
-
-**2. 일반 해외 결제**
-
-- 포트원 코리아 전자결제(PG) 서비스 신청 절차 진행
-- 해외 카드(해외VISA/MASTER/JCB/AMEX/DINERS) 수단 제공 서비스
-- 지원 PG사 : 페이팔/ 엑심베이 / 페이먼트월
-
-**💡 그럼 왜 크로스보더를 이용해야할까요?**
-
-- 크로스보더 서비스는 다음과 같은 특장점이 존재합니다.
-
-
-
-### **국가별 지원 결제수단**
-
-Payment channel이 PG사일 경우, Payment Method에 간편결제사가 적용 될 수 있습니다.
-
-- Payment channels : 결제 제공사
-- Payment Methods : 결제수단
-- Payment Method Key : 결제수단 코드 (연동시 사용)
-
-<Callout title="크로스보더 서비스 지원 결제수단 보러가기 ↗" />
-
-
-
-### **연동 가이드**
-
-- 연동 가이드는 영문으로 제공되고 있으며 연동 시 궁금하신 점은 포트원 기술지원팀(<support@portone.io>)을 통하여 문의주시기 바랍니다.
-
-<Callout icon="" title="크로스보더 연동 개발가이드 보러가기 ↗" />