Perly Pay

perly-pay-mcp

AI コーディングアシスタントから、暗号資産で仕事の対価を受け取りましょう。perly-pay-mcp は、Perly Pay 用のローカルな MCP サーバーです。アシスタントは、商品、価格、決済リンク、請求書を作成し、テストモードで決済し、支払いと領収書を読み取り、購入者のアクセス権を確認できます。Bitcoin、USDC、USDT は直接お客様のウォレットに届きます。Perly Pay が預かることはありません。決済あたりの手数料は 2.5¢ で、決済額の 0.5% を超えることはありません。また、月 21 件までの決済は無料です。

お使いのマシンで stdio 経由で動作し、お客様のキーを使って Perly Pay の公開 API とのみ通信します。その間に当社のサーバーが介在することはありません。

セットアップ

Perly Pay でテストキーを取得します：Dashboard → Developers → API keys（sk_test_…）。

Claude Code

claude mcp add perly-pay --env PERLY_PAY_SECRET_KEY=sk_test_… -- npx -y perly-pay-mcp

Cursor：~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json

{
  "mcpServers": {
    "perly-pay": {
      "command": "npx",
      "args": ["-y", "perly-pay-mcp"],
      "env": { "PERLY_PAY_SECRET_KEY": "sk_test_…" }
    }
  }
}

Codex：~/.codex/config.toml

[mcp_servers.perly-pay]
command = "npx"
args = ["-y", "perly-pay-mcp"]
env = { PERLY_PAY_SECRET_KEY = "sk_test_…" }

キーを git に含めないでください。プロジェクト内の設定ファイルはコミットされることがよくあります。Node 20 以降が必要です。

変数
PERLY_PAY_SECRET_KEY	構築中は sk_test_… を使用します。sk_live_… は読み取り専用です（下記参照）。
PERLY_PAY_API	デフォルトは https://pay.perly.io です。perly.io ホスト、またはこのマシンを指定します。平文の http は localhost に限り使用できます。
PERLY_PAY_ALLOW_ANY_API	自分で実行するコピー用に、PERLY_PAY_API で指定した他の任意の https ホストへキーを送信する場合は 1 を設定します。
PERLY_PAY_WEBHOOK_SECRET	任意の whsec_…。verify_webhook_signature のデフォルト値です。

試してみる

決済リンクを使って、1 時間 49 ドルのコンサルティングを販売し、テストモードで決済して、支払い内容を表示してください。

アシスタントは create_product、create_price、create_payment_link、simulate_payment、list_payments を呼び出します。

ツール

分野	ツール
商品と価格	create_product、list_products、update_product、create_price、list_prices、update_price
決済リンク	create_payment_link、list_payment_links、update_payment_link
請求書とチェックアウト	create_invoice、list_invoices、retrieve_invoice、cancel_invoice、create_checkout_session、retrieve_checkout_session
顧客	create_customer、list_customers、retrieve_customer
サブスクリプション（請求書で更新）	create_subscription、list_subscriptions、retrieve_subscription
アクセス権とクレジット	check_entitlement、list_entitlements、consume_entitlement_credits、list_credit_usage
入金、読み取り専用	list_payments、retrieve_payment、list_receipts、retrieve_receipt、list_events
返金	create_refund、list_refunds
Webhook	create_webhook_endpoint、list_webhook_endpoints、delete_webhook_endpoint
テストモード	simulate_payment：請求書を決済するか、決済リンクから購入して決済します
お使いのマシン上	verify_webhook_signature は Perly-Signature を検証します。pay_links は、お客様だけが使用できるダッシュボードページ（プラン、ウォレット、本番稼働、二要素認証、キー）を表示します

ツールは Perly Pay の OpenAPI ドキュメントから生成されるため、引数は API 独自のものです。

対応しないこと

• 有効なキーでは、読み取りのみを行います。 書き込みを行うツールはすべて拒否されます。 請求書、チェックアウトセッション、商品、価格、顧客、決済リンク、サブスクリプションの作成、キャンセル、編集、返金、クレジットの使用、 シミュレーション決済、Webhook エンドポイントの操作が対象です。拒否する理由を説明しますので、ダッシュボードまたはアプリ独自のコードで実行してください。リスト表示と検索はテスト環境と同様に機能します。 理由：購入者が入力したテキストがアシスタントに届く可能性があり、サーバーが受け取る情報だけでは、モデルではなくあなたが有効な変更を承認したことを証明できないためです （confirm: true はモデルが記述します。クライアントの承認プロンプトへの回答も、MCP のエリシテーションへの回答も、クライアントを経由して戻ってきます）。そのため、サーバーが有効なキーで書き込みを行うことはありません。
• ウォレット、API キー、請求、有効モード、2 要素認証には、ツールがありません。 これらはダッシュボードで設定してください。各ページは pay_links から開けます。
• 取り消せない操作（請求書のキャンセル、返金処理の開始、Webhook エンドポイントの削除）には、confirm: true が必要です。アシスタントは、あなたに確認してから送信してください。
• 秘密鍵が回答やログに再掲されることはありません。
• 購入者のライセンスキーがアシスタントに届くことはありません。 キーを含むイベントは、key を除いて返されます。ライセンスキーはダッシュボードに保管されます。
• 他者が記述したテキストはデータとして明示されます。 顧客名、メールアドレス、説明、メタデータには、購入者や決済リンクを開いた人が入力した内容が含まれる場合があります。すべての API 応答には、それらに従わないようアシスタントに伝える注記が付いています。 それでも、承認する前に、ツールが変更しようとしている内容を確認してください。

ドキュメント：https://pay.perly.io/docs/mcp。API リファレンス： https://pay.perly.io/docs/api。MIT ライセンス。