cloudpayments-mcp について
cloudpayments-mcpはCloudPaymentsの決済APIをMCPクライアントに公開し、決済やサブスクリプションを扱う業務・開発チーム向けに提供します。即時決済や返金に加え、2段階決済、注文、取引照会にも対応しています。
主な機能
- 01即時決済とオーソリの実行
- 02承認済み決済の確定または取消
- 03取引照会と返金処理
- 04サブスクリプションの作成・更新・解約
- 05決済注文の作成と取引一覧の取得
活用シーン
- 01単発決済の実行と取引確認
- 02オーソリ済み決済の確定または取消
- 03ユーザー向け定期購読の設定
- 04決済リンクの作成と返金処理
MCP 対応
このMCPサーバーは、決済、返金、サブスクリプション、注文、取引を扱うCloudPaymentsのツールを提供します。stdioまたはHTTPでMCPクライアントに接続できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
🗄 リポジトリはアーカイブされました
開発は theYahia/WWmcp に移行しました。CIS、MENA、アフリカ、LATAM、東南アジアの非西洋系 API 向け MCP サーバーのモノレポです。共通コア
@theyahia/mcp-core、統一された CI とリリースパイプラインを備えています。ここにあったものの最新版はこちらです:
servers/cloudpayments/npm パッケージは従来どおりです —
@theyahia/cloudpayments-mcp。これまでどおりインストールしてご利用いただけます。 このリポジトリは今後更新されません。課題やプルリクエストは WWmcp にお寄せください。アーカイブされました — 開発は theYahia/WWmcp に移行しました。 非西洋系 API 向け MCP サーバーのモノレポです。 このパッケージの最新版は
servers/cloudpayments/にあります。 npm パッケージ@theyahia/cloudpayments-mcpに変更はありません。 課題やプルリクエストはそちらにお寄せください。
@theyahia/cloudpayments-mcp
CloudPayments API 向け MCP サーバー — 1 段階・2 段階決済、返金、サブスクリプション、注文(請求リンク)、取引履歴に対応しています。12 個のツール。
@theYahia による Russian API MCP シリーズの一部です。
クイックスタート
Claude Desktop
{
"mcpServers": {
"cloudpayments": {
"command": "npx",
"args": ["-y", "@theyahia/cloudpayments-mcp"],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
"CLOUDPAYMENTS_API_SECRET": "your-api-secret"
}
}
}
}
Claude Code
claude mcp add cloudpayments -e CLOUDPAYMENTS_PUBLIC_ID=your-id -e CLOUDPAYMENTS_API_SECRET=your-secret -- npx -y @theyahia/cloudpayments-mcp
Cursor / Windsurf
{
"cloudpayments": {
"command": "npx",
"args": ["-y", "@theyahia/cloudpayments-mcp"],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
"CLOUDPAYMENTS_API_SECRET": "your-api-secret"
}
}
}
HTTP トランスポート
HTTP_PORT=3000 npx @theyahia/cloudpayments-mcp
# or
npx @theyahia/cloudpayments-mcp --http 3000
エンドポイント:POST /mcp(JSON-RPC)、GET /health(ステータス)。
認証
| 変数 | 必須 | 説明 |
|---|---|---|
CLOUDPAYMENTS_PUBLIC_ID | はい | パブリック ID(HTTP Basic のユーザー名) |
CLOUDPAYMENTS_API_SECRET | はい | API シークレット(HTTP Basic のパスワード) |
テストには CloudPayments テストターミナル をご利用ください。
ツール(12)
決済(5)
| ツール | API エンドポイント | 説明 |
|---|---|---|
charge_payment | POST /payments/charge | 1 段階決済(即時課金) |
auth_payment | POST /payments/auth | 2 段階決済(オーソリ/保留) |
confirm_payment | POST /payments/confirm | オーソリ済み決済を確定(全額または一部) |
void_payment | POST /payments/void | オーソリ済み決済を取り消し(保留を解除) |
get_transaction | POST /payments/find | ID で取引を検索 |
返金(1)
| ツール | API エンドポイント | 説明 |
|---|---|---|
refund_payment | POST /payments/refund | 取引 ID による全額または一部返金 |
サブスクリプション(4)
| ツール | API エンドポイント | 説明 |
|---|---|---|
create_subscription | POST /subscriptions/create | トークンを使って定期サブスクリプションを作成 |
update_subscription | POST /subscriptions/update | 金額、間隔、期間を更新 |
cancel_subscription | POST /subscriptions/cancel | 有効なサブスクリプションをキャンセル |
list_subscriptions | POST /subscriptions/find | ユーザーのサブスクリプション一覧を取得 |
注文(1)
| ツール | API エンドポイント | 説明 |
|---|---|---|
create_order | POST /orders/create | 決済注文(請求リンク)を作成 |
取引(1)
| ツール | API エンドポイント | 説明 |
|---|---|---|
list_transactions | POST /payments/list | 指定日のすべての取引を一覧表示 |
デモ用プロンプト
Charge 5000 RUB from the card cryptogram, IP 192.168.1.1, description "Premium plan"
Create a monthly subscription for 999 RUB using token from the last payment, starting May 1st
Show me all transactions for yesterday and refund 2500 RUB on transaction 123456
ロシア API MCP シリーズの一部
| MCP | ステータス | 説明 |
|---|---|---|
| @metarebalance/dadata-mcp | ready | 住所、企業、銀行、電話番号 |
| @theyahia/cbr-mcp | ready | 為替レート、政策金利 |
| @theyahia/yookassa-mcp | ready | 支払い、返金、領収書、支払い処理、Webhook |
| @theyahia/cloudpayments-mcp | ready | 支払い、サブスクリプション、注文 |
| ... | +46 サーバー -- 全リスト |
ライセンス
MIT
Telegram: @vhodvai
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。