Point One Percent — pop-pay

La capa de seguridad en tiempo de ejecución para el comercio con agentes de IA. Las credenciales de la tarjeta se inyectan directamente en el DOM del navegador a través de CDP; nunca entran en la ventana de contexto del agente. Un prompt alucinado no puede vaciar una billetera que no puede ver.

Primeros pasos

1. Inicializar la bóveda de credenciales

npx -y pop-pay pop-init-vault

Esto cifra las credenciales de tu tarjeta en ~/.config/pop-pay/vault.enc (AES-256-GCM). El servidor MCP se descifra automáticamente al iniciarse.

Para una protección más fuerte (recomendado: bloquea agentes con acceso a la shell):

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

2. Añadir a tu cliente MCP

Configuración estándar para cualquier cliente compatible con MCP:

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

Claude Code utiliza su propia CLI; la configuración JSON anterior no es necesaria.

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

--scope user lo hace disponible en todos los proyectos. Para eliminar: claude mcp remove pop-pay

Añade la configuración JSON anterior a:

• Cursor: ~/.cursor/mcp.json

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

• VS Code (Copilot): .vscode/mcp.json en la raíz del proyecto

OpenClaw utiliza su propia CLI; la configuración JSON anterior no es necesaria.

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

O añádelo a ~/.openclaw/mcp_servers.json usando la configuración JSON anterior.

Para plantillas de System Prompt y configuración del sandbox de NemoClaw, consulta Guía de integración §4.

docker-compose up -d

Ejecuta el servidor MCP + Chromium headless con CDP. Monta tu bóveda cifrada desde el host.

3. Iniciar Chrome con CDP y empezar a usar

npx -y pop-pay launch

Reinicia tu cliente MCP. El agente ahora tiene acceso a las herramientas MCP de pop-pay.

Related MCP server: Arbor

Herramientas MCP

Consejo para usuarios de Claude Code: Añade lo siguiente al CLAUDE.md de tu proyecto para ayudar al agente a saber cuándo llamar a pop-pay: "Cuando encuentres un formulario de pago o una página de pago, utiliza la herramienta request_virtual_card. Para formularios de información de facturación/contacto, utiliza primero request_purchaser_info."

Configuración

Variables principales en ~/.config/pop-pay/.env. Consulta ENV_REFERENCE.md para ver la lista completa.

Modo Guardrail

Para habilitar el modo LLM, consulta Guía de integración §1.

Proveedores

Prioridad: Stripe Issuing → BYOC Local → Mock.

Seguridad

Consulta THREAT_MODEL.md para ver el análisis STRIDE completo y COMPLIANCE_FAQ.md para detalles empresariales.

Arquitectura

• TypeScript — Servidor MCP, motor de inyección CDP, guardrails, CLI

• Rust (napi-rs) — Capa de seguridad nativa: almacenamiento de salt dividido por XOR, derivación de clave scrypt

• Node.js crypto — Cifrado de bóveda AES-256-GCM (enlace OpenSSL)

• Chrome DevTools Protocol — Inyección directa en el DOM a través de WebSocket sin procesar

Documentación

• Modelo de amenazas — Análisis STRIDE, 5 primitivas de seguridad, 10 escenarios de ataque

• Benchmark de Guardrail — 95% de precisión en 20 escenarios de prueba

• Preguntas frecuentes sobre cumplimiento — Detalles de PCI DSS, SOC 2, GDPR

• Referencia de entorno — Todas las variables de entorno POP_*

• Guía de integración — Configuración para Claude Code, SDK de Node.js y agentes de navegador

• Libro de recetas de categorías — Patrones y ejemplos de POP_ALLOWED_CATEGORIES

Licencia

MIT