Point One Percent — pop-pay

AI 에이전트 상거래를 위한 런타임 보안 계층입니다. 드롭인 CLI + MCP 서버를 제공합니다. 카드 자격 증명은 CDP를 통해 브라우저 DOM에 직접 주입되므로 에이전트의 컨텍스트 창에 절대 들어가지 않습니다. 환각이 발생한 프롬프트는 볼 수 없는 지갑을 털 수 없습니다.

설치

원하는 방법을 선택하세요:

pipx install "pop-pay[mcp]"

pip install "pop-pay[mcp]"

uv tool install "pop-pay[mcp]"

pip install "pop-pay"                  # core (keyword guardrail + mock provider)
pip install "pop-pay[mcp,browser]"     # CDP injection (browser automation)
pip install "pop-pay[mcp,llm]"         # LLM guardrails (OpenAI, Ollama, vLLM, OpenRouter)
pip install "pop-pay[stripe]"          # Stripe virtual card issuing
pip install "pop-pay[langchain]"       # LangChain integration
pip install "pop-pay[all]"             # everything

모든 설치 경로는 pop-launch, pop-init-vault, pop-unlock, pop-pay (대시보드 런처) CLI 바이너리를 노출합니다.

Node.js / JavaScript를 사용하시나요? pop-pay (npm)을 확인하세요 — npm i -g pop-pay 또는 brew install 100xpercent/tap/pop-pay. 동일한 보안 모델, 동일한 볼트 형식, 독립적인 릴리스 주기를 가지며 런타임 간 전환이 안전합니다.

Related MCP server: 🍋 LemonCake — Billing & budgets for AI agents

빠른 시작 (CLI)

1. 암호화된 자격 증명 볼트 초기화

pop-init-vault

이 명령은 카드 자격 증명을 ~/.config/pop-pay/vault.enc (AES-256-GCM)로 암호화합니다. 더 강력한 보호를 원하시면(셸 접근 권한이 있는 에이전트 차단):

pop-init-vault --passphrase   # one-time setup
pop-unlock                     # run once per session

2. CDP 원격 디버깅으로 Chrome 실행

pop-launch

http://localhost:9222에서 Chromium 인스턴스를 열고 pop-pay가 자격 증명을 주입합니다. 에이전트(MCP, 브라우저 자동화 또는 x402를 통해)가 결제 흐름을 주도하며, 카드 정보는 브라우저 프로세스를 벗어나지 않습니다.

3. 모니터링 대시보드 열기 (선택 사항)

pop-pay

에이전트 결제 활동, 예산 사용량 및 거부 로그를 실시간으로 확인합니다.

4. 에이전트에 연결

두 가지 통합 경로를 지원합니다:

• MCP 서버 — 모든 MCP 호환 클라이언트(Claude Code, OpenClaw)에 pop-pay를 추가합니다. 아래 MCP 서버를 참조하세요.

• Python SDK / LangChain — 아래 Python SDK를 참조하세요.

MCP 서버 (선택 사항)

MCP 서버는 Python 모듈로 호출되며 시작 시 볼트를 복호화합니다.

MCP 클라이언트에 추가

{
  "mcpServers": {
    "pop-pay": {
      "command": "python3",
      "args": ["-m", "pop_pay.mcp_server"],
      "env": {
        "POP_CDP_URL": "http://localhost:9222"
      }
    }
  }
}

claude mcp add pop-pay -- python3 -m pop_pay.mcp_server

환경 변수 사용:

claude mcp add pop-pay \
  -e POP_CDP_URL=http://localhost:9222 \
  -e POP_ALLOWED_CATEGORIES='["aws","cloudflare"]' \
  -e POP_MAX_PER_TX=100.0 \
  -e POP_MAX_DAILY=500.0 \
  -e POP_GUARDRAIL_ENGINE=keyword \
  -- python3 -m pop_pay.mcp_server

모든 MCP 호스트와 호환됩니다. 설정 지침 및 시스템 프롬프트 템플릿은 통합 가이드를 참조하세요.

docker-compose up -d

MCP 서버와 CDP가 포함된 헤드리스 Chromium을 실행합니다. 호스트에서 암호화된 볼트를 마운트하세요. 구성은 docker-compose.yml을 참조하세요.

MCP 도구

구성

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

가드레일 모드

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

공급자

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

Python SDK

pop-pay를 사용자 지정 Python 또는 LangChain 워크플로우에 통합하세요:

from pop_pay.client import PopClient
from pop_pay.providers.stripe_mock import MockStripeProvider
from pop_pay.core.models import GuardrailPolicy

client = PopClient(
    provider=MockStripeProvider(),
    policy=GuardrailPolicy(
        allowed_categories=["API", "Cloud"],
        max_amount_per_tx=50.0,
        max_daily_budget=200.0,
    ),
)

# LangChain integration
from pop_pay.tools.langchain import PopPaymentTool
tool = PopPaymentTool(client=client, agent_id="agent-01")

전체 SDK 및 공급자 참조는 통합 가이드 §2를 참조하세요.

보안

전체 STRIDE 분석은 THREAT_MODEL.md를, 엔터프라이즈 세부 정보는 COMPLIANCE_FAQ.md를 참조하세요.

아키텍처

• Python — 핵심 엔진, MCP 서버, 가드레일 로직, CLI

• Cython — 성능이 중요한 볼트 작업 및 메모리 보호

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

• SQLite — 로컬 거래 감사 및 상태 관리

문서

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

• 가드레일 벤치마크 — 585개 페이로드, 11개 공격 카테고리에 대한 교차 모델 평가(Anthropic / OpenAI / Gemini)

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

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

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

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

라이선스

MIT