coinvoyage について
coinvoyage-paykit-claudepluginは、アプリへのCoinVoyage暗号資産決済の組み込みを支援する、コミュニティ運営のClaude Codeプラグインです。統合ガイドのスキルと、注文やWebhook、スワップ見積もりを扱う15個のAPIツールを備えたMCPサーバーで構成されます。
主な機能
- 01サーバー側PayOrder連携を案内
- 02React PaymentWidgetとWebhookに対応
- 03非JavaScriptスタック向けREST APIの代替手段
- 0415個のツールでCoinVoyage APIを呼び出し
- 05注文、状態、Webhook、スワップ見積もりを操作
活用シーン
- 01アプリのチェックアウトに暗号資産決済を追加
- 02決済注文の作成と状態確認
- 03Webhookの登録と署名検証
- 04Claude Codeからスワップ見積もりを取得
MCP 対応
同梱の@kingpeque/coinvoyage-mcpサーバーは15個のツールを公開し、Claude CodeからCoinVoyage APIを呼び出せます。PayOrderの作成、状態確認、Webhook管理、スワップ見積もりなどに対応し、設定したAPIキーを使用します。特権操作にはAPI secretも必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @kingpeque/coinvoyage-mcpCOINVOYAGE_API_KEYシークレットYour CoinVoyage public API key. Get one at https://dashboard.coinvoyage.io (Developers section).COINVOYAGE_API_SECRETシークレットServer-side API secret. Required for SALE/REFUND PayOrders, fee claims, and webhook management. Leave unset if you only need DEPOSIT (merchant invoice) flows.COINVOYAGE_API_BASE_URLOverride the API base URL. Defaults to https://api.coinvoyage.io.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
15掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| type | enum | いいえ | PayOrder のタイプ。デフォルトは DEPOSIT です。DEPOSIT | SALE | REFUND |
| amount | object | はい | 請求金額。法定通貨(例:USD)またはトークンのシンボルを指定します。 |
| amount.value | number | はい | 10 進数の金額(例:19.99)。 |
| amount.currency | string | はい | 例:"USD"、"USDC"、"BTC" |
| metadata | object | いいえ | 任意の加盟店メタデータ(orderId、sku、customer など)。 |
| settlement | object | いいえ | 資金の決済先。例:{ chainId: 8453, token: "USDC" } は Base で USDC を受け取る場合です。 |
| settlement.token | string | いいえ | |
| settlement.chainId | number | いいえ | |
| settlement.walletAddress | string | いいえ | |
| expiresInSeconds | number | いいえ | 任意:PayOrder が期限切れになるまで支払い可能な状態を維持する時間。 |
詳細
coinvoyage-paykit-claudeplugin
CoinVoyage(非カストディアル型のマルチチェーン暗号資産決済ゲートウェイ)を、Claude で開発するあらゆるアプリに統合するための Claude Code プラグインです。
2 つの機能をまとめています。
- スキル(
coinvoyage-payments) — Claude が暗号資産決済、チェックアウト、ステーブルコイン、Web3 決済に関する作業を支援するときに起動します。サーバーサイドでの PayOrder 作成、React のPaymentWidget、Webhook 署名の検証、JavaScript を使わないスタック向けの REST API フォールバックまで、統合を一貫してガイドします。 - MCP サーバー(
@kingpeque/coinvoyage-mcp) — CoinVoyage API を直接呼び出す 15 個のツールを Claude に提供します。PayOrder の作成、ステータスの確認、Webhook の管理、スワップ見積もりの取得などを行えます。
コミュニティによって保守されている統合です。 CoinVoyage との公式な提携はありません。
インストール
/plugin install KingPeque/coinvoyage-paykit
インストール時に、次の項目の入力を求められます。
| 項目 | 必須 | 備考 |
|---|---|---|
api_key | はい | https://dashboard.coinvoyage.io → Developers で取得した公開 API キー |
api_secret | 任意 | SALE/REFUND 注文、Webhook 管理、手数料の請求に必要です。空欄にすると、Claude は読み取りと DEPOSIT フローのみを実行できます。 |
api_base_url | 任意 | 既定値は https://api.coinvoyage.io です。 |
シークレットは Claude Code の機密設定経路を通じてシステムのキーチェーンに保存されるため、コミットするファイルに書き込まれることはありません。
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 の手数料に関する取引量割引については、
[email protected]までお問い合わせください。
セキュリティ対策
- このリポジトリにシークレットはありません。 機密情報はすべて 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/ にシンボリックリンクするか、開発モードでプラグインをインストールします。
コントリビューション
Issue や PR は https://github.com/KingPeque/coinvoyage-paykit/issues までお寄せください。API キー、シークレット、ウォレットアドレスはコミットしないでください。
ライセンス
MIT — LICENSE を参照してください。
リンク
- CoinVoyage サイト: https://coinvoyage.io
- CoinVoyage ドキュメント: https://docs.coinvoyage.io
- ダッシュボード: https://dashboard.coinvoyage.io
- サポート:
[email protected] - このプラグインの Issue: https://github.com/KingPeque/coinvoyage-paykit/issues
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。