API & MCP

내 AI에게 NinjaBuy 계정을 맡기세요.

NinjaBuy에는 MCP 서버가 있어요. MCP를 지원하는 AI 앱을 연결하면 내 계정으로 로그인한 상태에서 주문 조회, 저희 창고에 있는 것 확인, 상품 읽기, 장바구니 채우기를 할 수 있어요.

mcp · ninjabuy.com/mcp샘플

창고에서 무엇이 대기 중인가요?

→ warehouse()

메시 러닝화 · 42검수 완료 · 사진 3장
골지 유리컵 · 4개 세트도착 · 0.62 kg
스트라이프 캔버스 토트백배송에 포함됨

3개가 도착했어요. 신발은 사진 3장으로 검수를 통과했고, 컵은 계량했고, 토트백은 이미 배송에 포함되어 있어요. 나머지 2개는 창고 페이지에서 배송하세요.

list_ordersorderwarehouseproductadd_to_cart

이용 방법

한 번 연결하고, 로그인하고, 물어보세요.

MCP 서버는 NinjaBuy 로그인을 쓰고 내 동의를 구해요. API는 내 코드와 플러그인을 위해 같은 범위를 다뤄요.

  1. NinjaBuy MCP 서버 추가

    AI 앱의 커넥터 설정에 서버 주소를 붙여넣으세요.

  2. 로그인하고 승인

    AI는 내가 승인한 뒤에만 내 계정에서 작동해요.

  3. 평소 말투로 질문하기

    주문 1012는 어디 있어? 검수에서 뭐가 대기 중이야? 이 링크 장바구니에 담아 줘.

단계별 가이드 읽기

받는 것

도구 5개와 API.

  • list_orders

    내 주문, 최신순, 상태와 미결제 금액 포함.

  • order

    주문 1건 전체: 상품과 가격, 도착, 배송과 송장 정보.

  • warehouse

    도착한 모든 상품: 검수 사진, 무게, 배송에 포함되었는지 여부.

  • product

    모든 상품 링크 읽기: 옵션, CN¥ 가격, 재고.

  • add_to_cart

    옵션을 장바구니에 담아요. 결제는 내가 해요.

  • API

    HTTPS로 같은 범위를, 플러그인과 내 코드용으로.

알아 두면 좋은 것

내 에이전트, 내 계정.

AI는 신입 직원처럼 설정하세요: 한계를 명확히 하고, 결과는 내가 확인하세요.

  • 나로서 작동해요

    AI가 NinjaBuy를 통해 하는 모든 일은 내 계정으로 이뤄져요.

  • 돈이 움직이지 않아요

    결제, 배송, 잔액 사용을 하는 도구는 없어요. 결제와 배송은 내가 직접 여는 페이지에서 해요.

  • 언제든 폐기 가능

    계정에서 연결을 삭제하면 접근이 종료돼요.

  • AI는 틀릴 수 있어요

    에이전트가 알려 준 내용은 행동하기 전에 확인하세요. 특히 가격과 재고요.

주문 1건의 비용

에이전트 장바구니의 결제 시 금액.

에이전트가 장바구니를 채우고, 결제는 내가 해요. 주문 1건, 현재 수수료와 배송 요금으로 계산했어요.

예시예요. 상품, 가격, 무게는 가상이에요. 수수료, 세금, 배송 요금은 현재 저희가 청구하는 금액이에요. 배송비는 저희 창고에서 측정한 무게로 계산돼요. 채널 자체 수수료와 내 판매 가격은 포함되지 않아요.

이온 헤어드라이어 · 화이트
미국 구매자에게 배송
예시

주문 결제 시

상품 대금판매자 가격 CN¥96.00 × 1
CN¥96.00
입고 수수료상품 그룹 1개
CN¥12.00
세금위 두 항목에 일괄 14%
CN¥15.12

택배 배송 시

미국 배송Ninja Saver 노선, 0.8 kg
CN¥84.00
취급택배 1개
CN¥50.00
세금위 두 항목에 일괄 14%
CN¥18.76
이 주문, 배달 완료CN¥275.88≈ US$44.22

자주 묻는 질문

셀러들이 묻는 질문

어떤 AI 앱이 되나요?
로그인을 지원하는 원격 MCP 서버에 연결되는 모든 앱.
무료인가요?
네. MCP 서버와 API는 무료이며, 구매하고 배송한 것만 내요.
에이전트가 주문할 수 있나요?
장바구니를 채울 수 있어요. 결제와 배송은 내가 해요.
REST API가 있나요?
네, 플러그인과 내 코드용으로요: 주문, 상품, 송장 추적.
코딩이 필요한가요?
MCP에는 필요 없어요. 주소를 붙여넣고 로그인하면 돼요.
아직 못 하는 것은?
결제, 취소, 배송 접수. 다음에 원하는 기능을 알려 주세요.

영업팀에 문의

AI에게 주문 업무를 맡기세요.

맡기고 싶은 일을 알려 주세요. 접근 권한을 설정하고 도구를 안내해 드려요.

  • 판매하는 것과 그 출처를 살펴봐요.
  • 박스, 라벨, 배송 노선을 설정해 드려요.
  • 스토어를 연결하면 주문이 들어오기 시작해요.