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サーバーは起動時に自動的に復号します。

より強力な保護（推奨 — シェルアクセスを持つエージェントをブロックします）を行う場合：

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。

セキュリティ

完全なSTRIDE分析については THREAT_MODEL.md を、エンタープライズ向けの詳細については 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%の精度

• コンプライアンスFAQ — PCI DSS、SOC 2、GDPRの詳細

• 環境変数リファレンス — すべての POP_* 環境変数

• 統合ガイド — Claude Code、Node.js SDK、ブラウザエージェントの設定

• カテゴリクックブック — POP_ALLOWED_CATEGORIES のパターンと例

ライセンス

MIT