mcp-bradesco

@codespar/mcp-bradesco

Bradesco 向け MCP サーバーです。ブラジルで Itaú に次ぐ第 2 位の民間銀行です。

@codespar/mcp-itau、@codespar/mcp-banco-inter、@codespar/mcp-stark-bank と合わせて、ブラジルの主要な民間銀行 API を網羅します。Pix、boleto、資金管理の取引量が相応にある加盟店は、PSP を経由せず Bradesco と直接連携します。

ステータス：アルファ版（0.1.0-alpha.1）

Bradesco の Developer Portal は契約締結が閲覧条件です。Pix、Cobrança、Arrecadação、Extrato の完全な OpenAPI 仕様は、オンボーディング済みの加盟店のみ閲覧できます。このサーバーのエンドポイントパスは、（a）BACEN Pix v2 の標準パス、（b）Bradesco の公開統合ガイド、（c）Itaú／Santander／BB で共通する規則をもとにした最善の推測です。未検証のパスには、ソース内で TODO(verify) のフラグを付けています。

オンボーディング済みの加盟店が検証し、ポータルの仕様に合わせてパスを修正するまでは、0.1.x の間は正確なバージョンに固定してください。

ツール（22）

ツール	目的
get_oauth_token	Bradesco Developer Portal の OAuth2 client_credentials ベアラートークンを発行するか、キャッシュ済みのトークンを返します。
send_pix	加盟店の Bradesco 口座から Pix の送金を開始します。
create_pix_qr	QR コード付きの動的 Pix 請求（cob）を作成します。
get_pix	BCB の endToEndId（E）を指定して Pix 取引を取得します。
resolve_dict_key	Pix 送金の前に DICT キー（CPF、CNPJ、メールアドレス、電話番号、EVP）を解決し、所有者の口座情報を取得します。
refund_pix	受け取り済みの Pix を返金（devolução）します。
create_boleto	Bradesco Cobrança 経由で boleto を発行します。
get_boleto	Bradesco 識別子（id または nosso_numero）を指定して boleto を取得します。
cancel_boleto	支払い前に未決済の boleto を取り消し（baixa）します。
get_statement	指定期間の口座明細の取引を取得します。
arrecadacao_pay	Bradesco Arrecadação 経由で公共料金、税金、または公共サービス料金を支払います。
list_pix_received	指定期間に加盟店が受け取った Pix 取引を一覧表示します。
create_pix_due_charge	期日付きの Pix 請求（cobv）を作成します。分割払いと予約済みの請求書でよく使用されます。
get_pix_due_charge	txid を指定して Pix の期日付き請求（cobv）を取得します。
update_pix_due_charge	Pix の期日付き請求（cobv）を更新します。支払い前に金額、期日、割引、または債務者を変更できます。
register_dict_key	Bradesco の加盟店口座を参照する DICT キー（CPF、CNPJ、メールアドレス、電話番号、EVP）を登録します。
delete_dict_key	Bradesco の加盟店口座を参照する DICT キーを削除（リンク解除）します。
list_boletos	ステータスと発行期間／支払期日で絞り込み、加盟店が発行した boleto を一覧表示します。
get_boleto_pdf	boleto の PDF を base64 形式でダウンロードします。
get_account_balance	加盟店口座の現在の利用可能残高（saldo disponível）を取得します。
transfer_ted	加盟店口座から受取人の銀行口座へ TED（同一 Bradesco 内の場合は TEF）送金を実行します。
pay_tax_darf	Bradesco Arrecadação 経由で連邦税（DARF）または組合費（GRU）を支払います。

インストール

npm install @codespar/[email protected]

環境

BRADESCO_CLIENT_ID="..."       # OAuth client_id from Bradesco's Developer Portal
BRADESCO_CLIENT_SECRET="..."   # OAuth client_secret
BRADESCO_CERT_PATH="/abs/path/to/client.crt"   # mTLS client certificate
BRADESCO_KEY_PATH="/abs/path/to/client.key"    # mTLS private key
BRADESCO_ENV="sandbox"                          # or "production" (default: sandbox)

認証

すべての呼び出しで、次の 2 つの要素が両方必要です。

1. OAuth2 client_credentials — サーバーはトークンエンドポイントを呼び出し、有効期限の約 60 秒前までベアラートークンをキャッシュし、下流の呼び出しに Authorization: Bearer <token> を付与します。
2. mTLS — BACEN は Pix v2 に相互 TLS を義務付けており、Bradesco はすべての製品ファミリーでこれを適用しています。サーバーは設定したパスからクライアント証明書と秘密鍵を読み込み、Node の https.Agent を構築して、すべてのリクエストをこれ経由で送信します。

加盟店契約の締結後、Bradesco Developer Portal から証明書と鍵のバンドルを取得します。これらは OAuth 認証情報とは別のものです。

ベース URL

• 本番環境：https://proxy.api.prebanco.com.br（Bradesco の標準外部プロキシ）
• サンドボックス：https://apihom-bradescorip.bradesco.com.br（ホモロゲーション環境）

どちらのホストにも TODO(verify) が付いています。一部の製品ファミリーでは Bradesco が加盟店ごとのサブドメインを提供しており、正確なホモロゲーション環境のホストが異なる可能性があるためです。ポータルで提供された環境が異なる場合は、フォークして BASE_URL を上書きしてください。

実行

# stdio (default)
npx @codespar/mcp-bradesco

# HTTP transport
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-bradesco

注意事項

• パスは未検証です。 src/index.ts の TODO(verify) マーカーを確認してください。オンボーディング済みの加盟店は、ポータルで発行された OpenAPI 仕様に照らして検証し、プルリクエストを作成してください。
• ベース URL は推定値です。 上記を参照してください。提供された環境が異なる場合は上書きしてください。
• Arrecadação のバーコード検証は、このアルファ版ではサーバー側で行われます。クライアント側の mod-10／mod-11 チェックはまだありません。

エンタープライズ

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

ライセンス

MIT