mcp-rede について
mcp-rede は、Itaú が保有するブラジルのカード加盟店契約会社 Rede の MCP サーバーです。クレジットカードとデビットカードの承認、売上確定、返金に加え、ゼロ承認、カードトークン、定期課金、3DS に対応しています。Itaú との契約があり eRede に直接接続する加盟店に適しています。
主な機能
- 01クレジット・デビットカードの承認、売上確定、取消、返金
- 02ゼロ承認によるカード検証
- 03カードのトークン化とトークン情報の取得
- 04定期課金(recurrence)の管理
- 053DS 認証フロー
- 06Boleto の発行、照会、取消
活用シーン
- 01サブスクリプション向けの定期課金の作成と管理
- 02承認前の顧客カードの有効性確認
- 033DS 認証成功後の取引の承認
MCP 対応
MCP クライアントに対して、取引、トークン、定期課金、3DS、Boleto の操作を行う 22 のツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-redeREDE_PVRede merchant filiação (PV) — numeric merchant identifier issued with your commercial contract.REDE_TOKENシークレットRede API security token paired with PV. Used in HTTP Basic auth as the password.REDE_ENVEnvironment selector: 'sandbox' (default) or 'production'.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
22掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| urls | array | いいえ | 任意のコールバック/通知 URL オブジェクト({ url, kind }) |
| amount | number | はい | 金額はセント単位です |
| capture | boolean | はい | true = 承認と売上確定;false = 承認のみ |
| reference | string | はい | 加盟店側の注文参照(加盟店ごとに一意) |
| cardNumber | string | いいえ | PAN。値をログに記録しないでください。代わりに storageCard(トークン)を使用してください。 |
| storageCard | string | いいえ | tokenize_card のトークン(cardNumber の代替) |
| installments | number | はい | 分割払いの回数(à vista の場合は 1) |
| securityCode | string | いいえ | CVV |
| subscription | boolean | いいえ | 継続課金(MIT)として指定します |
| cardHolderName | string | いいえ | カード名義人名 |
| expirationYear | number | いいえ | 有効期限の年(4 桁) |
| softDescriptor | string | いいえ | カード名義人の利用明細に表示される明細表記 |
| expirationMonth | number | いいえ | 有効期限の月(1~12) |
詳細
@codespar/mcp-rede
Rede 用 MCP サーバー — Itaú 傘下のブラジルのカードアクワイアラーです。
Rede は、Cielo、Stone、Getnet と並ぶブラジルの「4 大」アクワイアラーの一角を占めています。Itaú と商業契約を結んでいる加盟店は、PSP を経由せず、eRede を通じて直接連携します。
ツール(22)
| ツール | 目的 |
|---|---|
authorize_transaction | Rede でクレジットカード取引を承認します。 |
capture_transaction | 以前に承認した取引を売上確定します(capture=false が使用された場合)。 |
cancel_transaction | 承認済みで未売上確定の取引をキャンセルします(取消)。 |
refund_transaction | 売上確定済みの取引を返金します。 |
get_transaction | Rede の tid または加盟店参照番号で取引を取得します。 |
zero_auth | 課金せずにカードを検証します(ゼロ円認証/アカウント確認)。 |
tokenize_card | PCI に準拠した安全な再利用のためにカードをトークン化します。 |
delete_token | 以前に作成したカードトークンを削除します。 |
create_recurrence | Rede のネイティブ継続課金(サブスクリプション)を作成します。 |
get_recurrence | Rede の継続課金 ID で継続課金を取得します。 |
disable_recurrence | 有効な継続課金を無効化(キャンセル)します。 |
authorize_debit | Rede でデビットカード取引を承認します。 |
list_transactions | 日付範囲を指定して取引を一覧表示します。 |
get_token | 以前に保存したカードトークンのメタデータ(ブランド、下 4 桁、有効期限)を取得します。 |
update_recurrence | 既存の継続課金を更新します — 金額、カード(storageCard)、終了日を変更するか、一時停止/再開します。 |
get_recurrence_transactions | 継続課金によって生成された取引を一覧表示します(実行された各請求サイクルにつき 1 行)。 |
authenticate_3ds | カード決済の 3DS(EMV 3-D Secure)認証を開始します。 |
get_3ds_status | 参照 ID を指定して 3DS 認証の現在のステータスを確認します。 |
authorize_with_3ds | 3DS 認証成功後に取引を承認し、3DS 参照情報を付加して責任移転の sh... |
create_boleto | Rede 経由で boleto registrado を発行します。 |
get_boleto | Rede の boleto ID または加盟店参照番号で boleto を取得します。 |
cancel_boleto | 未払いの boleto をキャンセルします。 |
インストール
npm install @codespar/mcp-rede@alpha
環境
REDE_PV="..." # Merchant filiação (PV)
REDE_TOKEN="..." # Security token (paired with PV)
REDE_ENV="sandbox" # Optional. 'sandbox' (default) or 'production'
認証
base64(PV:TOKEN) を使用した HTTP Basic 認証です。サーバーはリクエストごとに Authorization ヘッダーを生成するため、呼び出し側で意識する必要はありません。
ベース URL
- 本番環境:
https://api.userede.com.br/erede/v1 - サンドボックス:
https://sandbox-erede.useredecloud.com.br/v1
実行
# stdio (default)
npx @codespar/mcp-rede
# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-rede
エンタープライズ
エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか?CodeSpar Enterprise では、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加できます。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。