CigalPay

CigalPay MCP サーバー

Claude、Cursor、VS Code などの AI アシスタントから CigalPay アカウントを利用できます。自然な言葉で依頼するだけで、暗号資産の支払いリンクの作成、支払いの着金確認、返金状況の確認ができます。

「請求書 1042、ロゴデザイン用に 49 EUR の支払いリンクを作成して。」 「注文 1042 の支払いは確認されていますか？」

価格は USD または EUR で指定します。顧客は CigalPay のチェックアウトでコイン（Bitcoin、Tron 上の USDT、Ethereum、Solana、Litecoin など）を選択でき、レートは 30 分間固定されます。

ツール

ツール	機能
create_checkout	USD または EUR 建ての支払いを作成し、チェックアウトリンクを返します（1 件あたり最大 5,000）。fee_paid_by: customer を指定すると、処理手数料が顧客の支払額に加算されます
get_payment	支払いのステータス、コイン、金額を確認します。confirmed または finished は支払い済みを意味します
get_payments_by_order	注文参照番号ごとに作成されたすべての支払いを確認します
list_active_payments	顧客の支払いを待っている支払いを一覧表示します
list_supported_coins	直接受け付けているコインを一覧表示します
list_refunds	支払いの返金とそのステータスを確認します
create_refund	支払いを暗号資産で返金します。デフォルトでは無効です。CIGALPAY_ALLOW_REFUNDS=1 を設定してください

create_refund は CigalPay の残高から資金を移動するため、有効にした場合のみ利用できます。また、破壊的な操作としてマークされているため、アシスタントは実行前に確認を求めます。

セットアップ

CigalPay ダッシュボードの Settings → API credentials で Account ID と API key を取得します。Node.js 18 以降が必要です。

変数
CIGALPAY_ACCOUNT_ID	支払いリンクの作成に必要です
CIGALPAY_API_KEY	支払いと返金の読み取りに必要です。秘密にしてください
CIGALPAY_NOTIFY_URL	署名付き支払い通知を受信する公開 HTTPS URL です。毎回 notify_url を渡さない場合、create_checkout に必要です
CIGALPAY_RETURN_URL	支払い後に顧客が移動する URL です（デフォルト：cigalpay.com）
CIGALPAY_ALLOW_REFUNDS	1 にすると create_refund が有効になります

Claude Code

claude mcp add cigalpay \
  -e CIGALPAY_ACCOUNT_ID=your-account-id \
  -e CIGALPAY_API_KEY=your-api-key \
  -e CIGALPAY_NOTIFY_URL=https://your-site.com/cigalpay/notify \
  -- npx -y cigalpay-mcp

Claude Desktop、Cursor、VS Code など

クライアントの MCP 設定（claude_desktop_config.json、.cursor/mcp.json など）に追加します。

{
  "mcpServers": {
    "cigalpay": {
      "command": "npx",
      "args": ["-y", "cigalpay-mcp"],
      "env": {
        "CIGALPAY_ACCOUNT_ID": "your-account-id",
        "CIGALPAY_API_KEY": "your-api-key",
        "CIGALPAY_NOTIFY_URL": "https://your-site.com/cigalpay/notify"
      }
    }
  }
}

支払い通知

支払いのステータスが変わると、CigalPay は通知 URL に署名付き通知を送信します。信頼する前に、JavaScript SDK（CigalPay.verifyWebhook）または PHP SDK を使って x-cigalpay-sig 署名を確認してください。開発者向けドキュメントをご覧ください。

リリース

package.json、server.json（2 か所）、CHANGELOG.md のバージョンを更新してから、vX.Y.Z タグをプッシュします。GitHub Actions により npm でパッケージがステージングされます。npmjs.com で承認してから、MCP Registry ワークフローを実行してください。

ライセンス

MIT