시작하기

AI 연동 가이드

GitHub 주소만 넣고 AI로 결제 연동을 시작해봐요.

Claude Code 같은 AI 에이전트에 Bootpay GitHub 저장소 주소를 넘기고 MCP 설치까지 시켜요. 에이전트가 MCP 를 붙인 뒤 SDK 설치부터 결제창·서버 검증 코드까지 한 번에 만들어 줘요.

영상으로 보기

바이브코딩 결제 연동 총 정리 — 신청부터 운영까지 · 28분 31초

가장 쉽게 시작하기

AI 채팅창에 한 줄 던져요.

https://github.com/bootpay/bootpay-mcp 참조해서 mcp 설치해주고, 결제 연동해줘.

에이전트가 저장소의 README 를 읽고 Bootpay MCP 서버(npx -y @bootpay/mcp@latest)를 먼저 붙인 다음, 그 도구로 현재 프로젝트에 맞춰 결제창 또는 결제위젯을 붙여 줘요. 같은 흐름에서 관리자 콘솔에 로그인해 연동키 발급까지 처리해요.

MCP 는 새 세션부터 잡혀요

설정 파일만 바뀌고 지금 열려 있는 세션에는 반영되지 않아요. 설치가 끝나면 세션을 새로 시작한 뒤 다시 연동을 시켜요.

키 발급 단계로 안 넘어가면 한 줄 더 추가해요.

bootpay cli 로 어드민 열어서 키 발급해줘.

발급받은 키는 프롬프트에 박지 말고 프로젝트 루트의 .env.local 에 둬요. AI는 환경변수 이름만 알면 코드에서 바로 끌어 써요.

BOOTPAY_CLIENT_KEY=...
BOOTPAY_SECRET_KEY=...
더 구체적으로 시키기

"서버는 Node.js, 결제수단은 카드만, 분리 승인 방식으로" 처럼 조건을 같이 주면 한 번에 맞는 코드가 나와요.

CLI 가 동작하지 않거나 직접 발급받고 싶다면 연동키 발급 에서 관리자 콘솔 절차를 봐요.

MCP 서버를 직접 등록하기

에이전트가 설치를 대신 못 하거나 설정을 직접 확인하고 싶을 때만 봐요. 위 한 줄로 시켰다면 이미 이 상태예요.

MCP(Model Context Protocol) 서버를 붙여 두면 AI 가 매번 GitHub 을 새로 읽지 않고 최신 문서·SDK 버전·관리자 도구를 바로 호출해요.

권장 방식은 stdio 예요 — 문서 도구뿐 아니라 로그인·연동키 발급 같은 관리자 도구까지 붙어요.

npx -y @bootpay/mcp@latestbash

@latest 를 빼면 npx 캐시에 남은 옛 사본이 실행돼요. 설치 후 확인은 claude mcp list (Codex 는 codex mcp list) 로 해요.

설정 방법(Claude Desktop, Claude Code, Cursor, Codex, Gemini, Windsurf, Cline)은 저장소 README 에 정리돼 있어요.

  • 저장소 — github.com/bootpay/bootpay-mcp
  • HTTP 엔드포인트 — https://bootpay-docs-mcp.rupy1014.workers.dev/mcp (문서 도구만. 관리자 도구가 필요하면 stdio 로 붙여요)

함께 보기