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 服务器会在启动时自动解密。

为了获得更强的保护（推荐——可阻止具有 shell 访问权限的智能体）：

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 用户提示： 将以下内容添加到您项目的 CLAUDE.md 中，以帮助智能体知道何时调用 pop-pay： “当你遇到支付表单或结账页面时，请使用 request_virtual_card 工具。对于账单/联系信息表单，请先使用 request_purchaser_info。”

配置

~/.config/pop-pay/.env 中的核心变量。请参阅 ENV_REFERENCE.md 获取完整列表。

防护栏模式

要启用 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 — 通过原始 WebSocket 进行直接 DOM 注入

文档

• 威胁模型 — STRIDE 分析、5 个安全原语、10 个攻击场景

• 防护栏基准测试 — 20 个测试场景中 95% 的准确率

• 合规性常见问题解答 — PCI DSS、SOC 2、GDPR 详细信息

• 环境变量参考 — 所有 POP_* 环境变量

• 集成指南 — Claude Code、Node.js SDK 和浏览器智能体的设置

• 类别手册 — POP_ALLOWED_CATEGORIES 模式和示例

许可证

MIT