P2Flux

P2Flux MCP — 让你的 AI 助手为网络内容付费

有些网站会要求 AI 助手支付几分钱，才能阅读文章或使用其数据。这会在你自己的电脑上为助手提供一个小额钱包，让它替你向这些网站付款——金额绝不会超过你设定的限额。P2Flux 不会持有你的资金或密钥。

Claude Desktop（无需技术知识）

1. 下载 p2flux.mcpb，然后双击。Claude Desktop 会提示你安装。
2. 在表单中，首次使用时将 Money 保持为 test，并设置限额（默认值：每页 0.50 USDC，每天 5 USDC）。
3. 对 Claude 说：“Set up my P2Flux wallet.” Claude 会显示钱包地址以及如何充值。
   • 测试：从 https://faucet.circle.com 获取免费的测试资金（选择 Base Sepolia）。
   • 真实资金：在 Coinbase 应用中选择 Send → USDC → Base network，然后粘贴地址。发送少量资金。请像对待口袋里的现金一样谨慎保管。
4. 开始使用：“Find articles about soup recipes I can buy”、“Read this page: https://…”、“How much have I spent?”

如果电脑丢失，存放在电脑上的钱包也会丢失。请只存放少量资金。

Claude Code、Cursor 和其他 MCP 客户端

claude mcp add p2flux -e P2FLUX_NETWORK=test -- npx -y @p2flux/mcp
# real USDC on Base:
claude mcp add p2flux -e P2FLUX_NETWORK=live -- npx -y @p2flux/mcp

变量	默认值	含义
P2FLUX_NETWORK	test	test = Base Sepolia，live = 使用真实 USDC 的 Base
P2FLUX_MAX_PER_PAYMENT	0.50	单页最高金额
P2FLUX_MAX_PER_DAY	5	24 小时内最高金额
P2FLUX_MAX_PREPAID	1	在单个网站预付的最高金额；0 = 每页单独付款
P2FLUX_MAX_CONFIRMED	1000	在对话框中确认的单笔付款最高金额（见下文）
P2FLUX_MCP_DIR	~/.p2flux-mcp	钱包、消费记录和访问令牌的存放位置
P2FLUX_API_URL	P2Flux API of the network	其他 P2Flux API（https，或 http://localhost）
P2FLUX_RPC_URL	public Base RPC	你自己的 Base RPC（https，或 http://localhost）

P2FLUX_MAX_CONFIRMED、P2FLUX_API_URL 和 P2FLUX_RPC_URL 只能通过环境变量设置。Claude Desktop 表单中不会显示这些变量。

网站为订阅提供的访问令牌会按网站分别保存在 P2FLUX_MCP_DIR 中的 access.json 里，直到令牌过期。删除该文件即可清除所有令牌。

已在 MCP Registry 中登记，名称为 io.github.P2Flux/mcp，也已上线 Smithery 和 Glama。

能做什么，不能做什么

• 仅为使用 HTTP 402（x402 标准）请求付费的页面支付 USDC（Base）。仅此而已。
• 签名前会先根据你的限额检查价格，并且只签署该价格。如果网站在检查和付款之间更改价格，它就收不到款。
• 在你的电脑上保留消费记录；每日限额在重启后仍然有效。
• 预留在某个网站但未使用的资金，可以在你提出请求时退回（“取回我在该网站未用完的余额”）；前提是其中已使用了 0.10 USDC，或已闲置一天。如果金额达到 0.50 USDC 或以上，闲置一周后也会自动退回。
• 你的限额就是预算：在预算内（默认每笔 0.50 USDC，每日 5 USDC）会自动付款。超出预算时，应用会在对话框中询问你本人——助手无法代为回答——并显示金额、网站以及网站声称出售的内容；除非你确认，否则不会付款，且绝不会超过 P2FLUX_MAX_CONFIRMED（默认 1000 USDC）。无法显示此类对话框的应用会拒绝付款。
• 有些网站出售的是一段期限内的访问权限，而不是单个页面，例如按人们愿意支付的价格购买 30 天的荐股服务订阅。网站会返回一个访问令牌，该令牌仅针对该网站保存在你的电脑上，并会发送回该网站，因此在令牌过期前，你之后在该网站阅读页面都无需付款。check_price 会显示网站声称付款可购买的内容。
• 密钥只保存在一个只有你能读取的文件中。密钥绝不会发送到任何地方，也没有任何工具可以泄露密钥——因此，助手在网上读取的内容无法诱骗它交出密钥。若要将钱包迁移到其他位置，请自行在终端中运行 npx -p @p2flux/mcp p2flux-mcp export-key。
• ChatGPT 和 claude.ai 网站无法在你的电脑上运行程序。它们可以使用下方的远程服务：钱包不会保存在任何地方；你需要在自己的浏览器钱包中批准每笔付款。

