portone-io/mcp-server
If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
PortOne MCP Server is designed to assist PortOne users by providing accurate information through LLM (Large Language Model) based on official documentation from the PortOne Developer Center and Help Center.
Tools
Functions exposed to the LLM to take actions
list_portone_docs
포트원 문서 목록을 카테고리별로 필터링하여 조회합니다. 목록에는 문서 경로, 제목, 설명, 대상 버전 등 축약된 문서 정보가 포함되어 있습니다.
Args: dev_docs: 개발자를 위한 문서 포함 여부 (blog/, release-notes/, help/로 시작하지 않는 모든 문서) tech_blog: 기술 블로그 포스트 (blog/) 포함 여부 release_notes: 개발자센터 릴리즈 노트 (release-notes/) 포함 여부 help_docs: 개발과 무관하게 서비스 관련 내용을 일반적으로 담는 헬프센터 문서 (help/) 포함 여부
Returns: 필터링된 문서 목록 (각 문서의 경로, 길이, 제목, 설명, 대상 버전 등)
read_portone_doc_metadata
포트원 개별 문서의 경로를 통해 해당 포트원 문서의 제목, 설명, 대상 버전을 포함한 메타 정보 전체를 가져옵니다.
Args: path: 읽을 포트원 문서의 경로
Returns: 포트원 문서를 찾으면 해당 메타 정보를 반환하고, 찾지 못하면 오류 메시지를 반환합니다
read_portone_doc
포트원 개별 문서의 경로를 통해 해당 포트원 문서의 내용을 가져옵니다.
Args: path: 읽을 포트원 문서의 경로
Returns: 포트원 문서를 찾으면 해당 내용을 반환하고, 찾지 못하면 오류 메시지를 반환합니다
Note: 먼저 list_portone_docs을 사용해 포트원 문서 목록을 확인하고, 그 중 원하는 문서의 path를 read_portone_doc에 전달하여 내용을 확인할 수 있습니다.
regex_search_portone_docs
포트원 문서의 내용 중 파이썬 re 정규표현식 형식의 query가 매칭된 부분을 모두 찾아 반환합니다. 정규식 기반으로 관련 포트원 문서를 찾고 싶은 경우 이 도구를 사용하며, 메타 정보와 문서 내용 모두 검색합니다.
Args: query: Python re 패키지가 지원하는 Regular Expression 형식의 문자열을 입력해야 하며, 영어 알파벳 대소문자는 구분 없이 매칭됩니다. 절대 query에 공백을 포함시키지 마세요. 여러 키워드를 한 번에 검색하고 싶다면, 공백 대신 | 연산자를 사용하여 구분합니다. 단어 글자 사이에 공백이 있는 경우도 매칭하고 싶다면, 공백 대신 \s*를 사용하세요. context_size: 검색 결과의 컨텍스트 크기로, 문자 수를 기준으로 합니다. query 매치가 발견된 시작 인덱스를 idx라고 할 때, max(0, idx - context_size)부터 min(contentLength, idx + len(query) + context_size) - 1까지의 내용을 반환합니다. 단, 이전 검색결과와 겹치는 컨텍스트는 병합되어 반환됩니다. limit: 반환할 최대 문자열 길이입니다. 기본값은 50000입니다. 출력이 이 길이를 초과하면 잘리고 truncation 메시지가 추가됩니다. start_index: 결과 문자열의 페이지네이션을 위한 시작 인덱스입니다. 기본값은 0입니다. 전체 결과 문자열에서 start_index 위치부터 limit 길이만큼의 부분 문자열을 반환합니다. 동일한 query, context_size로 다른 start_index를 사용해 다음 결과를 얻을 수 있습니다.
Returns: 포트원 문서를 찾으면 해당 문서의 경로와 길이, 제목, 설명, 대상 버전과 함께, query가 매칭된 주변 컨텍스트를 반환합니다. 찾지 못하면 오류 메시지를 반환합니다.
read_portone_openapi_schema_summary
요청된 포트원 버전에서 제공하는 OpenAPI 스키마를 요약해 문자열로 반환합니다. 해당 요약에는 요청된 포트원 버전에서 제공하는 모든 REST API가 포함되어 있습니다.
Args: version: 포트원 버전 ("V1" or "V2")
Returns: OpenAPI 스키마를 최대 depth 3으로 요약한 YAML 형식의 문자열을 반환합니다.
read_portone_openapi_schema
요청된 포트원 버전에서 제공하는 OpenAPI 스키마 내 특정 path의 데이터를 반환합니다.
Args: version: 포트원 버전 ("V1" or "V2") path: OpenAPI 스키마 내의 yaml path (list of strings) 키 또는 인덱스(0부터 시작)를 포함할 수 있습니다.
Returns: OpenAPI 스키마를 최대 depth 3으로 요약한 YAML 형식의 문자열을 반환합니다.
read_portone_v2_backend_code
지정된 매개변수에 따라 포트원 V2 백엔드 코드 예제를 가져옵니다. 포트원 V2에 관련해 어떤 상황이든 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 이 도구를 호출해 예시 코드를 참고한 후 사용자를 도우세요. framework를 제외한 모든 Args는 선택사항이며, 특정되지 않은 경우 비워두세요.
Args: framework: 사용할 프레임워크. 일치하지 않더라도 현재 맥락에서 가장 유사한 프레임워크를 명시합니다. 옵션: express, fastapi, flask, spring-kotlin pg: 사용할 결제 게이트웨이. 옵션: toss, nice, smartro, kpn, inicis, ksnet, kcp, kakao, naver, tosspay, hyphen, eximbay pay_method: 사용할 결제 방법. 옵션: card, virtualAccount, easyPay, transfer, mobile, giftCertificate smart_routing: 스마트 라우팅 사용 여부. 옵션: true 또는 false
Returns: 백엔드 코드 예제를 마크다운 형식으로 반환하거나, 요청이 실패한 경우 오류 메시지를 반환합니다.
read_portone_v2_frontend_code
지정된 매개변수에 따라 포트원 V2 프론트엔드 코드 예제를 가져옵니다. 포트원 V2에 관련해 어떤 상황이든 프로그래밍 언어로 코드를 작성해야 한다면, 예외 없이 가장 먼저 이 도구를 호출해 예시 코드를 참고한 후 사용자를 도우세요. framework를 제외한 모든 Args는 선택사항이며, 특정되지 않은 경우 비워두세요.
Args: framework: 사용할 프레임워크. 일치하지 않더라도 현재 맥락에서 가장 유사한 프레임워크를 명시합니다. 옵션: html, react pg: 사용할 결제 게이트웨이. 옵션: toss, nice, smartro, kpn, inicis, ksnet, kcp, kakao, naver, tosspay, hyphen, eximbay pay_method: 사용할 결제 방법. 옵션: card, virtualAccount, easyPay, transfer, mobile, giftCertificate smart_routing: 스마트 라우팅 사용 여부. 옵션: true 또는 false
Returns: 프론트엔드 코드 예제를 마크다운 형식으로 반환하거나, 요청이 실패한 경우 오류 메시지를 반환합니다.
Prompts
Interactive templates invoked by user choice
No prompts
Resources
Contextual data attached and managed by the client
