coinvoyage-paykit-claudeplugin

CoinVoyage（ノンカストディアルなマルチチェーン暗号資産決済ゲートウェイ）を、Claudeで構築するあらゆるアプリに統合するためのClaude Codeプラグインです。

以下の2つのサーフェスをバンドルしています：

1. スキル (coinvoyage-payments) — Claudeが暗号資産決済、チェックアウト、ステーブルコイン、Web3決済関連の作業を支援する際にトリガーされます。サーバーサイドでのPayOrder作成、React PaymentWidget、Webhook署名の検証、JS以外のスタック向けのREST APIフォールバックなど、統合の全工程をガイドします。

2. MCPサーバー (@kingpeque/coinvoyage-mcp) — ClaudeがCoinVoyage APIを直接呼び出すための15のツールを提供します。PayOrderの作成、ステータスの確認、Webhookの管理、スワップレートの取得などが可能です。

コミュニティによる統合プラグインです。 CoinVoyageの公式製品ではありません。

インストール

/plugin install KingPeque/coinvoyage-paykit

インストール時に以下が求められます：

シークレットはClaude Codeの機密設定パスを通じてシステムキーチェーンに保存されるため、コミットするファイルに含まれることはありません。

Related MCP server: Purple Flea Wallet

Claudeへの指示例

インストール後、以下のようなリクエストでスキルやMCPツールが有効になります：

• 「Next.jsのチェックアウトに暗号資産決済を追加して」

• 「サイトでビットコインを受け取れるようにしたい」

• 「Base上のUSDCで決済を受け取りつつ、あらゆる暗号資産で寄付ができるページを作って」

• 「25ドルのテスト用インボイスを作成して、Base上のUSDCで決済して。ウォレットアドレスはこれです」

• 「完了した注文のために https://mysite.com/api/webhooks/coinvoyage でWebhookを登録して」

含まれているもの

coinvoyage-paykit/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest (prompts user for API keys)
├── mcp.json                     # Declares the bundled MCP server
├── skills/
│   └── coinvoyage-payments/
│       └── SKILL.md             # Integration guide + trigger description
├── mcp-server/                  # Source for @kingpeque/coinvoyage-mcp (npm)
│   ├── src/index.ts
│   ├── package.json
│   └── tsconfig.json
├── README.md
└── LICENSE

サポートされているチェーン

Bitcoin、Solana、Ethereum、Optimism、Arbitrum、Base、BSC、Polygon、Sui — およびこれらのチェーン上のあらゆるERC-20 / SPL / ネイティブトークン。チェーンIDの完全なリファレンスは supported_chains MCPツールを参照してください。

料金（CoinVoyageの料金であり、本プラグインの料金ではありません）

• 決済成功ごとに1.5%

• オフランプ手数料 0%

• 加盟店は独自の手数料を上乗せ可能

• 本プラグインは無料かつMITライセンスです。CoinVoyageの手数料に関するボリュームディスカウントについては help@coinvoyage.io までお問い合わせください。

セキュリティ体制

• リポジトリ内にシークレットは含まれません。 機密情報はすべてClaude Codeの設定内に保持され、実行時にMCPサーバーへ注入されます。

• ユーザーごとのキー。 すべての開発者が自身のCoinVoyage APIキーを使用します。中央集権的なホスティングは行われず、侵害される共有サーバーも存在しません。

• 最小限のネットワーク露出。 MCPサーバーは api.coinvoyage.io（または設定したオーバーライド先）とのみ通信します。

• HMAC-SHA256 認証を特権操作（SALE/REFUND/Webhook/手数料請求）に使用します。

• オープンソース。 MCPサーバーのソースコードは mcp-server/src/index.ts で確認できます（300行未満です）。

ローカル開発

git clone https://github.com/KingPeque/coinvoyage-paykit
cd coinvoyage-paykit/mcp-server
npm install
npm run build
# Point your MCP client at ./mcp-server/dist/index.js with COINVOYAGE_API_KEY set

skills/coinvoyage-payments/ を ~/.claude/skills/ にシンボリックリンクするか、開発モードでプラグインをインストールすることで、スキルをローカルで実行できます。

コントリビューション

問題報告やプルリクエストは https://github.com/KingPeque/coinvoyage-paykit/issues までお願いします。APIキー、シークレット、ウォレットアドレスをコミットしないようご注意ください。

ライセンス

MIT — LICENSE を参照してください。

リンク

• CoinVoyageサイト: https://coinvoyage.io

• CoinVoyageドキュメント: https://docs.coinvoyage.io

• ダッシュボード: https://dashboard.coinvoyage.io

• サポート: help@coinvoyage.io

• 本プラグインのイシュー: https://github.com/KingPeque/coinvoyage-paykit/issues