가장 쉽게 시작하기
AI 채팅창에 한 줄 던져요.
https://github.com/bootpay/bootpay-mcp 참조해서 mcp 설치해주고, 커머스 연동해줘.에이전트가 저장소의 README 를 읽고 Bootpay MCP 서버(npx -y @bootpay/mcp@latest)를 먼저 붙인 다음, 그 도구로 현재 프로젝트에 맞춰 상품·주문·구독·링크페이 같은 커머스 기능을 붙여 줘요. 같은 흐름에서 관리자 콘솔에 로그인해 커머스 키 발급까지 처리해요.
설정 파일만 바뀌고 지금 열려 있는 세션에는 반영되지 않아요. 설치가 끝나면 세션을 새로 시작한 뒤 다시 연동을 시켜요.
키 발급 단계로 안 넘어가면 한 줄 더 추가해요.
bootpay cli 로 어드민 열어서 커머스 키 발급해줘.발급받은 키는 프롬프트에 박지 말고 프로젝트 루트의 .env.local에 둬요. AI는 환경변수 이름만 알면 코드에서 바로 끌어 써요.
BOOTPAY_COMMERCE_CLIENT_KEY=...
BOOTPAY_COMMERCE_SECRET_KEY=..."구독 결제, 매월 1일 청구, 결제 실패 시 3회 재시도"처럼 조건을 같이 주면 한 번에 맞는 코드가 나와요.
CLI가 동작하지 않거나 직접 발급받고 싶다면 환경 설정에서 관리자 콘솔 절차를 봐요.
MCP 서버를 직접 등록하기
에이전트가 설치를 대신 못 하거나 설정을 직접 확인하고 싶을 때만 봐요. 위 한 줄로 시켰다면 이미 이 상태예요.
MCP(Model Context Protocol) 서버를 붙여 두면 AI가 매번 GitHub를 새로 읽지 않고 최신 문서·SDK 버전·커머스 API 도구를 바로 호출해요.
권장 방식은 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로 붙여요)
AI가 MCP 도구로 커머스 API(상품 등록·주문 생성 등)를 직접 호출하게 하려면 MCP 서버 환경변수에도 Commerce 키를 넣어요. 변수 이름은 저장소 README의 Commerce 설정 섹션을 봐요.
PG 결제창·결제위젯·자동결제 관련 MCP 도구가 필요하면 결제 SDK: AI 연동을 봐요.
