Point One Percent — pop-pay

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

Установка

Выберите предпочтительный метод:

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

Все пути установки предоставляют бинарные файлы CLI: pop-launch, pop-init-vault, pop-unlock и pop-pay (запуск панели управления).

Используете 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. Запуск Chrome с удаленной отладкой CDP

pop-launch

Открывает экземпляр Chromium на http://localhost:9222, в который pop-pay внедряет учетные данные. Ваш агент (через MCP, автоматизацию браузера или x402) затем управляет процессом оформления заказа — данные карты никогда не покидают процесс браузера.

3. Открытие панели мониторинга (опционально)

pop-pay

Просмотр активности платежей агента, использования бюджета и журналов отклонений в реальном времени.

4. Подключение к вашему агенту

Поддерживаются два пути интеграции:

• MCP-сервер — добавьте pop-pay к любому MCP-совместимому клиенту (Claude Code, OpenClaw). См. 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-сервер + headless Chromium с CDP. Подключите ваше зашифрованное хранилище с хоста. См. docker-compose.yml для настройки.

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

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

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

Режим барьера (Guardrail)

Чтобы включить режим 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")

См. Руководство по интеграции §2 для получения полной справки по SDK и провайдерам.

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

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

Архитектура

• Python — Основной движок, MCP-сервер, логика барьеров, CLI

• Cython — Критически важные для производительности операции с хранилищем и защита памяти

• Chrome DevTools Protocol — Прямое внедрение в DOM через WebSocket

• SQLite — Локальный аудит транзакций и управление состоянием

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

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

• Бенчмарк барьеров — Кросс-модельная оценка (Anthropic / OpenAI / Gemini) по 585 полезным нагрузкам, 11 категорий атак

• FAQ по соответствию — Детали PCI DSS, SOC 2, GDPR

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

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

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

Лицензия

MIT