시작 가이드
AI 에이전트에 지갑 연결하기
4단계로 AI 에이전트가 x402 결제를 할 수 있도록 설정하세요.
Claude Desktop 또는 Claude Code에서 테스트할 수 있습니다.
1
지갑 연결2
USDC 받기3
MCP 설정4
테스트1
지갑 설정하기
테스트 지갑을 새로 생성하거나, 기존 MetaMask 지갑을 사용할 수 있습니다.
새 테스트 지갑을 자동으로 생성합니다
MCP 서버 전용 테스트 지갑을 생성하면 기존 지갑과 분리하여 안전하게 테스트할 수 있습니다.
테스트 전용
이 지갑은 테스트 전용입니다. 실제 자산을 보관하지 마세요.
2
테스트 USDC 받기
Circle Faucet에서 무료로 테스트 USDC를 받으세요. (Base Sepolia 네트워크)
3
MCP 서버 설정
x402 MCP 서버를 추가하세요. CDP 가입 불필요, 프라이빗 키만 있으면 됩니다.
# 1. 환경변수 설정 (프라이빗 키 입력)
export PRIVATE_KEY="0x..."
# 2. MCP 서버 추가
claude mcp add x402 -- npx -y x402-fetch-mcp보안 주의사항
프라이빗 키는 절대 공유하지 마세요. 테스트용 지갑과 메인 지갑을 분리하여 사용하는 것을 강력히 권장합니다.
4
테스트하기
Claude에게 보호된 콘텐츠에 접근해달라고 요청하세요.
프롬프트 예시
learn402.xyz/demo/protected-content 페이지에 접속해서 내용을 알려줘.예상 결과
- 1.Claude가 페이지에 접속 시도
- 2.서버가 402 Payment Required 응답
- 3.MCP 서버가 자동으로 $0.01 USDC 결제
- 4.마크다운 콘텐츠 + 성공 플래그 수신
성공 확인
AI가 받은 플래그를 입력해서 테스트 성공을 확인하세요.
플래그는 x402_SUCCESS_로 시작합니다.