Crossmint Checkout MCP Server

Crossmint Checkout MCP 서버

Crossmint의 Checkout API는 프로그래밍 가능한 화폐인 스테이블코인을 사용하여 실물 및 가상 상품과 서비스를 프로그래밍 방식으로 구매할 수 있도록 지원합니다. AI 에이전트는 추가 비용 없이, 온라인 결제를 위해 가상 직불 카드나 브라우저를 사용해야 하는 번거로움이나 불안정함 없이 10억 개 이상의 상품을 안정적으로 구매할 수 있습니다.

에이전트가 품목 SKU/식별자를 얻을 수 있는 경우 이 API를 통해 해당 품목을 구매할 수 있습니다.

역량

이 MCP 서버는 품목 식별자(URL에서 SKU까지)를 사용하여 단일 API 호출로 해당 품목의 구매를 실행할 수 있도록 합니다.

다음 구매는 실제 구매입니다.

• 해당 상품은 긴급 배송으로 배송됩니다.
• 영수증이 생성됩니다
• 매출세가 제대로 징수되었습니다
• 반품 및 환불이 가능합니다

사용 가능한 재고

• Amazon (미국 전용)
  • Prime 배송 포함
• Shopify (글로벌)
  • 모든 Shopify 스토어에서 무엇이든 구매하세요

곧 출시:

• 항공편 (~5월 2일)
• 호텔 (5월 중순)
• 식사
• 티켓

구매는 어떻게 지불되나요?

이 MCP 서버를 사용하려면 USDC(스테이블코인)로 서버에 충전해야 합니다. 향후 버전에서는 신용카드 결제가 가능하며, 백엔드에서 스테이블코인으로 자동 변환됩니다.

USDC를 얻는 방법

USDC는 암호화폐 거래소에서 이용 가능합니다. 또한, 이 MCP 서버는 Coinbase의 온램프를 통합하여 수동으로 충전할 수 있는 링크를 제공합니다.

설정

현재 버전에서는 MCP 보안 기능의 제한으로 인해 이 서버는 로컬에서 실행해야 합니다.

또한, 주문의 배송 주소는 설정 과정에서 하드코딩됩니다.

1. 저장소를 복제합니다지엑스피1
2. 종속성 설치
   npm install
3. .env 파일 생성
   cp .env.template .env
4. API 키 얻기
   • CROSSMINT_API_KEY : Crossmint API 키 받기 :
     • Crossmint 콘솔에 로그인하고 통합 > API 키 > 새 키 만들기로 이동합니다.
     • 범위를 선택하세요: orders.create , orders.read , wallets:transactions.create , wallets.create , wallets.balance:read . 스테이징 API 키의 경우 wallets.fund 도 포함하세요.
     • API 키를 복사하여 .env 파일에 붙여넣으세요.
   • COINBASE_PROJECT_ID : Coinbase 개발자 계정을 만들고 Coinbase 프로젝트 ID를 복사하여 .env 파일에 붙여넣습니다.
5. 배송정보를 입력하세요.env 파일에 주문 수령자 이름, 배송 주소, 이메일을 지정하세요.
6. 테스트 대 프로덕션이 MCP 서버에서 시도된 주문은 실제 주문입니다. 테스트 주문을 완료하려면 .env 파일의 ENV 변수를 "test"로 변경하세요.
7. 지갑 생성
   npm run generate-wallet
8. Claude의 구성 업데이트
   npm run update-claude-config
9. 프로젝트를 빌드하세요
   npm run build
10. 서버를 실행하세요

클로드와 함께 사용하세요

클로드에게 다음을 요청하세요.

1. 거래에 사용할 지갑에 자금을 입금하세요
2. 찾고 있는 제품을 설명하고 Amazon.com 링크를 요청하세요. 예: "무향 LaCroix 스프링클링 워터를 사고 싶어요! Amazon에서 5달러 이하로 구매할 수 있는 제품을 찾아주시겠어요? 찾으시면 Amazon 링크를 공유해 주세요."
3. Claude에게 구매를 요청하세요. 즉, " https://www.amazon.com/Sparkling-Naturally-Essenced-Calories-Sweeteners/dp/B00O79SKV6 를 구매하세요"
4. 구매 영수증을 이메일에서 확인하세요

도구

1. create-order 지정된 상품에 대한 새 주문을 생성합니다. Amazon 상품은 'amazon:<amazon_product_id>' 또는 'amazon:'으로 지정하고, Shopify 상품은 'shopify::'으로 지정합니다.예시 프롬프트:

   "이거 사주세요 https://www.amazon.com/Sparkling-Naturally-Essenced-Calories-Sweeteners/dp/B00O79SKV6 "

2. check-order 기존 주문의 상태를 확인합니다.예시 프롬프트:

   "제 주문 상태는 어떻게 되나요? 제 주문 ID는 8312a4b3-67f0-4518-bf82-8447357295e6입니다."

3. get-usd-balance 지갑의 USD 잔액을 가져옵니다.예시 프롬프트:

   "내 지갑 잔액은 얼마예요?"

4. fund-usd USDC 온램핑을 위한 Coinbase Pay URL을 생성합니다. 프로덕션 환경에서만 사용 가능합니다.예시 프롬프트:

   "내 지갑에 10달러를 넣고 싶어요"

5. fund-test-usd 스테이징 환경의 Faucet에서 USDC를 요청합니다. 테스트 환경에서만 사용 가능합니다.예시 프롬프트:

   "내 지갑에 10달러를 넣고 싶어요"

지원하다

질문이 있으시면 support@crossmint.io 로 Crossmint에 직접 문의하세요.