P2Flux

P2Flux MCP — AI アシスタントがウェブコンテンツの料金を支払えるようにします

一部のウェブサイトでは、記事を読んだりデータを利用したりするために、AI アシスタントに数セントの支払いを求めます。このツールを使うと、お使いのコンピューター上にアシスタント用の小さなウォレットを用意し、設定した上限を超えない範囲で、サイトへの支払いを代行できます。P2Flux が資金や鍵を預かることはありません。

Claude Desktop（技術的な知識は不要です）

1. p2flux.mcpb をダウンロードしてダブルクリックします。Claude Desktop からインストールを求められます。
2. フォームでは、初回は Money を test のままにし、上限を設定します （デフォルト：1ページあたり 0.50 USDC、1日あたり 5 USDC）。
3. Claude に「P2Flux ウォレットを設定して」と頼みます。ウォレットのアドレスと入金方法が表示されます。
   • テスト用：https://faucet.circle.com から無料のテスト資金を受け取ります（Base Sepolia を選択してください）。
   • 実際の資金：Coinbase アプリで Send → USDC → Base network を選び、アドレスを貼り付けます。 少額を送金してください。ポケットに入れた現金と同じように扱ってください。
4. 使ってみましょう：「購入できるスープのレシピ記事を探して」「このページを読んで：https://…」「いくら使った？」と頼みます。

コンピューターを紛失すると、そこにあるウォレットも失われます。少額だけを入れてください。

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	1ページに支払う上限
P2FLUX_MAX_PER_DAY	5	24時間以内に支払う上限
P2FLUX_MAX_PREPAID	1	1つのサイトに前払いする上限。0 = ページごとに支払う
P2FLUX_MAX_CONFIRMED	1000	ダイアログで確認する1回の支払いの上限（下記参照）
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 標準）で支払いを求めるページに対し、Base 上で USDC を支払います。それ以外は何もしません。
• 署名する前に価格を上限と照合し、その価格どおりに署名します。確認から支払いまでの間に価格を変更したサイトには、何も支払いません。
• 支出記録をお使いのコンピューターに保存します。1 日あたりの上限は、再起動後も維持されます。
• サイトに預けたお金を使わなかった場合は、使用済みの金額が 0.10 USDC に達した後、または 1 日間使用がなかった後に、リクエストすれば返金されます（「そのサイトで使わなかった残高を返して」）。また、0.50 USDC 以上の場合は、1 週間使用がなければ自動的に返金されます。
• 上限は予算として機能します。予算内（デフォルトでは 1 回の支払いにつき 0.50 USDC、1 日につき 5 USDC）なら、支払いは自動的に行われます。予算を超える場合は、アプリが金額、サイト、およびサイトが販売すると説明している内容をダイアログで表示し、あなたに確認を求めます。アシスタントは回答できません。あなたが確認しない限り支払いは行われず、P2FLUX_MAX_CONFIRMED（デフォルトは 1000 USDC）を超える支払いは決して行いません。このようなダイアログを表示できないアプリは、支払いを拒否します。
• サイトによっては、1 ページではなく一定期間を販売します。たとえば、チップスを提供する人の 30 日間のサブスクリプションを、利用者が支払う価格で購入できます。サイトはアクセストークンを返し、そのサイト専用にお使いのコンピューターに保存されて、サイトに返送されます。そのため、有効期限までは、そのサイトの後続ページを支払いなしで閲覧できます。check_price には、支払いで何が得られるとサイトが説明しているかが表示されます。
• キーは、あなた以外には読み取れない 1 つのファイルに保存されます。キーが外部に送信されることはなく、どのツールもキーを開示できません。そのため、アシスタントがウェブ上で読んだ内容によって、キーを渡すようそそのかされることもありません。ウォレットを別の場所に移すには、ターミナルで自分で 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…）で承認してください。正確な金額に対する署名は 1 回だけで、ネットワーク手数料はかかりません。
3. ページの支払いが行われ、すぐに取得されます。その後、アシスタントがページを読み取ります。

P2Flux 経由で支払えるのは、P2Flux 経由で支払われるサイトだけです。支払いは Base 上の USDC に限られ、P2FLUX_REMOTE_MAX_PRICE（デフォルトは 1000 USDC）を超えることはありません。P2FLUX_REMOTE_CONFIRM_ABOVE（デフォルトは 5 USDC）を超える場合（たとえばサブスクリプション）は、利用者に 2 回確認を求めます。まずアシスタントが利用者に確認し、予算を 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

P2FLUX_TRUST_PROXY=1 を設定して https（nginx）の背後で実行し、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	1 回の支払いの上限
P2FLUX_REMOTE_CONFIRM_ABOVE	5	この金額を超えると、ユーザーに 2 回確認を求めます
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 とスマートフォンウォレットにはまだ対応していません）。ページごとに承認が 1 回必要です（プリペイド残高はありません）。