开发

npm install && npm test          # unit tests
npm run build
node test/live.mjs               # live on Base Sepolia (see the file)
npx @anthropic-ai/mcpb pack . p2flux.mcpb

ChatGPT 和 claude.ai（远程服务）

p2flux-mcp-remote 为只能连接互联网服务器的助手提供相同功能。它不持有钱包、余额或历史记录，也无需登录。工具：find_paid_content、check_price、request_paid_page、get_paid_page。

托管服务

P2Flux 运行此服务。将其添加为 claude.ai 或 ChatGPT（开发者模式）中的自定义连接器，身份验证：无。

• Base 上的真实 USDC：https://agent.p2flux.com/mcp
• Base Sepolia 上的测试资金：https://agent-test.p2flux.com/mcp

每笔付款都由你在自己的浏览器钱包中批准。服务绝不会持有你的资金或密钥。

工作原理

1. 助手请求付费页面。它会获取一个链接并显示给你。
2. 你打开链接。页面会显示金额、页面和卖家地址。你在自己的钱包（Coinbase Wallet、MetaMask……）中批准：针对确切金额的一次签名，无网络费用。
3. 页面会立即完成付款并获取；助手随后读取页面内容。

仅能为通过 P2Flux 付费的网站付款，且仅限使用 Base 上的 USDC；金额绝不会超过 P2FLUX_REMOTE_MAX_PRICE（默认 1000 USDC）。对于超过 P2FLUX_REMOTE_CONFIRM_ABOVE（默认 5 USDC）的付款——例如订阅——会向用户询问两次：助手必须先询问用户并将其预算作为 max_price 传入；批准页面会显示金额和网站声称出售的内容，并要求勾选复选框后才会打开钱包。P2FLUX_REMOTE_SECRET（32 个或更多字符）用于跨重启将访问令牌绑定到其对应网站。服务只读取公开的 HTTPS 网站。

运行自己的实例

P2FLUX_PUBLIC_URL=https://agent.example.com P2FLUX_NETWORK=test PORT=8787 npx -p @p2flux/mcp p2flux-mcp-remote

将其置于 https（nginx）后面，并设置 P2FLUX_TRUST_PROXY=1，然后在 claude.ai 或 ChatGPT（开发者模式）中添加 https://agent.example.com/mcp 作为自定义连接器，身份验证：无。

变量	默认值	含义
P2FLUX_PUBLIC_URL	（必填）	此服务可访问的 https 地址
P2FLUX_NETWORK	test	test = Base Sepolia，live = 使用真实 USDC 的 Base
P2FLUX_REMOTE_MAX_PRICE	1000	单笔付款的最高金额
P2FLUX_REMOTE_CONFIRM_ABOVE	5	超过此金额时，用户会被询问两次
P2FLUX_REMOTE_SECRET	（每次启动时随机生成）	至少 32 个字符；用于在重启后保持访问令牌有效
P2FLUX_TRUST_PROXY	关闭	位于 nginx 后面时设为 1：客户端地址取自 X-Forwarded-For
P2FLUX_REMOTE_ALLOW_LOCAL	关闭	设为 1 后，服务可读取 http://localhost 页面；仅限测试资金
P2FLUX_API_URL	对应网络的 P2Flux API	另一个 P2Flux API
P2FLUX_RPC_URL	公共 Base RPC	你自己的 Base RPC
HOST、PORT	127.0.0.1、8787	监听地址

当前限制：需要浏览器钱包扩展（暂不支持 WalletConnect / 手机钱包）；每个页面需单独批准一次（没有预付余额）。