mcp-banco-do-brasil

Name: mcp-banco-do-brasil
Author: codespar

ローカル

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

リポジトリ

mcp-banco-do-brasil について

mcp-banco-do-brasil は、ブラジルの Banco do Brasil の API 向け MCP サーバーで、Pix、ボレト（Cobrança）、当座預金口座や明細の照会に対応します。決済代行業者を介さずに銀行と直接連携する加盟店に向いています。現在はアルファ版で、一部のエンドポイントパスは公式仕様で未検証です。

主な機能

01Pix 即時請求の作成・照会・返金
02DICT キーの照会・登録・削除
03ボレトの発行・照会・取消
04当座預金口座の残高と明細の取得
05OAuth2 クライアント認証とオプションの mTLS

活用シーン

01BB を通じた Pix 決済用 QR コードの発行
02期間指定による当座預金口座の入出金確認
03Pix 送信前の受取人 DICT キーの確認

MCP 対応

本プロジェクトは MCP サーバーであり、create_pix_cob、register_boleto、get_statement など BB 関連の 13 個のツールを MCP クライアントに公開します。

設定

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

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-banco-do-brasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "<BB_CLIENT_ID>",
        "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
        "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>",
        "BB_CERT_PATH": "<BB_CERT_PATH>",
        "BB_KEY_PATH": "<BB_KEY_PATH>",
        "BB_ENV": "<BB_ENV>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-banco-do-brasil

設定が必要な環境変数

BB_CLIENT_IDBanco do Brasil OAuth client_id issued via developers.bb.com.br after contract onboarding.

BB_CLIENT_SECRETシークレットBanco do Brasil OAuth client_secret.

BB_DEVELOPER_APP_KEYシークレットBB Developer App Key (gw-dev-app-key) — appended as a query param on most BB API calls.

BB_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2 in production.

BB_KEY_PATHシークレットAbsolute path to the mTLS private key (.key or .pem).

BB_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codespar/mcp-banco-do-brasil0.1.0-alpha.5stdio

ツール

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

パラメーター	型	必須	説明
txid	string	いいえ	任意の加盟店指定 txid（英数字 26～35 文字）。省略すると BCB が割り当てます。
payer	object	いいえ	支払者の識別情報（CPF/CNPJ + 氏名）
payer.name	string	いいえ
payer.document	string	いいえ	CPF または CNPJ の数字のみ
amount	string	はい	BRL の主要単位で表した金額。例：'99.90'
dict_key	string	はい	受取人の DICT キー — 加盟店が所有するキーである必要があります
expires_in	number	いいえ	QR コードの有効期間（秒、デフォルトは 3600）
description	string	いいえ	支払者に表示される説明（solicitacaoPagador）

詳細

@codespar/mcp-banco-do-brasil

Banco do Brasil（ブラジル最大の公的銀行）向けのMCP サーバーです。

BBは、Pix、Cobranças、Conta-Corrente、Open Finance、Arrecadaçãoにわたり、国内でも特に幅広い公的銀行APIを提供しています。Pixやボレートを大量に処理する加盟店は、PSPを介さずBBと直接連携します。

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

BBのDeveloper Portalは契約締結が利用条件です。完全なOpenAPI仕様は、加盟店の登録手続きが完了した後にのみ表示されます。PixのパスはBACEN Pix v2標準に準拠しています。ボレート、口座、明細のパスは、BBの公開マーケティングページと同業他社（Itaú、Santander、Bradesco）で共通する慣例に基づく推測です。検証されていないパスにはすべて、src/index.ts内でTODO(verify)のフラグが付いています。0.1.xの間は、正確なバージョンに固定してください。

ツール（13）

ツール	目的
`create_pix_cob`	QRコード付きの即時Pix請求（cob）を作成します。
`get_pix_cob`	txidを指定して、即時Pix請求を取得します。
`list_pix_cob`	日付範囲を指定して、即時Pix請求（cob）の一覧を取得します。
`create_pix_devolucao`	以前に受け取ったPixを返金（devolução）します。
`get_pix_devolucao`	endToEndIdと返金IDを指定して、Pixのdevoluçãoを取得します。
`resolve_dict_key`	Pix送金の前に、DICTキー（CPF、CNPJ、メールアドレス、電話番号、EVP）から所有者の口座データを特定します。
`register_dict_key`	加盟店が所有するBB口座にDICTキーを登録します。
`delete_dict_key`	加盟店が所有するDICTキーを削除します。
`register_boleto`	BB Cobranças経由でボレートを発行します。
`get_boleto`	nosso_numeroを指定してボレートを取得します。
`cancel_boleto`	支払い前に未払いのボレートを取り消し（baixa）ます。
`get_account_balance`	BBの当座（checking）口座の現在残高を取得します。
`get_statement`	日付範囲を指定して、BBの当座口座の取引明細を取得します。

インストール

npm install @codespar/[email protected]

環境変数

BB_CLIENT_ID="..."             # OAuth client_id from developers.bb.com.br
BB_CLIENT_SECRET="..."         # OAuth client_secret
BB_DEVELOPER_APP_KEY="..."     # gw-dev-app-key — required on most calls
BB_CERT_PATH="/abs/path/client.crt"   # mTLS cert (production only)
BB_KEY_PATH="/abs/path/client.key"    # mTLS key  (production only)
BB_ENV="sandbox"                       # or "production" (default: sandbox)
BB_BASE_URL="..."                      # optional; default api.hm.bb.com.br (sandbox) / api.bb.com.br
BB_AUTH_URL="..."                      # optional; default https://oauth.hm.bb.com.br/oauth/token (sandbox) / oauth.bb.com.br

認証

OAuth2 client_credentials — トークンエンドポイントはoauth.{env}.bb.com.brです。有効期限の約60秒前までBearerトークンをキャッシュします。
mTLS — 本番環境でのPix v2では、BACENの要件により必須です。サンドボックスでは通常TLSのみで利用できます。サンドボックスでは証明書とキーは任意ですが、本番環境では必須です。
gw-dev-app-key — BB APIゲートウェイキーです。すべての呼び出しでクエリパラメーターとして付加します。

実行

npx @codespar/mcp-banco-do-brasil

エンタープライズ

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

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.1.0-alpha.5
トランスポート: stdio
掲載日: 2026年9月27日
最終更新: 4 週間前
公式 Registry: io.github.codespar/mcp-banco-do-brasil

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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

mcp-banco-do-brasil

mcp-banco-do-brasil について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-banco-do-brasil

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

ツール（13）

インストール

環境変数

認証

実行

エンタープライズ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

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