Point One Percent — pop-pay

AI 에이전트 커머스를 위한 런타임 보안 계층입니다. 카드 자격 증명은 CDP를 통해 브라우저 DOM에 직접 주입되며, 에이전트의 컨텍스트 윈도우에는 절대 들어가지 않습니다. 환각에 빠진 프롬프트는 볼 수 없는 지갑을 털 수 없습니다.

시작하기

1. 자격 증명 볼트 초기화

npx -y pop-pay pop-init-vault

이 명령은 카드 자격 증명을 ~/.config/pop-pay/vault.enc (AES-256-GCM)로 암호화합니다. MCP 서버는 시작 시 자동으로 복호화합니다.

더 강력한 보호를 원하신다면 (권장 — 셸 접근 권한이 있는 에이전트 차단):

npx -y pop-pay pop-init-vault --passphrase   # one-time setup
npx -y pop-pay pop-unlock                     # run once before each session

2. MCP 클라이언트에 추가

MCP 호환 클라이언트를 위한 표준 설정:

{
  "mcpServers": {
    "pop-pay": {
      "command": "npx",
      "args": ["-y", "pop-pay", "launch-mcp"],
      "env": {
        "POP_CDP_URL": "http://localhost:9222"
      }
    }
  }
}

Claude Code는 자체 CLI를 사용하므로 위의 JSON 설정이 필요하지 않습니다.

claude mcp add --scope user pop-pay -- npx -y pop-pay launch-mcp

--scope user를 사용하면 모든 프로젝트에서 사용할 수 있습니다. 제거하려면: claude mcp remove pop-pay

위의 JSON 설정을 다음 위치에 추가하세요:

• Cursor: ~/.cursor/mcp.json

• Windsurf: ~/.codeium/windsurf/mcp_config.json

• VS Code (Copilot): 프로젝트 루트의 .vscode/mcp.json

OpenClaw는 자체 CLI를 사용하므로 위의 JSON 설정이 필요하지 않습니다.

openclaw mcp add pop-pay -- npx -y pop-pay launch-mcp

또는 위의 JSON 설정을 사용하여 ~/.openclaw/mcp_servers.json에 추가하세요.

시스템 프롬프트 템플릿 및 NemoClaw 샌드박스 설정은 통합 가이드 §4를 참조하세요.

docker-compose up -d

MCP 서버와 CDP가 포함된 헤드리스 Chromium을 실행합니다. 호스트에서 암호화된 볼트를 마운트하세요.

3. CDP와 함께 Chrome 실행 및 사용 시작

npx -y pop-pay launch

MCP 클라이언트를 재시작하세요. 이제 에이전트가 pop-pay의 MCP 도구에 접근할 수 있습니다.

Related MCP server: Arbor

MCP 도구

Claude Code 사용자를 위한 팁: 에이전트가 pop-pay를 호출해야 할 때를 알 수 있도록 프로젝트의 CLAUDE.md에 다음을 추가하세요: "결제 폼이나 체크아웃 페이지를 만나면 request_virtual_card 도구를 사용하세요. 청구/연락처 정보 폼의 경우, 먼저 request_purchaser_info를 사용하세요."

설정

~/.config/pop-pay/.env의 핵심 변수입니다. 전체 목록은 ENV_REFERENCE.md를 참조하세요.

가드레일 모드

LLM 모드를 활성화하려면 통합 가이드 §1을 참조하세요.

제공자

우선순위: Stripe Issuing → BYOC Local → Mock.

보안

전체 STRIDE 분석은 THREAT_MODEL.md를, 기업용 세부 정보는 COMPLIANCE_FAQ.md를 참조하세요.

아키텍처

• TypeScript — MCP 서버, CDP 주입 엔진, 가드레일, CLI

• Rust (napi-rs) — 네이티브 보안 계층: XOR 분할 솔트 저장, scrypt 키 파생

• Node.js crypto — AES-256-GCM 볼트 암호화 (OpenSSL 바인딩)

• Chrome DevTools Protocol — 원시 WebSocket을 통한 직접 DOM 주입

문서

• 위협 모델 — STRIDE 분석, 5가지 보안 기본 요소, 10가지 공격 시나리오

• 가드레일 벤치마크 — 20개 테스트 시나리오에서 95% 정확도

• 규정 준수 FAQ — PCI DSS, SOC 2, GDPR 세부 정보

• 환경 변수 참조 — 모든 POP_* 환경 변수

• 통합 가이드 — Claude Code, Node.js SDK 및 브라우저 에이전트 설정

• 카테고리 쿡북 — POP_ALLOWED_CATEGORIES 패턴 및 예시

라이선스

MIT