@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/integration/start/v2/checkout.md

@@ -0,0 +1,258 @@
+---
+title: 인증 결제 연동하기
+description: PG 결제창을 이용하는 인증 결제를 연동합니다.
+targetVersions:
+  - v2
+versionVariants:
+  v1: /opi/ko/integration/start/v1/auth
+---
+
+## **SDK 일반 결제**
+
+<details>
+
+<summary>
+
+<strong>영상으로 보기</strong>
+
+</summary>
+
+[포트원 인증 결제의 이해 - 쇼핑몰 멀티PG 연동하기](https://www.youtube.com/watch?v=DhcQFLYV9Q8)
+
+</details>
+
+## **결제 연동 샘플 프로젝트**
+
+SDK를 지원하지 않는 플랫폼을 포함하여 다양한 플랫폼에서 결제 연동 예시를 확인하실 수 있도록 [portone-sample GitHub 저장소](https://github.com/portone-io/portone-sample)에서 샘플 프로젝트를 제공하고 있습니다.
+일부 플랫폼의 경우 devcontainers 환경에서 바로 실행해보실 수 있습니다.
+
+## 1. 포트원 SDK 설치
+
+포트원은 다양한 PG의 결제창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다. 브라우저에서 포트원 SDK를 호출하여 결제를 진행하게 됩니다.
+
+포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
+
+- npm, yarn 등 패키지 매니저를 사용한다면 의존
+  대상으로 [@portone/browser-sdk](http://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
+
+- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
+
+- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="패키지 의존 대상으로 추가">
+
+사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
+
+```shell
+npm i @portone/browser-sdk
+```
+
+```shell
+yarn add @portone/browser-sdk
+```
+
+```shell
+pnpm add @portone/browser-sdk
+```
+
+패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
+
+```javascript
+import * as PortOne from "@portone/browser-sdk/v2";
+```
+
+</div>
+
+<div class="tabs-content" data-title="<script> 요소로 추가">
+
+```html
+<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
+```
+
+`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
+
+</div>
+
+<div class="tabs-content" data-title="ESM 모듈로 추가">
+
+ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
+
+```javascript
+import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
+```
+
+</div>
+
+</div>
+
+<div class="hint" data-style="info">
+
+**타입스크립트 지원**
+
+포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
+
+</div>
+
+## 2. 결제 요청
+
+SDK의 `PortOne.requestPayment()` 함수를 호출하여 결제 수단에 따른 결제창을 열 수 있습니다.
+
+먼저, 관리자 콘솔의 결제 연동 페이지에서 **Store ID**와 사용할 채널의 **채널 키**를 확인해 주세요.
+
+그리고 아래와 같이 파라미터들을 설정하여 호출합니다.
+
+```ts
+const response = await PortOne.requestPayment({
+  // Store ID 설정
+  storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec",
+  // 채널 키 설정
+  channelKey: "channel-key-893597d6-e62d-410f-83f9-119f530b4b11",
+  paymentId: `payment-${crypto.randomUUID()}`,
+  orderName: "나이키 와플 트레이너 2 SD",
+  totalAmount: 1000,
+  currency: "CURRENCY_KRW",
+  payMethod: "CARD",
+});
+```
+
+**paymentId**는 결제 건을 구분하는 문자열로, 결제 요청 및 조회에 필요합니다. 같은 paymentId에 대해 여러 번의 결제 시도가 가능하나,
+최종적으로 결제에 성공하는 것은 단 한 번만 가능합니다. (중복 결제 방지)
+
+**orderName**은 주문 내용을 나타내는 문자열입니다. 특정한 형식이 있지는 않지만, 결제 처리에 필요하므로 필수적으로 전달해 주셔야 합니다.
+
+**totalAmount**와 **currency**는 결제 금액과 결제 화폐를 지정합니다.
+
+**payMethod**는 결제 수단을 지정합니다.
+
+## 3. 결제 완료 처리 (브라우저)
+
+`PortOne.requestPayment()` 함수의 반환값을 통해 결제 요청의 결과를 확인합니다.
+
+`code`가 있으면 결제 과정에서 오류가 발생한 것이므로 적절히 처리하여야 합니다.
+
+결제가 성공한 경우 paymentId를 서버에 전달하여 서버측 결제 완료 처리를 하도록 합니다. (가상 계좌 결제의 경우 결제가 아직 완료되지 않은 상태일 수 있습니다.)
+
+```ts
+async function requestPayment() {
+  const response = await PortOne.requestPayment({
+    /* 파라미터 생략 */
+  });
+
+  if (response.code !== undefined) {
+    // 오류 발생
+    return alert(response.message);
+  }
+
+  // /payment/complete 엔드포인트를 구현해야 합니다. 다음 목차에서 설명합니다.
+  const notified = await fetch(`${SERVER_BASE_URL}/payment/complete`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    // paymentId와 주문 정보를 서버에 전달합니다
+    body: JSON.stringify({
+      paymentId: paymentId,
+      // 주문 정보...
+    }),
+  });
+}
+```
+
+결과값에 들어 있는 필드는 다음과 같습니다.
+
+|필드명   |설명               |비고                        |
+|---------|-------------------|----------------------------|
+|paymentId|결제 건 ID         |공통                        |
+|code     |오류 코드          |실패 시                     |
+|message  |오류 문구          |실패 시                     |
+|pgCode   |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
+|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|
+
+### 3-1. redirect 방식의 경우
+
+모바일 환경에서의 결제는 대부분 redirect 방식으로 이루어집니다. redirect 방식에서는 브라우저가 결제창으로 리다이렉트되었다가, 결제창에서의 작업이 끝나면
+지정한 `redirectUrl`로 다시 리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고,
+결제 성공 여부 등은 [쿼리 문자열](http://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다.
+
+```ts
+PortOne.requestPayment({
+  /* 파라미터 생략 */
+  redirectUrl: `${BASE_URL}/payment-redirect`,
+});
+```
+
+쿼리 문자열로 전달되는 내용은 다음과 같습니다.
+
+|키       |설명               |비고                        |
+|---------|-------------------|----------------------------|
+|paymentId|결제 건 ID         |공통                        |
+|code     |오류 코드          |실패 시                     |
+|message  |오류 문구          |실패 시                     |
+|pgCode   |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
+|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|
+
+예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우,
+결제 성공 시에 `https://example.com/payment-redirect?paymentId=payment-39ecfa97`로 리다이렉트됩니다.
+
+## 4. 결제 완료 처리 (서버)
+
+paymentId를 서버에 전달하면, 서버는 포트원의 [결제 조회 API](https://developers.portone.io/api/rest-v2/payment#get%20%2Fpayments%2F%7BpaymentId%7D)를
+호출하여 해당 결제 건의 상태를 확인하고 결제 완료 처리를 하여야 합니다.
+
+<div class="hint" data-style="info">
+
+**결제 검증 필수**
+
+인증 결제의 흐름상 결제 금액 등 정보가 고객의 브라우저 측에서 처리되므로, 의도한 결제 내용이 맞는지 꼭 확인하여야 위변조를 막을 수 있습니다.
+
+</div>
+
+예시로, 위에서 사용했던 `/payment/complete` 엔드포인트를 다음과 같이 구현할 수 있습니다.
+
+[PORTONE\_API\_SECRET](https://developers.portone.io/opi/ko/integration/ready/readme?v=v2#4-2-v2-api-secret-%EB%B0%9C%EA%B8%89%ED%95%98%EA%B8%B0)
+은 V2 전용 시크릿으로, 포트원 콘솔 내 결제연동 탭에서 발급받을 수 있습니다.
+
+```ts title="Express"
+app.use(bodyParser.json());
+
+// POST 요청을 받는 /payments/complete
+app.post("/payment/complete", async (req, res) => {
+  try {
+    // 요청의 body로 paymentId가 오기를 기대합니다.
+    const { paymentId, order } = req.body;
+
+    // 1. 포트원 결제내역 단건조회 API 호출
+    const paymentResponse = await fetch(
+      `https://api.portone.io/payments/${encodeURIComponent(paymentId)}`,
+      {
+        headers: { Authorization: `PortOne ${PORTONE_API_SECRET}` },
+      },
+    );
+    if (!paymentResponse.ok)
+      throw new Error(`paymentResponse: ${await paymentResponse.json()}`);
+    const payment = await paymentResponse.json();
+
+    // 2. 고객사 내부 주문 데이터의 가격과 실제 지불된 금액을 비교합니다.
+    const orderData = await OrderService.getOrderData(order);
+    if (orderData.amount === payment.amount.total) {
+      switch (payment.status) {
+        case "VIRTUAL_ACCOUNT_ISSUED": {
+          const paymentMethod = payment.paymentMethod;
+          // 가상 계좌가 발급된 상태입니다.
+          // 계좌 정보를 이용해 원하는 로직을 구성하세요.
+          break;
+        }
+        case "PAID": {
+          // 모든 금액을 지불했습니다! 완료 시 원하는 로직을 구성하세요.
+          break;
+        }
+      }
+    } else {
+      // 결제 금액이 불일치하여 위/변조 시도가 의심됩니다.
+    }
+  } catch (e) {
+    // 결제 검증에 실패했습니다.
+    res.status(400).send(e);
+  }
+});
+```

package/assets/docs/opi/ko/integration/start/v2/keyin.md

@@ -0,0 +1,54 @@
+---
+title: 수기(키인) 결제 연동하기
+description: 구매자 인증 없이 결제 수단 정보만으로 결제를 요청합니다.
+targetVersions:
+  - v2
+versionVariants:
+  v1: /opi/ko/integration/start/v1/non-auth
+---
+
+<div class="hint" data-style="info">
+
+수기 결제를 이용하기 위해서는 PG사와 별도 협의가 필요합니다.
+
+</div>
+
+수기(키인) 결제 API를 이용해 1회성 결제 요청이 가능합니다.
+
+## 수기 결제의 장단점
+
+아래의 예제처럼 고객사가 직접 만든 UI로 결제 정보를 입력받을 수 있습니다.
+
+그러나 간편 결제와 다르게 고객이 매번 정보를 기입해야 한다는 번거로움이 있습니다.
+
+## 수기 결제 예제
+
+고객사 서버에서 아래와 같이 포트원 API를 호출합니다.
+
+```ts title="server-side"
+// 포트원 수기(키인)결제 API 호출
+const paymentResponse = await fetch(
+  `https://api.portone.io/payments/${encodeURIComponent(UNIQUE_PAYMENT_ID)}/instant`,
+  {
+    method: "POST",
+    headers: {
+      Authorization: `PortOne ${PORTONE_API_SECRET}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      channelKey: CHANNEL_KEY_HERE,
+      orderName: "월간 이용권 정기결제",
+      // 수기 결제 API를 참고해 고객 정보를 채워주세요.
+      customer: YOUR_CUSTOMER_INFO,
+      amount: {
+        total: 8900,
+      },
+      currency: "KRW",
+      // 수기(키인)결제 API를 참고해 카드 / 가상계좌 정보를 채워주세요.
+      method: PAYMENT_METHOD_HERE,
+    }),
+  },
+);
+if (!paymentResponse.ok)
+  throw new Error(`paymentResponse: ${await paymentResponse.json()}`);
+```

package/assets/docs/opi/ko/integration/start/v2/readme.md

@@ -0,0 +1,120 @@
+---
+title: 결제 연동 시작하기
+description: 새롭게 출시된 V2 결제 서비스를 소개합니다.
+targetVersions:
+  - v2
+versionVariants:
+  v1: /opi/ko/integration/start/v1/readme
+---
+
+## 포트원 신모듈 소개 \[V2]
+
+포트원 V2는 10년 간의 포트원 운영 경험을 바탕으로 새롭게 설계되었습니다. 개발자 경험의 혁신적인 개선을 통해 포트원을 연동하는 개발자들은
+더욱 쉽게 시스템을 이해하고 빠르게 결제 기능을 연동할 수 있습니다.
+또한 포트원 V2는 사용자가 직접 느낄 수 있는 개발자 경험의 개선 이외에도, 눈에 보이지 않는 내부적인 부분 또한 많은 개선을 이루었습니다.
+
+### 혁신적인 개발자 경험: 쉽고 편리한 결제 연동
+
+(이미지 첨부: \<V2 OpenAPI 문서 & 활용 예시>)
+
+포트원 V2는 개발자 경험(Developer Experience)을 혁신적으로 개선하여 쉽고 편리한 결제 연동을 돕습니다.
+포트원이 제공하는 차별화된 개발자 경험의 예시는 아래와 같습니다.
+
+- **Open API Spec Download**
+
+  - 연동용 코드 자동 생성, Custom API Document 활용, Postman Import 등에
+    사용 가능한 Open API Spec을 다운로드하실 수 있는 기능을 제공합니다.
+
+    (이미지 첨부: \<Postman 에서 Open API Spec 파일 Import 하기>)
+
+    <br />
+
+    (이미지 첨부: \<Postman Import 후 API Structure 예시>)
+
+  - **직관성 있는 스키마 설계**
+
+    - open API spec 파일은 [REST API 문서 페이지](../../../../../../api/rest-v2)에서 **OpenAPI JSON 내려받기** 버튼을 눌러
+      다운 받으실 수 있습니다.
+
+    - 타입에 따라 달라지는 스키마 구조를 정확히 표현하여 더욱 예측 가능한 인터페이스로 디자인했습니다.
+
+    - 예를 들어 가상계좌로 결제한 결제 건을 조회한다고 가정했을 때, 해당 결제 건은 계좌번호를 항상 포함하고 있을 것입니다.
+      하지만 기존 시스템을 이용하는 경우, 결제수단별로 응답 스키마가 달라지지 않고 모든 필드를 열거하고 있기 때문에
+      가상계좌 결제 건임에도 계좌번호는 optional로 제공됩니다.
+      반면 포트원 V2는 결제수단별로 달라지는 스키마 구조를 정확히 표현하고 있기 때문에, 가상계좌 결제 건일 때는
+      계좌번호가 required로 제공된다는 것이 타입으로 보장됩니다.
+
+    - 이러한 예시를 통해 확인할 수 있듯이, 개발자는 포트원 V2의 직관적인 인터페이스를 통해 결제 시스템을 쉽게 이해하고 불필요한 코드 작성을 최소화할 수 있습니다.
+
+      (이미지 첨부: \<V2 스키마 설계 예시>)
+
+  - **npm, Typescript 지원**
+
+    - V2 SDK는 Typescript로 작성되어 함수의 파라미터 및 응답의 타입을 확인하실 수 있고, npm을 통해 install이 가능합니다.
+
+      (이미지 첨부: \<V2 SDK Typescript 코드 예시>)
+
+## 내부 시스템 개선: 풍부한 데이터와 견고한 서버
+
+포트원 V2는 개발자 경험의 개선을 통해 연동의 편리함을 보장하면서, 장기적으로 고객사의 서비스 운영에 도움이 될 만한 내부 시스템 개선을 진행했습니다.
+고객사의 제품 품질 향상과 개선된 비즈니스 의사결정을 도울 수 있는 풍부한 데이터를 제공합니다. 또한 안정적인 운영을 위해 훨씬 더 견고한 시스템을 구축했습니다.
+
+### 확장성: 무한한 가능성을 열어주는 결제 시스템
+
+V2는 '항상 준비된 시스템'입니다. 향상된 [오토스케일링](https://ko.wikipedia.org/wiki/%EC%98%A4%ED%86%A0%EC%8A%A4%EC%BC%80%EC%9D%BC%EB%A7%81)
+능력을 제공하는 포트원 V2는 블랙프라이데이부터 크리스마스 선착순 이벤트까지, 아무리 많은 결제 트래픽이 몰려도 문제없이 처리할 수 있습니다.
+V1의 오토스케일링도 훌륭하지만, V2는 더 빠른 반응 속도로 더 많은 트래픽을 감당할 수 있는 '진화된 스케일링 능력'을 갖췄습니다.
+
+### 안정성: 신뢰할 수 있는 서버
+
+V2의 서버 시스템은 더욱 강해졌습니다. 휴먼 에러의 위험성을 극단적으로 줄이기 위해 모든 서버 시스템은 자동화된 코드로 관리됩니다.
+추가로 [Scala](https://ko.wikipedia.org/wiki/%EC%8A%A4%EC%B9%BC%EB%9D%BC_\(%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D_%EC%96%B8%EC%96%B4\))와
+같은 강타입 언어를 사용하여 시스템의 안정성을 더욱 강화했습니다.
+
+### 완벽한 데이터 보존: 우수한 데이터 정합성과 풍부한 정보 제공
+
+V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https://learn.microsoft.com/ko-kr/azure/architecture/patterns/event-sourcing)
+기술을 접목하여 서비스의 모든 결제 처리 내역을 빠짐없이 보존합니다. 이를 통해 비즈니스 의사결정에 필요한 주요 정보를 풍부하게 제공합니다.
+
+### 기능 확장: 신속한 업데이트와 혁신
+
+V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다.
+최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
+
+## 사용 가능한 PG사
+
+현재 V2 서비스에서 사용 가능한 PG사는 다음과 같으며, 지속적으로 확장하고 있습니다.
+
+### 결제
+
+- **토스페이먼츠**
+- **KSNET**
+- **카카오페이**
+- **네이버페이**
+- **스마트로**
+- **나이스페이먼츠**
+- **페이팔**
+- **KG이니시스**
+- **한국결제네트웍스(KPN)**
+- **NHN KCP**
+- **토스페이**
+- **하이픈 바로계좌결제**
+
+### 본인인증
+
+- **다날 본인인증**
+
+<br />
+
+## 새로워진 V2 시스템과 함께 비즈니스를 한 단계 업그레이드할 준비가 되셨나요?
+
+<br />
+
+<div class="hint" data-style="info">
+
+포트원에서는 결제모듈 V2를 연동하시는 분들께 별도의 기술지원을 추가적으로 지원하고 있습니다.
+연동하시면서 기술지원이 필요하시거나 궁금하신 사항이 있으신 경우 아래 이메일로 문의주시기 바랍니다.
+
+- V2 기술지원 이메일: <tech.support@portone.io>
+
+</div>

package/assets/docs/opi/ko/integration/using-ai-tools.md

@@ -0,0 +1,140 @@
+---
+title: AI 도구 활용하기
+description: AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+## 포트원 MCP (Model Context Protocol) 서버
+
+포트원은 쉬운 연동과 빠른 개발을 위해 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@latest"]
+    }
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
+
+</div>
+
+설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
+
+#### 포트원 기능 사용하기
+
+MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
+
+- 결제 내역 단건/다건 조회
+- 본인인증 내역 단건/다건 조회
+
+연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
+
+```json
+{
+  // ...
+
+  "mcpServers": {
+    // ...
+
+    "portone-mcp-server": {
+      "command": "uvx",
+      "args": ["portone-mcp-server@latest"],
+      // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
+      "env": {
+        "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
+      }
+    }
+  }
+}
+```
+
+<div class="hint" data-style="warning">
+
+**API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
+
+내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
+
+</div>
+
+<div class="hint" data-style="warning">
+
+**MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
+
+이 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
+
+</div>
+
+<div class="hint" data-style="warning">
+
+**제3자 AI 서비스를 사용할 경우, API 응답(조회된 데이터 등)이 AI 서비스 측으로 전달되어 저장되거나 해당 서비스의 정책에 따라 모델 학습에 사용될 수 있습니다.**
+
+MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않도록, 우선적으로 해당 정보를 식별 및 제거하는 보호 조치를 마련하고 있습니다.
+다만, 그 외의 정보는 AI 서비스의 운영 정책에 따라 일시적으로 저장되거나 처리될 수 있는 점을 유의해야 합니다.
+
+</div>
+
+### 2. MCP 서버 활용하기
+
+사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
+
+#### 개발 관련 프롬프트 예시
+
+- _"포트원 V2로 카카오페이 결제창 호출을 구현해줘"_
+- _"포트원 문서 읽고 V1 페이팔 결제창 호출하는 코드 작성해줘"_
+- _"포트원 V2 Python 서버 SDK 사용해서 결제건 조회하는 스크립트 작성해줘"_
+- _"Kotlin으로 포트원 V2 웹훅 검증하는 코드 작성해줘"_
+- _"Java로 포트원 서버 SDK 사용해서 포트원 V2 결제 연동하는 법 알려줘"_
+- _"포트원 파트너정산 자동화 서비스에 파트너 등록하는 코드를 타입스크립트로 구현해줘"_
+
+#### 전반적인 질의 예시
+
+- _"포트원 문서 읽고 V2와 V1의 차이점을 설명해줘"_
+- _"포트원 V2가 지원하는 PG사 목록 보여줘"_
+- _"포트원 API의 하위호환성 정책 설명해줘"_
+- _"포트원 파트너정산 자동화 서비스가 제공하는 기능들을 요약해줘"_
+
+## llms.txt 표준 지원
+
+포트원 개발자센터 웹사이트는 [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를 파일로 업로드해 질의하는 방식으로도 활용이 가능합니다.
+
+## LLM 전용 개발자센터 문서 디렉터리
+
+포트원 개발자센터 내 문서들을 마크다운 형식으로 담고 있는 LLM 전용 문서 디렉터리를 제공합니다.
+
+해당 디렉터리는 포트원 MCP 서버와 같은 포트원 관련 도구를 만드는 데 사용될 수 있으며,
+
+Cursor, Windsurf, Claude Code와 같이 코드베이스 맥락을 자동으로 분석하는 AI 도구를 사용하는 경우
+해당 디렉터리를 해당 도구로 열어 질의하는 방식으로도 활용하실 수 있습니다.
+
+이 경우 위 AI 도구들이 제공하는 임베딩 기반 색인과 RAG (Retrieval Augmented Generation) 검색이 자동적으로 적용되어
+일부 질의에 대해 보다 원활하게 원하는 결과를 얻으실 수 있습니다.
+
+(파일: LLM 전용 포트원 문서 디렉터리 다운로드)