시작 가이드

AI 에이전트에 지갑 연결하기

4단계로 AI 에이전트가 x402 결제를 할 수 있도록 설정하세요.
Claude Desktop 또는 Claude Code에서 테스트할 수 있습니다.

결제 플로우 시각화

애니메이션으로 전체 과정 보기

페이월 체험

사람 vs AI 접근 비교

지갑 연결

USDC 받기

MCP 설정

테스트

지갑 설정하기

테스트 전용 지갑을 생성합니다.

새 테스트 지갑을 자동으로 생성합니다

MCP 서버 전용 테스트 지갑을 생성하면 기존 지갑과 분리하여 안전하게 테스트할 수 있습니다.

테스트 전용

이 지갑은 테스트 전용입니다. 실제 자산을 보관하지 마세요.

테스트 USDC 받기

Circle Faucet에서 무료로 테스트 USDC를 받으세요. (Base Sepolia 네트워크)

Circle Faucet에서 USDC 받기

Base Sepolia 네트워크 선택 → 위 지갑 주소 붙여넣기 → 1 USDC 받기

faucet.circle.com 바로가기

MCP 서버 설정

npm

x402-fetch-mcp 패키지를 설치하세요. 프라이빗 키만 있으면 됩니다.

# Step 1: 프라이빗 키 설정
# 키는 ~/.x402/config.json에 안전하게 저장됩니다
npx x402-fetch-mcp setup
# Enter your private key: 0x...
# Network [baseSepolia]: (엔터)

# Step 2: MCP 서버 등록
claude mcp add x402 -- npx x402-fetch-mcp

# Step 3: 설치 확인
claude mcp list
# 출력: x402 - ✓ Connected

보안 주의사항

프라이빗 키는 절대 공유하지 마세요. 테스트용 지갑과 메인 지갑을 분리하여 사용하는 것을 강력히 권장합니다.

테스트하기

Claude에게 보호된 콘텐츠에 접근해달라고 요청하세요.

프롬프트 예시

https://www.learn402.xyz/demo/protected-content 를 fetch 도구로 가져와줘

예상 결과

1.Claude가 페이지에 접속 시도
2.서버가 402 Payment Required 응답
3.MCP 서버가 자동으로 $0.01 USDC 결제
4.마크다운 콘텐츠 + 성공 플래그 수신

보호된 콘텐츠 직접 보기

성공 확인

AI가 받은 플래그를 입력해서 테스트 성공을 확인하세요.

플래그는 x402_SUCCESS_로 시작합니다.

추가 리소스