Bootpay Developer Docs MCP Server

Bootpay MCP Server

Korea's payment integration, now accessible to AI. 한국 결제 연동을 AI가 직접 수행할 수 있도록 하는 MCP 서버입니다.

AI 코딩 도구(Claude, Cursor, Windsurf, Cline, GitHub Copilot 등)에서 Bootpay 결제·커머스 개발자 문서를 검색하고 참조할 수 있는 Model Context Protocol (MCP) 서버입니다.

MCP를 연결하면 AI가 최신 SDK 버전 확인, 문서 검색, 예제 코드 조회, 트러블슈팅을 직접 수행하여 정확한 결제 연동 코드를 생성합니다.

Supported PG & Payment Methods

Bootpay는 국내 주요 PG사와 간편결제를 통합 지원합니다:

결제 유형: 일반결제 (카드/계좌이체/가상계좌/휴대폰) · 정기결제 (빌링키) · 본인인증 · 에스크로 · 현금영수증

Quick Start

두 가지 연결 방식을 지원합니다:

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows):

npm (stdio) — 추천:

{
  "mcpServers": {
    "bootpay-docs": {
      "command": "npx",
      "args": ["-y", "@bootpay/mcp"]
    }
  }
}

HTTP (원격):

{
  "mcpServers": {
    "bootpay-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.bootpay.ai/mcp"]
    }
  }
}

Claude Code (CLI)

# npm (stdio)
claude mcp add bootpay-docs -- npx -y @bootpay/mcp

# HTTP
claude mcp add bootpay-docs --transport http https://mcp.bootpay.ai/mcp

Cursor

Settings → MCP Servers → Add:

{
  "bootpay-docs": {
    "url": "https://mcp.bootpay.ai/mcp"
  }
}

Windsurf / Cline / Other MCP Clients

Streamable HTTP endpoint:

https://mcp.bootpay.ai/mcp

What AI Can Do with This MCP

MCP를 연결하면 AI가 다음을 직접 수행합니다:

사용자: "React에서 부트페이 카드결제 연동해줘"

AI 내부 동작:
  1. get_sdk_versions         → 최신 SDK 버전 확인 (v2 5.x)
  2. get_setup_checklist      → Application ID + 환경 설정 안내
  3. search_docs → get_doc    → payment/request 문서 조회
  4. 코드 작성                → 문서 기반, 정확한 버전 사용

7 Tools + 1 Prompt

For AI Agents Reading This Repo Directly

MCP 서버를 설정하지 않은 상태에서 이 레포를 참고하는 AI를 위한 안내:

Critical Rules

• SDK v2 (5.x) only — bootpay-3.x.x.min.js, bootpay-4.x.x.min.js are v1 (deprecated) and will not work
• Application ID required — must be obtained from Bootpay Admin, never use placeholder values
• Private Key — server-side only, never expose in client code

Supported Platforms & SDKs

Client SDKs

Server SDKs

Documentation Categories