mcp-khipu について
mcp-khipu は、チリの即時銀行振込決済サービス Khipu の MCP サーバーです。mcp-transbank と組み合わせて使うことが想定されており、銀行振込による決済を受け付けるチリの加盟店やエージェントを対象とします。決済、返金、消込、Webhook、POS 端末セッションに対応します。
主な機能
- 01決済の作成、取得、確認、返金
- 02日付とステータスによる決済記録の絞り込み
- 03銀行と収納口座の情報取得
- 04消込記録と支払者レビューの取得
- 05Webhook の登録と管理
- 06POS 端末セッションと自動決済
活用シーン
- 01チリの EC サイトで銀行振込決済を提供
- 02高額購入や B2B の代金回収
- 03カード決済と銀行振込を組み合わせた決済手段の提供
MCP 対応
Khipu の決済、加盟店、Webhook、端末セッションの API を MCP ツールとして公開し、MCP クライアントから直接呼び出せるようにします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-khipuKHIPU_API_KEYシークレットKhipu v3 API key (sent as x-api-key header). Obtain from Khipu merchant panel → Developers.KHIPU_RECEIVER_IDKhipu receiver id (merchant id). Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.KHIPU_SECRETシークレットKhipu receiver secret. Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.KHIPU_BASE_URLKhipu API base URL. Defaults to https://payment-api.khipu.com/v3.ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
21掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| body | string | いいえ | 決済の詳細な説明（件名とともに表示） |
| amount | number | はい | 主要通貨単位での金額（CLP に小数単位はありません。1000 = 1000 ペソ） |
| custom | string | いいえ | 任意の加盟店文字列（構造化する場合は JSON エンコード）。Webhook でそのまま返されます。 |
| subject | string | はい | 決済の簡潔でわかりやすい目的（支払人の銀行に表示） |
| currency | string | はい | ISO-4217 通貨コード。チリでは通常 CLP を使用します。UF 建ての請求には CLF も使用できます。 |
| cancel_url | string | いいえ | 支払人がキャンセルした場合のブラウザーリダイレクト先 |
| notify_url | string | いいえ | ステータス変更時に Khipu が POST する Webhook URL（notification_token を受信） |
| payer_name | string | いいえ | 支払人の表示名 |
| return_url | string | いいえ | 支払い成功後のブラウザーのリダイレクト先 |
| send_email | boolean | いいえ | true の場合、Khipu は支払人に支払いリンクをメールで送信します |
| payer_email | string | いいえ | 支払人のメールアドレス — Khipu はこのアドレスに支払い方法をメールで送信します |
| expires_date | string | いいえ | この支払いリクエストの ISO-8601 有効期限タイムスタンプ |
| integrator_fee | number | いいえ | インテグレーター手数料（パートナー向け） |
| send_reminders | boolean | いいえ | true の場合、Khipu は有効期限前に支払人へリマインダーメールを送信します |
| transaction_id | string | いいえ | Webhook でそのまま返される加盟店側の注文参照番号 |
| notify_api_version | string | いいえ | Webhook API のバージョン。v3 通知には '3.0' を使用します。 |
| collect_account_uuid | string | いいえ | デフォルトの入金口座を上書きします |
| confirm_timeout_date | string | いいえ | 未確認の支払いが自動的に取り消される ISO-8601 の期限 |
| responsible_user_email | string | いいえ | Khipu のダッシュボードでこの請求の責任者として表示される、加盟店内部ユーザーのメールアドレス |
| fixed_payer_personal_identifier | string | いいえ | この支払いを特定の支払人の RUT に固定します |
詳細
@codespar/mcp-khipu
Khipu 用の MCP サーバー — チリの即時銀行振込 PSP です。
Khipu を使うと、支払者はチリの銀行口座からリアルタイムで支払えます。加盟店が支払いを作成すると、支払者は Khipu にリダイレクトされ、銀行にログインし、振込が即時に完了します。カードも与信枠も不要で、インターチェンジ手数料もかかりません。高額購入に適した、チリで好まれる決済手段です。
チリのエージェントでは通常、Khipu と @codespar/mcp-transbank を組み合わせます。カード決済には Webpay、銀行振込には Khipu を使います。両方を合わせることで、チリのチェックアウトで大多数を占める決済ニーズに対応できます。
ツール（21）
| ツール | 用途 |
|---|---|
create_payment | Khipu の支払い（銀行振込による請求）を作成します。 |
get_payment | Khipu の支払いを取得します。 |
delete_payment | 保留中の Khipu 支払いを削除（キャンセル）します。 |
confirm_payment | Khipu の支払いを手動で確定します。 |
refund_payment | 支払い済みの Khipu 支払いを返金します（全額または一部）。 |
list_payments | 現在の加盟店の Khipu 支払いを一覧表示します。日付範囲とステータスで絞り込むこともできます。 |
predict_payment | 指定した支払者・金額・銀行について、支払いが成功する可能性を予測し、最適な銀行を推奨します／... |
get_merchants | 現在の API キーでアクセス可能な加盟店の受取口座を一覧表示します。 |
get_merchant | ID で指定した加盟店を取得します。 |
list_merchant_accounts | 加盟店に登録されている入金先の銀行口座を一覧表示します。 |
create_receiver | インテグレーターアカウントに新しい受取人を作成（登録）します。 |
list_receivers | 現在のインテグレーターアカウントに登録されている受取人を一覧表示します。 |
list_conciliations | 指定した日付範囲の決済／照合記録を一覧表示します。 |
list_reviews | Khipu での支払い後に支払者が残したレビュー／評価を一覧表示します。 |
register_webhook | Khipu の通知（payment.paid、payment.refunded など）を受け取る Webhook エンドポイントを登録します。 |
list_webhooks | 現在の加盟店に登録されている Webhook エンドポイントを一覧表示します。 |
delete_webhook | ID で指定した Webhook エンドポイントを削除（登録解除）します。 |
create_terminal_session | 対面／POS の銀行振込チェックアウト用に Khipu の端末セッションを作成します。 |
get_terminal_session | 端末（POS）セッションの現在のステータスを取得します。支払者によるスキャンや支払いの有無、またはセッションの... |
get_banks | Khipu が銀行振込での支払いに対応しているチリの銀行を一覧表示します。 |
create_automatic_payment | Khipu の自動支払いを作成します（登録済みのサブスクリプションに対する定期／サブスクリプション料金の請求...） |
インストール
npm install @codespar/mcp-khipu@alpha
環境
# Preferred — v3 API key auth
KHIPU_API_KEY="..." # sent as x-api-key header
# Legacy — v2 HTTP Basic auth (only if no API key available)
KHIPU_RECEIVER_ID="..." # merchant receiver id
KHIPU_SECRET="..." # receiver secret
# Optional
KHIPU_BASE_URL="..." # defaults to https://payment-api.khipu.com/v3
認証
Khipu v3 では、x-api-key ヘッダーで単一の API キーを使用します。リクエスト署名や HMAC は不要です。Khipu の加盟店パネルで「Developers」→「API keys」からキーを取得してください。
KHIPU_API_KEY が設定されていない場合、レガシーエンドポイントを引き続き使用している加盟店向けに、サーバーは KHIPU_RECEIVER_ID:KHIPU_SECRET を使った v2 HTTP Basic 認証にフォールバックします。
すべてのリクエストボディは JSON（v3）です。サーバーが Content-Type: application/json を自動的に設定します。
実行
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-khipu
# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-khipu
Khipu と Transbank を組み合わせる理由
チリでは、主に次の 2 種類の決済手段が使われています。
- カード（Transbank Webpay） — どこでも使える汎用的な決済手段ですが、インターチェンジ手数料がかかります。
- 銀行振込（Khipu） — カードも与信枠も不要で、手数料が安く、高額購入や B2B で好まれます。
チェックアウトで両方を提供できるエージェントは、カード決済しか受け付けないエージェントよりも、コンバージョン率が大幅に向上します。@codespar/mcp-transbank が前者を、このパッケージが後者を処理します。
組み合わせて使う
@codespar/mcp-transbank— チリのカード決済処理（Webpay Plus、Oneclick、Full Transaction）@codespar/mcp-dlocal— 1 つの API でチリと他国に対応したい場合の、国境を越えたラテンアメリカの決済対応
エンタープライズ
エージェント決済のガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。