Point One Percent — pop-pay

Die Laufzeit-Sicherheitsebene für den Handel mit KI-Agenten. Kartendaten werden direkt über CDP in das Browser-DOM injiziert – sie gelangen niemals in das Kontextfenster des Agenten. Ein halluzinierter Prompt kann keinen Geldbeutel leeren, den er nicht sehen kann.

Erste Schritte

1. Initialisieren Sie den Credential-Tresor

npx -y pop-pay pop-init-vault

Dies verschlüsselt Ihre Kartendaten in ~/.config/pop-pay/vault.enc (AES-256-GCM). Der MCP-Server entschlüsselt diese automatisch beim Start.

Für stärkeren Schutz (empfohlen – blockiert Agenten mit Shell-Zugriff):

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

2. Zum MCP-Client hinzufügen

Standardkonfiguration für jeden MCP-kompatiblen Client:

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

Claude Code verwendet seine eigene CLI – die obige JSON-Konfiguration ist nicht erforderlich.

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

--scope user macht es für alle Projekte verfügbar. Zum Entfernen: claude mcp remove pop-pay

Fügen Sie die obige JSON-Konfiguration hinzu zu:

• Cursor: ~/.cursor/mcp.json

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

• VS Code (Copilot): .vscode/mcp.json im Projektstammverzeichnis

OpenClaw verwendet seine eigene CLI – die obige JSON-Konfiguration ist nicht erforderlich.

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

Oder fügen Sie sie zu ~/.openclaw/mcp_servers.json unter Verwendung der obigen JSON-Konfiguration hinzu.

Für System-Prompt-Vorlagen und die NemoClaw-Sandbox-Einrichtung siehe Integrationsleitfaden §4.

docker-compose up -d

Führt den MCP-Server + Headless Chromium mit CDP aus. Binden Sie Ihren verschlüsselten Tresor vom Host ein.

3. Starten Sie Chrome mit CDP und beginnen Sie mit der Nutzung

npx -y pop-pay launch

Starten Sie Ihren MCP-Client neu. Der Agent hat nun Zugriff auf die MCP-Tools von pop-pay.

Related MCP server: Arbor

MCP-Tools

Tipp für Claude Code-Benutzer: Fügen Sie Folgendes zur CLAUDE.md Ihres Projekts hinzu, damit der Agent weiß, wann er pop-pay aufrufen soll: "Wenn Sie auf ein Zahlungsformular oder eine Checkout-Seite stoßen, verwenden Sie das Tool request_virtual_card. Für Formulare mit Rechnungs-/Kontaktinformationen verwenden Sie zuerst request_purchaser_info."

Konfiguration

Kernvariablen in ~/.config/pop-pay/.env. Siehe ENV_REFERENCE.md für die vollständige Liste.

Guardrail-Modus

Um den LLM-Modus zu aktivieren, siehe Integrationsleitfaden §1.

Anbieter

Priorität: Stripe Issuing → BYOC Local → Mock.

Sicherheit

Siehe THREAT_MODEL.md für die vollständige STRIDE-Analyse und COMPLIANCE_FAQ.md für Unternehmensdetails.

Architektur

• TypeScript — MCP-Server, CDP-Injektions-Engine, Guardrails, CLI

• Rust (napi-rs) — Native Sicherheitsebene: XOR-geteilte Salt-Speicherung, scrypt-Schlüsselableitung

• Node.js crypto — AES-256-GCM Tresorverschlüsselung (OpenSSL-Bindung)

• Chrome DevTools Protocol — Direkte DOM-Injektion über rohes WebSocket

Dokumentation

• Bedrohungsmodell — STRIDE-Analyse, 5 Sicherheitsprimitive, 10 Angriffsszenarien

• Guardrail-Benchmark — 95% Genauigkeit über 20 Testszenarien

• Compliance-FAQ — PCI DSS, SOC 2, DSGVO-Details

• Umgebungsreferenz — Alle POP_*-Umgebungsvariablen

• Integrationsleitfaden — Einrichtung für Claude Code, Node.js SDK und Browser-Agenten

• Categories Cookbook — POP_ALLOWED_CATEGORIES-Muster und Beispiele

Lizenz

MIT