PortOne MCP Server

PortOne MCP Server for Developers

Local serverstdioPython

What is the PortOne MCP server?

Most developer tooling work still happens through a UI a human drives. PortOne MCP server moves it into the conversation instead. PortOne MCP Server for Developers.

The short version

포트원 사용자를 위한 MCP (Model Context Protocol) 서버입니다. 포트원 개발자센터, 헬프센터 등 공식 문서 내용을 LLM(Large Language Model)에 제공해 정확한 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.

The tools it exposes

The server publishes 6 tools. What each one is for:

  • PORTONE_ACCESS_TOKEN — 콘솔 OAuth 액세스 토큰(필수). 설정 시 정적 토큰 모드로 동작합니다
  • PORTONE_TOKEN_TYPE — 토큰 타입(선택, 기본값 Bearer)
  • PORTONE_CONSOLE_URL — 콘솔 (OAuth 브라우저 로그인)
  • PORTONE_MERCHANT_SERVICE_URL — 머천트 서비스 (OAuth 토큰 교환·갱신)
  • PORTONE_CHANNEL_SERVICE_URL — 채널 서비스 (채널 조회·추가)
  • PORTONE_GRAPHQL_URL — GraphQL 게이트웨이 (스토어·결제·거래대사·정산)

Getting it running

The server ships on npm as pnpm, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

What it needs from you

Configuration is passed through the environment: PORTONE_ACCESS_TOKEN, PORTONE_CONSOLE_URL, PORTONE_GRAPHQL_URL, DEVELOPERS_PORTONE_IO_PATH, HELP_PORTONE_IO_PATH, PORTONE_MERCHANT_SERVICE_URL, PORTONE_CHANNEL_SERVICE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. PortOne's toolset — PORTONE_ACCESS_TOKEN, PORTONE_TOKEN_TYPE, PORTONE_CONSOLE_URL and 3 more — is a fair guide to whether it matches your workflow. It is maintained by portone-io; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PORTONE_ACCESS_TOKEN콘솔 OAuth 액세스 토큰(필수). 설정 시 정적 토큰 모드로 동작합니다.
PORTONE_TOKEN_TYPE토큰 타입(선택, 기본값 Bearer).
PORTONE_CONSOLE_URL콘솔 (OAuth 브라우저 로그인)
PORTONE_MERCHANT_SERVICE_URL머천트 서비스 (OAuth 토큰 교환·갱신)
PORTONE_CHANNEL_SERVICE_URL채널 서비스 (채널 조회·추가)
PORTONE_GRAPHQL_URLGraphQL 게이트웨이 (스토어·결제·거래대사·정산)

How to install the PortOne MCP server

"mcpServers": {

     // 기존 설정

     "portone-mcp-server": {
       "command": "npx",
       "args": [
         "-y",
         "@portone/mcp-server@latest"
       ]
     }
   }

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PORTONE_ACCESS_TOKENCredential the server authenticates with.Yes
PORTONE_CONSOLE_URLEndpoint or connection string the server talks to.Yes
PORTONE_GRAPHQL_URLEndpoint or connection string the server talks to.Yes
DEVELOPERS_PORTONE_IO_PATHFilesystem location the server is allowed to use.Optional
HELP_PORTONE_IO_PATHFilesystem location the server is allowed to use.Optional
PORTONE_MERCHANT_SERVICE_URLEndpoint or connection string the server talks to.Yes
PORTONE_CHANNEL_SERVICE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use PortOne to PORTONE ACCESS TOKEN.
  • Use PortOne to PORTONE TOKEN TYPE.
  • Use PortOne to PORTONE CONSOLE URL.

Frequently asked questions

Node.js 22.6.0 or higher is required. For DXT installation on Claude Desktop, a known issue may require disabling the "Use embedded Node.js for MCP" option.