mcp-vindi について
mcp-vindi は、Vindi 課金プラットフォーム向けの MCP サーバーで、定期課金、サブスクリプション、請求、支払いプロファイルに関するツールを提供します。AI アシスタントやエージェントから Vindi の継続課金を管理したいチームに向いています。
主な機能
- 01サブスクリプションの作成、取得、キャンセル、再有効化
- 02請求の作成、取得、決済、キャンセル
- 03顧客と商品カタログの管理
- 04全額および部分返金、支払いプロファイルの管理
活用シーン
- 01AI アシスタントからサブスクリプションの状態を確認し、キャンセルや再有効化を行う
- 02請求を作成し、未処理の請求の決済を再試行する
- 03顧客のトークン化された支払い方法を登録し、返金を実行する
MCP 対応
本プロジェクトは MCP サーバーとして動作し、20 個の Vindi 関連ツールを MCP クライアントに公開します。クライアントはそれらを通じて Vindi API の課金操作を呼び出せます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
20掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| plan_id | number | はい | プラン ID |
| start_at | string | いいえ | 開始日（YYYY-MM-DD） |
| customer_id | number | はい | 顧客 ID |
| payment_method_code | string | はい | 支払い方法（credit_card、bank_slip、pix） |
詳細
@codespar/mcp-vindi
Vindi 向け MCP サーバー — 継続課金、サブスクリプション、支払いプラン
クイックスタート
Claude Desktop
~/.config/claude/claude_desktop_config.json に追加します：
{
"mcpServers": {
"vindi": {
"command": "npx",
"args": ["-y", "@codespar/mcp-vindi"],
"env": {
"VINDI_API_KEY": "your-key"
}
}
}
}
Claude Code
claude mcp add vindi -- npx @codespar/mcp-vindi
Cursor / VS Code
.cursor/mcp.json または .vscode/mcp.json に追加します：
{
"servers": {
"vindi": {
"command": "npx",
"args": ["-y", "@codespar/mcp-vindi"],
"env": {
"VINDI_API_KEY": "your-key"
}
}
}
}
ツール（20）
| ツール | 用途 |
|---|---|
create_subscription | Vindi で継続課金サブスクリプションを作成します |
get_subscription | ID を指定してサブスクリプションの詳細を取得します |
list_subscriptions | オプションのフィルターを指定してサブスクリプションを一覧表示します |
create_bill | Vindi で請求書（課金）を作成します |
get_bill | ID を指定して請求書の詳細を取得します |
list_bills | オプションのフィルターを指定して請求書を一覧表示します |
create_customer | Vindi で顧客を作成します |
get_customer | ID を指定して顧客の詳細を取得します |
create_plan | Vindi で課金プランを作成します |
list_plans | 利用可能な課金プランを一覧表示します |
update_customer | 顧客の詳細を更新します |
create_product | 商品を作成します（プランまたは請求書に追加できるカタログ項目） |
list_products | カタログ内の商品を一覧表示します |
cancel_subscription | サブスクリプションを直ちにキャンセルします |
reactivate_subscription | キャンセルしたサブスクリプションを再開します |
cancel_bill | 保留中の請求書をキャンセルします |
charge_bill | 保留中の請求書への課金を再試行します（課金ワークフローを実行します） |
refund_charge | 課金を返金します（全額または一部）。 |
create_payment_profile | 顧客の支払いプロファイル（トークン化されたカード／保存済みの支払い方法）を作成します |
list_payment_profiles | 顧客で絞り込むこともできる支払いプロファイルの一覧を取得します |
認証
Vindi は、ユーザー名に API キー、パスワードを空欄とする Basic Auth を使用します。
サンドボックス／テスト
Vindi はダッシュボードからサンドボックスを提供しています。テストにはサンドボックスの API キーを使用してください。
認証情報の取得
- Vindi にアクセスします
- アカウントを作成します
- 設定に移動して API キーを生成します
VINDI_API_KEY環境変数を設定します
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
VINDI_API_KEY | はい | Vindi ダッシュボードで取得した API キー |
ロードマップ
v0.2（予定）
cancel_subscription— アクティブなサブスクリプションをキャンセルしますupdate_subscription— サブスクリプションの詳細を更新しますlist_payment_profiles— 顧客の支払いプロファイルを一覧表示しますcreate_discount— サブスクリプションの割引を作成しますget_charges— フィルターを指定して課金の詳細を取得します
v0.3（予定）
batch_bills— 1 回のリクエストで複数の請求書を作成しますfinancial_reports— 財務サマリーレポートを生成します
貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。
リンク
エンタープライズ
エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。