mcpField
M
mcp-rede

mcp-rede

ローカル
github.com/codespar金融データ2754 週間前に更新

mcp-rede について

mcp-rede は、Itaú が保有するブラジルのカード加盟店契約会社 Rede の MCP サーバーです。クレジットカードとデビットカードの承認、売上確定、返金に加え、ゼロ承認、カードトークン、定期課金、3DS に対応しています。Itaú との契約があり eRede に直接接続する加盟店に適しています。

主な機能

  1. 01クレジット・デビットカードの承認、売上確定、取消、返金
  2. 02ゼロ承認によるカード検証
  3. 03カードのトークン化とトークン情報の取得
  4. 04定期課金(recurrence)の管理
  5. 053DS 認証フロー
  6. 06Boleto の発行、照会、取消

活用シーン

  1. 01サブスクリプション向けの定期課金の作成と管理
  2. 02承認前の顧客カードの有効性確認
  3. 033DS 認証成功後の取引の承認

MCP 対応

MCP クライアントに対して、取引、トークン、定期課金、3DS、Boleto の操作を行う 22 のツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"codespar-mcp-rede": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-rede"
],
"env": {
"REDE_PV": "<REDE_PV>",
"REDE_TOKEN": "<REDE_TOKEN>",
"REDE_ENV": "<REDE_ENV>"
}
}
}
}
起動コマンドnpx -y @codespar/mcp-rede
設定が必要な環境変数
REDE_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-rede0.2.0-alpha.3

ツール

22

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
urlsarrayいいえ任意のコールバック/通知 URL オブジェクト({ url, kind })
amountnumberはい金額はセント単位です
capturebooleanはいtrue = 承認と売上確定;false = 承認のみ
referencestringはい加盟店側の注文参照(加盟店ごとに一意)
cardNumberstringいいえPAN。値をログに記録しないでください。代わりに storageCard(トークン)を使用してください。
storageCardstringいいえtokenize_card のトークン(cardNumber の代替)
installmentsnumberはい分割払いの回数(à vista の場合は 1)
securityCodestringいいえCVV
subscriptionbooleanいいえ継続課金(MIT)として指定します
cardHolderNamestringいいえカード名義人名
expirationYearnumberいいえ有効期限の年(4 桁)
softDescriptorstringいいえカード名義人の利用明細に表示される明細表記
expirationMonthnumberいいえ有効期限の月(1~12)

詳細

@codespar/mcp-rede

Rede 用 MCP サーバー — Itaú 傘下のブラジルのカードアクワイアラーです。

Rede は、Cielo、Stone、Getnet と並ぶブラジルの「4 大」アクワイアラーの一角を占めています。Itaú と商業契約を結んでいる加盟店は、PSP を経由せず、eRede を通じて直接連携します。

ツール(22)

ツール目的
authorize_transactionRede でクレジットカード取引を承認します。
capture_transaction以前に承認した取引を売上確定します(capture=false が使用された場合)。
cancel_transaction承認済みで未売上確定の取引をキャンセルします(取消)。
refund_transaction売上確定済みの取引を返金します。
get_transactionRede の tid または加盟店参照番号で取引を取得します。
zero_auth課金せずにカードを検証します(ゼロ円認証/アカウント確認)。
tokenize_cardPCI に準拠した安全な再利用のためにカードをトークン化します。
delete_token以前に作成したカードトークンを削除します。
create_recurrenceRede のネイティブ継続課金(サブスクリプション)を作成します。
get_recurrenceRede の継続課金 ID で継続課金を取得します。
disable_recurrence有効な継続課金を無効化(キャンセル)します。
authorize_debitRede でデビットカード取引を承認します。
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_3ds3DS 認証成功後に取引を承認し、3DS 参照情報を付加して責任移転の sh...
create_boletoRede 経由で boleto registrado を発行します。
get_boletoRede の 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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。