mcp

PortOne MCP Server provides an MCP (Model Context Protocol) integration that offers access to official PortOne documents (developer center, help center) and core console features. When registered as an MCP server, tools exposed by portone-mcp-server allow querying documentation, retrieving accurate information from PortOne sources, and performing select console actions such as listing channels, adding test channels, querying sub-stores, and reviewing payment histories. For operations that involve the PortOne console (like login-protected actions), you will need to complete browser-based authentication in your AI tool's console interface before issuing requests to the MCP server. The server is designed to surface authoritative PortOne content and support integration workflows alongside other AI tools in your environment.

Prerequisites:

• Node.js 22.6.0 or newer
• pnpm (recommended) or npm
• Access to the network to install npm packages

Option A: Install via DXT (recommended for one-click setup)

1. Download the latest portone-mcp-server.dxt from the GitHub Releases page: https://github.com/portone-io/mcp-server/releases
2. In a supported AI tool (Claude Desktop, etc.), install the downloaded .dxt file by dragging and dropping or opening it.
3. Restart the tool and verify that the MCP server is registered.

Option B: Install from source (Node.js environment)

1. Ensure Node.js 22.6.0+ is installed and pnpm is available.
2. Clone the repository and install dependencies:

   git clone https://github.com/portone-io/mcp-server.git
   cd mcp-server
   pnpm install
   

3. Run in development mode:

   pnpm dev
   

4. (Optional) Build and publish when ready:

   # bump version in package.json first
   rm -rf dist
   pnpm install
   pnpm build
   pnpm publish
   

Register the MCP server in your tools:

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

Tips and caveats:

• For console-related features (channel listing, sub-store queries, etc.), ensure you complete browser-based login when prompted by the AI tool that hosts the MCP integration.
• If you encounter issues with DXT installation in Claude Desktop, install Node.js 22.6.0+ and disable the built-in Node.js for MCP in Claude Desktop settings, then restart.
• The MCP server will surface content from PortOne sources; sensitive data should be handled carefully and ensure compliance with privacy policies when integrating with third-party AI services.
• When upgrading, keep the @portone/mcp-server package version in sync with your MCP registration to avoid compatibility issues.