본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

포트원 MCP — 포트원 개발자센터·헬프센터 문서와 콘솔 결제·정산 조회를 AI에 연결하는 공식 MCP 서버

portone-io/mcp-server

포트원이 만든 공식 MCP 서버 — 결제 연동 문서 검색과 콘솔 결제·정산 조회를 AI에서 바로 처리

포트원 공식 실험적 보안 점검 통과 ⚖ Apache 2.0 원클릭 ★ 29 업데이트 오늘
Claude Code Cursor Cline 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add portone-mcp-server -- npx -y @portone/mcp-server@latest

이 MCP가 해결하는 문제

결제 연동은 PG사별 규격과 V1·V2 API 차이 때문에 문서를 오가며 확인할 일이 많습니다. 포트원 콘솔에서 결제 내역이나 정산 대사를 확인하는 일도 화면을 일일이 조작해야 합니다. 이 서버는 공식 문서와 OpenAPI 스키마를 AI에 직접 제공하고, 콘솔의 조회 기능을 도구로 열어 연동 개발과 운영 확인을 한 대화에서 처리하게 합니다.

보안 점검

2026-11-16 점검
보안 점검 통과

포트원 공식 조직이 운영하는 서버로, 소스에서 악성 동작은 발견되지 않았고 콘솔 토큰은 메모리에만 보관하며 통신 대상은 포트원 도메인뿐입니다.

ℹ 이 점검(2026-11-16) 이후 저장소가 업데이트되었습니다. 최신 상태는 원 저장소에서 확인하세요. 보완이 있었다면 정정 요청으로 알려주세요.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 임의 셸 실행 없음
  • 제3자 서버 경유 없음
  • 자격증명 평문 저장 없음

유의사항

  • package.json 에 postinstall/preinstall 스크립트가 없고 npm 패키지(@portone/mcp-server)가 실재함
  • 콘솔 OAuth 토큰은 프로세스 메모리에만 두며 리프레시 토큰 갱신도 메모리 안에서 처리함(디스크 저장 코드 없음)
  • 로그인 시 로컬 콜백 서버(h3)를 잠시 띄우고 open 패키지로 브라우저를 엽니다. PKCE 사용
  • addTestChannel 도구는 콘솔에 테스트 채널을 추가하는 쓰기 작업이므로 로그인한 계정 권한으로 실행됨
  • README가 제3자 AI 서비스로 API 응답이 전달될 수 있음을 CAUTION 으로 명시하고 있음
  • 라이선스는 MIT OR Apache-2.0 이중 라이선스(GitHub 표기는 Apache-2.0)

데이터·키 전송 대상

developers.portone.iohelp.portone.ioadmin.portone.io(OAuth 로그인)merchant-service.prod.iamport.cochannel-service.prod.iamport.coapi.portone.io/graphql

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

결제 연동 코드 작성

포트원 V2로 Node.js 서버에서 결제 완료 후 결제 내역을 단건 조회해 검증하는 코드를 공식 문서 기준으로 작성해줘

웹훅 규격 확인

포트원 V2 웹훅 검증 방법과 재전송 정책을 헬프센터와 개발자센터 문서에서 찾아 정리해줘

결제·정산 대사 확인

콘솔에 로그인해서 이번 달 거래대사 정산 요약을 조회하고 불일치 건이 있는지 알려줘

자주 묻는 질문

API 키가 필요한가요?

문서 조회 기능은 키나 로그인 없이 쓸 수 있습니다. 채널·결제·정산 같은 콘솔 기능은 브라우저를 통한 콘솔 로그인이 필요하며, 브라우저 로그인이 불가능한 서버 환경에서는 PORTONE_ACCESS_TOKEN 환경 변수로 콘솔 OAuth 액세스 토큰을 주입할 수 있습니다.

어떤 환경에서 설치할 수 있나요?

Node.js 22.6.0 이상이 필요하며 npx 설정 한 줄로 등록합니다. README는 Cursor, Windsurf, Claude Desktop 등을 예로 들고 있고, GitHub Releases의 .dxt 파일로 Claude Desktop에 원클릭 설치하는 방법도 안내합니다.

조회한 결제 데이터의 개인정보는 어떻게 되나요?

README는 API 응답에 포함된 개인정보가 외부로 전달되지 않도록 식별·제거하는 보호 조치를 마련했다고 설명합니다. 다만 그 외 정보는 사용하는 AI 서비스의 정책에 따라 저장되거나 학습에 쓰일 수 있다고 경고하므로 제3자 AI 서비스 사용 시 유의해야 합니다.

연동 API

포트원 개발자센터 포트원 헬프센터 포트원 콘솔(admin.portone.io) 포트원 GraphQL API

관련 MCP

국내 판매처 통합 상품관리 MCP

minwoo19930301/korea-ecommerce-integrated-channel-mcp

실험적 보안 점검 통과

스마트스토어·쿠팡·11번가·지마켓·옥션 상품 등록·수정·판매중지·삭제를 한 번에 처리하는 MCP

커머스·결제 네이버 커머스API쿠팡 판매자 API API 키 필요
★ 8 1개월 전
Claude Code Cursor Cline

다이소 MCP

hmmhmmhm/daiso-mcp

실험적 사용 주의

다이소·편의점 재고·영화 시간표·유가 조회 공개 원격 MCP

커머스·결제 다이소올리브영 원클릭
★ 352 ↓ 185/주 오늘
Claude Code Cursor Cline

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!