mcp-kushki

@codespar/mcp-kushki

Kushki 向け MCP サーバー — メキシコ、コロンビア、チリ、ペルー、エクアドルにまたがるオムニチャネル PSP です。カードのトークン化、1 ステップ／2 ステップの請求、銀行振込による入金（PSE／SPEI）、現金決済ネットワーク、サブスクリプションを、単一の REST API で利用できます。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "kushki": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-kushki"],
      "env": {
        "KUSHKI_PUBLIC_MERCHANT_ID": "your-public-merchant-id",
        "KUSHKI_PRIVATE_MERCHANT_ID": "your-private-merchant-id",
        "KUSHKI_ENV": "sandbox"
      }
    }
  }
}

Claude Code

claude mcp add kushki --env KUSHKI_PUBLIC_MERCHANT_ID=... --env KUSHKI_PRIVATE_MERCHANT_ID=... -- npx -y @codespar/mcp-kushki

Cursor / VS Code

同じブロックを .cursor/mcp.json または .vscode/mcp.json に追加します。

ツール（10）

ツール	エンドポイント	機能
tokenize_card	POST /card/v1/tokens	カード情報 → 1 回限りのトークン（公開 ID）
create_charge	POST /card/v1/charges	1 ステップのカード請求
create_preauthorization	POST /card/v1/preAuthorization	資金を確保（2 ステップの 1 段階目）
capture_preauthorization	POST /card/v1/capture	仮売上を確定（2 段階目、一部金額での確定も可能）
void_charge	DELETE /card/v1/charges/{ticket}	取消（当日中）または返金（売上確定後）
create_transfer_token	POST /transfer/v1/tokens	PSE（CO）／SPEI（MX）の銀行振込による入金用トークン
create_transfer_charge	POST /transfer/v1/init	銀行振込を開始し、リダイレクト URL を返します
create_cash_charge	POST /cash/v1/charges	OXXO 型ネットワーク向けの現金決済用バウチャー
create_subscription	POST /card/v1/subscriptions	指定した周期での定期カード請求
cancel_subscription	DELETE /card/v1/subscriptions/{id}	今後の請求を停止

認証

権限が異なる 2 つの加盟店 ID を使用します。

変数	必須	説明
KUSHKI_PUBLIC_MERCHANT_ID	はい	トークン化のみ — クライアント側で安全に使用できます
KUSHKI_PRIVATE_MERCHANT_ID	はい	資金の移動 — サーバー側のみで使用してください
KUSHKI_ENV	いいえ	sandbox（api-uat、デフォルト）または production

金額には Kushki の国別税額形式を使用します：{ subtotalIva, subtotalIva0, iva, currency } — 通貨は MXN、COP、CLP、PEN、USD です。

例

「このテスト用カードをトークン化し、IVA 19% で COP 85,000 を請求してください。」

エージェントは tokenize_card を呼び出し、続いて { subtotalIva: 85000, subtotalIva0: 0, iva: 16150, currency: "COP" } を指定して create_charge を呼び出します。

エンタープライズ

エージェントによる支払いに、ガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

マネージドプラン

このオープンソースサーバーは、お客様の認証情報を使用して Kushki の API を直接呼び出します。CodeSpar のマネージドプランでは、自動フェイルオーバー、ガバナンス、監査、認証情報保管庫を備え、単一のインターフェースから LATAM のすべてのプロバイダーに接続できます：codespar.dev/agents。

ライセンス

MIT