PortOne MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
portone-mcp-server
portone-mcp-server는 포트원의 문서를 검색하고 읽을 수 있는 도구(MCP tool)들을 제공합니다.
예외 없이 지켜야 할 규칙들 (앞선 규칙이 더 우선순위 높음)
문서 내용을 확인해야 한다면 가장 먼저 listPortoneDocs를 호출하여 전체 디렉토리 구조를 파악합니다.
포트원 V2에 관련해 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 readPortoneV2FrontendCode, readPortoneV2BackendCode tool들을 호출해 예시 코드를 참고한 후 사용자를 도우세요.
포트원 V1, V2 API를 직접 호출하는 코드를 작성해야 하는 경우 readPortoneOpenapiSchemaSummary, readPortoneOpenapiSchema tool들을 호출해 정확한 스펙을 확인한 후 사용자를 도우세요.
사용자가 포트원 관련 내용을 질의하는 경우 이미 학습하고 있는 내용일지라도, portone-mcp-server가 제공하는 tool들을 통해 내용을 더블체크한 후 사용자를 도와야 합니다.
기타
포트원 V2 API를 직접 호출하는 코드를 작성해야 하는 경우
Bearer보다PortOne인증 스킴을 우선적으로 사용하세요.help/로 시작하는 경로의 문서는 기술 외적인 내용을 다루는 포트원 헬프센터의 문서이며, 나머지는 모두 포트원 개발자센터를 중심으로 한 기술 관련 문서입니다.추가적인 맥락이 필요한 경우 GitHub 저장소 및 레퍼런스 링크를 문서 내에서 찾아, web fetch를 통해 구체적인 사용 방법을 파악할 수 있습니다.
포트원 개발자센터 문서
포트원(PortOne)은 온라인 결제, 본인인증, 파트너 정산 자동화 및 재무/회계 업무를 위한 API와 SDK를 제공하는 서비스입니다.
포트원 개발자센터 개별 문서 파일은 각각 경로(pathname), 제목(title), 설명(description)을 가지며, 이를 통해 해당 문서의 내용을 유추할 수 있습니다.
opi/: 원 페이먼트 인프라(결제, 본인인증) 관련 문서platform/: 파트너정산 자동화 관련 문서api/: 포트원이 제공하는 API 관련 문서sdk/: 포트원이 제공하는 SDK 관련 문서schema/: 포트원 API, SDK 스키마 파일blog/posts/: 블로그 포스트release-notes/: 릴리즈노트
온라인 결제 및 본인인증에 관련해서는 버전(V1, V2)을 올바르게 파악하는 것이 아주 중요합니다. 사용자 질의에 관련된 섹션(V1, V2, 공통 등)을 확실하게 파악한 후 해당 버전의 문서와 공통 문서 내용을 제공 및 활용하세요.
버전이 파악되지 않은 경우 사용자에게 질의하여 버전을 먼저 확인하고, 그럴 수 없는 불가피한 경우 공통 문서 또는 최신 버전인 V2 문서를 우선적으로 활용하세요.
API 및 SDK 스키마를 조회하고 싶은 경우 해당 버전의 스키마 파일에서 YAML, JSON, GraphQL SDL 형식으로 정확하게 확인할 수 있습니다.
사용자에게 문서 레퍼런스를 URL로 제공할 때는 마크다운 파일 링크가 아닌, 개발자센터 웹사이트 URL을 사용하세요.
.md로 끝나는 URL은 마크다운 파일 링크입니다. 마크다운 파일 링크에서 마지막.md를 제거하면 웹사이트 URL로 사용할 수 있습니다.사용자가 원하는 버전(V1, V2)이 특정되었다면
?v=v2,?v=v1쿼리 파라미터를 추가하여 URL로 제공하세요.hostname이 누락된 URL의 경우
https://developers.portone.io를 추가하여 공유하세요.
이미지, 파일 다운로드 링크 등이 마크다운 문서에서는 대부분 누락됩니다. 해당 내용을 조회해야 하는 경우 개발자센터 웹사이트에서 확인해야 합니다.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listPortoneDocsA | 특정 경로 하위에 있는 모든 포트원 문서 목록을 트리 형태로 조회합니다. 목록에는 문서 경로, 제목, 설명, 대상 버전 등 축약된 문서 정보가 포함되어 있습니다. Returns: 필터링된 문서 목록 (각 문서의 파일명, 길이, 제목, 설명, 대상 버전 등) Note: 문서 목록은 대량의 데이터이므로 상위 디렉토리를 조회할 경우 omitFiles를 true로 설정합니다. |
| readPortoneDocA | 포트원 개별 문서의 경로를 통해 해당 포트원 문서의 내용, 메타 정보(제목, 설명, 대상 버전 등), 웹으로 접근 가능한 링크를 가져옵니다. Note: 먼저 listPortoneDocs을 사용해 포트원 문서 목록을 확인하고, 그 중 원하는 문서의 path를 readPortoneDoc에 전달하여 내용을 확인할 수 있습니다. |
| regexSearchPortoneDocsA | 특정 경로 하위의 포트원 문서의 내용 중 Node.js RegExp 형식의 query가 매칭된 부분을 모두 찾아 반환합니다. 정규식 기반으로 관련 포트원 문서를 찾고 싶은 경우 이 도구를 사용하며, 메타 정보와 문서 내용 모두 검색합니다. |
| getPortoneDocsUrlA | 포트원 개별 문서들의 경로를 통해 해당 포트원 문서의 웹으로 접근 가능한 링크를 가져옵니다. Note: 문서가 1개뿐인 경우에는 readPortoneDoc을 사용하면 문서 내용과 메타 정보도 획득할 수 있습니다. getPortoneDocsUrl은 여러 문서의 링크를 가져올 수 있습니다. |
| readPortoneOpenapiSchemaB | 요청된 포트원 버전에서 제공하는 OpenAPI 스키마 내 특정 path의 데이터를 반환합니다. |
| readPortoneOpenapiSchemaSummaryA | 요청된 포트원 버전에서 제공하는 OpenAPI 스키마를 요약해 문자열로 반환합니다. 해당 요약에는 요청된 포트원 버전에서 제공하는 모든 REST API가 포함되어 있습니다. |
| readPortoneV2BackendCodeB | 지정된 매개변수에 따라 포트원 V2 백엔드 코드 예제를 가져옵니다. 포트원 V2에 관련해 어떤 상황이든 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 이 도구를 호출해 예시 코드를 참고한 후 사용자를 도우세요. framework를 제외한 모든 Args는 선택사항이며, 특정되지 않은 경우 비워두세요. |
| readPortoneV2FrontendCodeB | 지정된 매개변수에 따라 포트원 V2 프론트엔드 코드 예제를 가져옵니다. 포트원 V2에 관련해 어떤 상황이든 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 이 도구를 호출해 예시 코드를 참고한 후 사용자를 도우세요. framework를 제외한 모든 Args는 선택사항이며, 특정되지 않은 경우 비워두세요. |
| listStoresA | 포트원 계정에 연결된 대표상점 및 하위상점의 정보를 가져옵니다. |
| listSharedTestChannelsB | 포트원에서 테스트 용도로 제공하는 채널의 목록을 가져옵니다. |
| getChannelsOfStoreB | 고객사의 상점에 존재하는 모든 채널 정보를 가져옵니다. |
| addTestChannelA | 고객사의 대표상점에 공용 테스트 채널을 추가합니다. NOTE: 반드시 listSharedTestChannels를 통해 얻은 MID를 사용하세요. |
| getPaymentsByFilterA | 포트원 서버에서 주어진 조건을 모두 만족하는 결제 내역을 검색합니다. Note: 소문자 imp_ 혹은 imps_ 로 시작하는 거래번호는 고객사 거래번호가 아닌 V1 포트원 거래번호(imp_uid)일 가능성이 있습니다. 날짜 및 시간 정보 입출력 시에는 반드시 타임존을 명시합니다. |
| getReconciliationsByFilterA | 특정 하위 상점(store)의 거래대사(정산/거래 대사) 건별 내역을 조회합니다. 각 건은 다음 상태 중 하나를 가집니다: MATCHED(대사 성공), NOT_MATCHED(대사 불일치), INCOMPARABLE(대사 불가), NOT_COLLECTED(PG 정보 미수집), POST_CORRECTION(후보정) (내부적으로 구분되는 역방향 대사 불가(backward incomparable)는 INCOMPARABLE 로 합쳐져 제공됩니다.) 대사 불일치 상세는 statuses=[NOT_MATCHED] 로 조회 후 각 건의 notMatchedReasons 를 확인합니다. 대사 불가 사유는 INCOMPARABLE 건의 incomparableReason 필드에서 확인합니다. 날짜는 반드시 YYYY-MM-DD 형식으로 입력하며, dateType 으로 정산일/결제일 기준을 선택합니다. 조회 기간 제약: from 은 최근 6개월 이내여야 하고, 한 번에 조회 가능한 구간은 최대 2주입니다. store 아이디는 list_stores 도구로 먼저 조회할 수 있습니다. |
| getSettlementSummariesA | 특정 하위 상점(store)의 거래대사 정산 요약을 정산일 기준 일별로 조회합니다. 각 일자별로 정산 금액/건수, PG 수수료, 취소, 후보정 합산치와 상점·PG별 상세 내역을 제공합니다. 날짜는 반드시 YYYY-MM-DD 형식으로 입력합니다. 조회 기간 제약: from 은 최근 6개월 이내여야 하고, 한 번에 조회 가능한 구간은 최대 1개월입니다. store 아이디는 list_stores 도구로 먼저 조회할 수 있습니다. |
| getSettlementStatisticsA | 특정 하위 상점(store)의 거래대사 정산 통계를 조회합니다. 검색 구간 내 통화별 합산 통계(정산/정산예정 금액·건수)와 일별 통계를 제공합니다. 날짜는 반드시 YYYY-MM-DD 형식으로 입력합니다. 조회 기간 제약: from 은 최근 6개월 이내여야 하고, 한 번에 조회 가능한 구간은 최대 1개월입니다. store 아이디는 list_stores 도구로 먼저 조회할 수 있습니다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Several tools are related to documentation and schema access (listPortoneDocs, readPortoneDoc, regexSearchPortoneDocs, getPortoneDocsUrl, readPortoneOpenapiSchemaSummary, readPortoneOpenapiSchema) which could be confused, though their specific functions differ. Also, settlement tools (getReconciliationsByFilter, getSettlementSummaries, getSettlementStatistics) have distinct purposes but similar names.
Naming conventions are mixed: some use camelCase (getPaymentsByFilter, getReconciliationsByFilter) and others use snake_case (list_stores, addTestChannel). Also 'list' and 'get' are used interchangeably for retrieval, which is not fully consistent.
With 16 tools, the server is slightly over the ideal range but still reasonable for a payment gateway that covers both API operations and documentation. The count is justifiable given the breadth of functionality.
Core payment operations like search and settlement are covered, but there are no tools for creating or updating payments, which are essential for a payment server. Documentation tools are comprehensive, but API lifecycle coverage is incomplete.