Point One Percent — pop-pay

Уровень безопасности времени выполнения для коммерции с использованием ИИ-агентов. Данные карты внедряются непосредственно в DOM браузера через CDP — они никогда не попадают в контекстное окно агента. Одна галлюцинация не сможет опустошить кошелек, который она не видит.

Начало работы

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

Или добавьте в ~/.openclaw/mcp_servers.json, используя JSON-конфигурацию выше.

Информацию о шаблонах системных промптов и настройке песочницы NemoClaw см. в Руководстве по интеграции §4.

docker-compose up -d

Запускает MCP-сервер + headless Chromium с CDP. Подключите ваше зашифрованное хранилище с хоста.

3. Запустите Chrome с CDP и начните использовать

npx -y pop-pay launch

Перезапустите ваш MCP-клиент. Теперь у агента есть доступ к инструментам MCP pop-pay.

Related MCP server: Arbor

Инструменты MCP

Совет для пользователей Claude Code: Добавьте следующее в CLAUDE.md вашего проекта, чтобы помочь агенту понять, когда вызывать pop-pay: "Когда вы сталкиваетесь с платежной формой или страницей оформления заказа, используйте инструмент request_virtual_card. Для форм с платежной/контактной информацией сначала используйте request_purchaser_info."

Конфигурация

Основные переменные находятся в ~/.config/pop-pay/.env. Полный список см. в ENV_REFERENCE.md.

Режим защитных барьеров (Guardrail Mode)

Чтобы включить режим LLM, см. Руководство по интеграции §1.

Провайдеры

Приоритет: Stripe Issuing → BYOC Local → Mock.

Безопасность

См. THREAT_MODEL.md для полного анализа STRIDE и COMPLIANCE_FAQ.md для корпоративных деталей.

Архитектура

• TypeScript — MCP-сервер, движок CDP-инъекции, защитные барьеры, CLI

• Rust (napi-rs) — Нативный уровень безопасности: хранение XOR-разделенной соли, вывод ключа scrypt

• Node.js crypto — Шифрование хранилища AES-256-GCM (привязка OpenSSL)

• Chrome DevTools Protocol — Прямая инъекция в DOM через WebSocket

Документация

• Модель угроз — Анализ STRIDE, 5 примитивов безопасности, 10 сценариев атак

• Бенчмарк защитных барьеров — 95% точность в 20 тестовых сценариях

• FAQ по комплаенсу — Детали PCI DSS, SOC 2, GDPR

• Справочник окружения — Все переменные окружения POP_*

• Руководство по интеграции — Настройка для Claude Code, Node.js SDK и браузерных агентов

• Книга рецептов категорий — Шаблоны и примеры POP_ALLOWED_CATEGORIES

Лицензия

MIT