402-LAB MCP server

402-LAB — 바이브코딩 제품을 에이전트에게 판매

라이브: https://handsel-mandate-demo.vercel.app (Base 메인넷, 실제 USDC). 지금 파는 상품은 국세청 사업자등록 상태 조회, 호출당 0.02 USDC, x402 Bazaar 등재. 이용 안내.

세 부분으로 되어 있습니다.

• 판매자 쪽 demo/ — 공식 x402 SDK로 만든 결제 게이트. 우리 상품(demo/tools/nts.js)을 팔고, 판매자의 기존 API 앞에도 그대로 세울 수 있습니다(demo/upstream.js, Seller Studio 내보내기 + UPSTREAM_SECRET). 402 응답에 Bazaar 발견 메타데이터가 포함됩니다. 운영·배포·확인 절차
• 구매자 쪽 mcp/ — 402-LAB MCP 서버. "1달러 안에서"라고 위임하면 Claude Desktop·Cursor·크롬 확장이 x402 Bazaar에서 상품을 찾아 예산 안에서만 결제하고 결과만 돌려줍니다. 상한·건당 한도·네트워크·판매자 허용 목록을 서버가 강제합니다. npm run mcp. 설정과 권한 모델
• 홍보·운영 — 홍보 문안과 영상 제작, 판매 신청서.

빠른 시작: npm ci && npm test, npm run demo(로컬 시뮬레이션, 키 없음), npm run mcp(구매자 지갑).

구매자 MCP 설치 (저장소 없이)

{ "mcpServers": { "402-lab": { "command": "npx", "args": ["-y", "github:Kairose-master/handsel-mandate"],
  "env": { "BUYER_PRIVATE_KEY": "0x...", "NETWORK": "eip155:84532", "MANDATE_MAX_USDC": "1" } } } }

Claude Desktop은 npm run build:mcpb로 만든 dist/402-lab.mcpb를 더블클릭해 설치합니다(키는 설치 화면에서 입력). 레지스트리·Smithery·mcp.so·Cursor 디렉터리·x402 에코시스템 제출 파일과 절차는 docs/directories.md에 있습니다.

첫 성공 기준은 외부 판매자의 도구를 외부 구매자가 실제로 쓰는 것입니다. 지금까지 정산은 내부 지갑 2건이며 구매자 유입이나 매출을 보장하지 않습니다.

Handsel Mandate — 브라우저 프로토타입 (원형)

아래는 402-LAB의 바탕이 된 온체인 위임 프로토타입 문서입니다. 현재 라이브 서비스에는 연결돼 있지 않습니다.

Seller Studio · 판매자용 초안

바이브 코딩으로 만든 도구의 상품 설명·호출 예제·가격을 정리하고, x402 연동 설정을 내보내는 로컬 스튜디오를 추가했습니다. node scripts/seller-studio.js 실행 후 http://127.0.0.1:4173을 여세요. 의존성 설치 없이 실행됩니다. 상품 미리보기·예산 제한 모의 구매·JSON 다운로드를 지원합니다. 실제 API 호출·결제·Bazaar 등록·공개 판매는 수행하지 않습니다. 범위와 다음 연동 단계.

사람이 예산·허용 도구·만료를 지정하고 브라우저 에이전트가 그 범위 안에서 모의 구매하는 Chrome MV3 확장 초안입니다.

v0.4: 온체인 제한 권한 + BlockFlow + x402. Coinbase Smart Account에 MandateValidator를 컨트랙트 소유자로 설치합니다. 사람이 승인한 총예산·건당 한도·수령인·만료·에이전트·BlockFlow 바인딩을 체인에 기록하고, 에이전트가 결제 금액을 먼저 예약한 경우에만 해당 EIP-3009 결제를 허용합니다. 메인넷은 차단됩니다.

새 Session 모드에는 소유자 키가 없으며 에이전트는 임의 전송·새 위임 발급을 할 수 없습니다. 회수가 체인에 확정되면 미결제 예약도 무효화됩니다. 영수증은 RPC의 USDC Transfer + AuthorizationUsed nonce와 대조합니다. 실제 Base Sepolia 배포·정산은 아직 실행하지 않았습니다. 설치·검증 범위를 확인하세요. 이전 full-owner 모드는 기존 설정에서만 남아 있으며 동일한 보안 보장을 제공하지 않습니다.

x402 서명은 예산 예약 전에 DAMBI 호환 사전 정책 게이트를 통과해야 합니다. 에이전트 실행에서는 allow / evaluated / enforcing 판정만 허용합니다.

설치

1. 이 저장소를 clone 또는 Download ZIP으로 받습니다.
2. Chrome chrome://extensions → 개발자 모드 → 압축해제된 확장 프로그램 로드 → extension/ 선택.
3. 도구 모음의 Handsel 아이콘을 누르면 사이드패널이 열립니다. 확장 옵션에서도 같은 화면을 열 수 있습니다.
4. 위임장의 목표·총예산·건당 한도·기간·허용 도구를 확인하고 활성화합니다.
5. 데모 에이전트 실행: 검색 0.03 + 문서 추출 0.05 모의 USDC를 사용하고 영수증을 남깁니다.
6. 총예산 0.05, 건당 0.05로 설정하면 검색 후 추출이 차단됩니다. 첫 호출은 남으며 작업 전체가 원자적이지 않습니다.

별도 에이전트 확장 연결

examples/agent-extension/도 압축해제 로드합니다. 그 확장 ID를 Handsel 연결란에 저장한 뒤 새 위임장을 활성화하세요. 데모 확장 팝업에 Handsel 확장 ID를 입력하면 extension-to-extension 메시지로 구매를 요청합니다.

지원 API: status, catalog, purchase (mandateId, requestId, serviceId). 응답은 {ok,result} 또는 {ok:false,error}입니다. 연결된 확장 하나만 접근 가능합니다. 연결 변경은 기존 위임을 회수합니다. 외부 에이전트는 위임 생성·연결 변경·권한 확대를 할 수 없습니다.

브라우저 내장 AI나 Aside류 제품에 자동 연결되는 것은 아닙니다. 해당 제품이 확장 메시지/API 연결을 지원해야 어댑터를 붙일 수 있습니다. 일반 웹페이지에 지출 API를 공개하지 않습니다.

테스트

Shortened. The full README is on GitHub.