피드로 돌아가기
How to build an x402-gated MCP endpoint (with real Base L2 USDC flow)
Dev.toDev.to
Backend

Base L2 USDC와 x402 프로토콜을 통한 무인 AI-to-AI 결제 MCP 엔드포인트 구현

How to build an x402-gated MCP endpoint (with real Base L2 USDC flow)

Global Chat2026년 4월 16일7advanced

Context

기존 Paid API는 신용카드 기반의 인간 결제 체계에 의존하여 Wallet을 보유한 AI Agent의 직접 결제가 불가능한 한계 존재. OAuth 및 API Key 발급 과정에서 발생하는 Human-in-the-loop 병목으로 인해 완전 자동화된 에이전트 간 경제 생태계 구축에 제약 발생.

Technical Solution

  • .well-known/agent-card.json을 통한 Chain ID, Asset, Recipient 정보의 사전 Discovery 구조 설계
  • HTTP 401 대신 x402(Payment Required) 상태 코드를 반환하여 결제 챌린지를 전송하는 인증 메커니즘 도입
  • EIP-3009 transferWithAuthorization 기반의 Typed Data 서명을 통해 가스비 부담 없이 결제 승인 권한을 위임하는 구조 채택
  • X-PAYMENT 헤더에 Base64 인코딩된 서명 데이터를 포함하여 재요청함으로써 서버 측에서 온체인 정산을 수행하는 무상태(Stateless) 결제 흐름 구현
  • EIP-712 도메인 설정(Name: "USD Coin", Version: "2")과 고엔트로피 Nonce 생성을 통한 서명 무결성 및 Replay Attack 방지책 적용
  • 서버 처리 지연을 고려한 validBefore 타임스탬프 윈도우 설정을 통해 온체인 트랜잭션 Revert 가능성 제거

1. EIP-712 도메인 정보(Name, Version)가 스마트 컨트랙트 정의와 일치하는지 검증

2. 온체인 검증 지연 시간을 고려하여 `validUntil` 윈도우를 최소 5분 이상으로 설정

3. 동일 송수신자 간 중복 결제 방지를 위해 요청마다 32바이트 이상의 고엔트로피 Nonce 생성 및 적용

원문 읽기