mcp-ebanx

@codespar/mcp-ebanx

EBANX 向け MCP サーバー — ラテンアメリカ向けクロスボーダー決済

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "ebanx": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ebanx"],
      "env": {
        "EBANX_INTEGRATION_KEY": "your-key",
        "EBANX_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add ebanx -- npx @codespar/mcp-ebanx

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "ebanx": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ebanx"],
      "env": {
        "EBANX_INTEGRATION_KEY": "your-key",
        "EBANX_SANDBOX": "true"
      }
    }
  }
}

ツール（18）

ツール	目的
create_payment	EBANX で決済を作成します（boleto、クレジットカード、PIX など）
get_payment	ハッシュを指定して決済の詳細を取得します
list_payments	日付範囲を指定して決済を一覧表示します
refund	決済を返金します（全額または一部）
create_payout	銀行口座への支払いを作成します
exchange_rate	通貨ペアの現在の為替レートを取得します
get_banks	国で利用可能な銀行を一覧表示します
query_payment_by_merchant_code	merchant_payment_code を指定して決済の詳細を取得します（ハッシュの代替）
capture_payment	以前に承認されたクレジットカード決済を確定します（全額または一部）。
cancel_payment	ハッシュを指定して保留中の決済をキャンセル／無効化します（例：
create_mass_payout	一括支払いを作成します — 1 回のバッチリクエストで複数の支払いを処理します。
get_payout	external_reference または payout id を指定して支払いを照会します。
simulate_payment	サンドボックスで決済の応答をシミュレートします。データは保存されません（統合テストに便利です）。
list_payment_methods	国で利用可能な決済方法を一覧表示します（サポートされている payment_type_codes を確認できます）。
create_card_token	クレジットカード／デビットカードをトークン化し、カード情報を再収集せずに再利用できるようにします。
delete_card_token	保存済みのカードトークンを削除します。
validate_document	チェックサム／形式ルールを使用して、LATAM の納税者番号（BR の CPF/CNPJ、MX の RFC、AR/PE の DNI）を検証します。
verify_notification	統合キーを使って EBANX webhook 通知の HMAC 署名を検証します。

認証

EBANX では、リクエスト本文またはクエリパラメーターで渡す統合キーを使用します。

サンドボックス／テスト

EBANX は sandbox.ebanx.com でサンドボックスを提供しています。利用するには EBANX_SANDBOX=true を設定します。

認証情報を取得する

1. EBANX Dashboard にアクセスします
2. 開発者アカウントを作成します
3. 統合キーを取得します
4. EBANX_INTEGRATION_KEY 環境変数を設定します

環境変数

変数	必須	説明
EBANX_INTEGRATION_KEY	はい	EBANX ダッシュボードで取得した統合キー
EBANX_SANDBOX	いいえ	サンドボックスモードを使うには "true" を設定します

ロードマップ

v0.2（予定）

• create_subscription — 定期サブスクリプションを作成します
• cancel_payment — 保留中の決済をキャンセルします
• get_merchant_info — 加盟店アカウント情報を取得します
• create_split — 分割決済ルールを作成します

v0.3（予定）

• batch_payouts — 1 回のリクエストで複数の支払いを処理します
• detailed_reports — 詳細な財務レポートを生成します

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• EBANX のウェブサイト
• EBANX API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT