mcp-c6

@codespar/mcp-c6

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に 2 つのパブリック DNS リゾルバー（8.8.8.8 と 1.1.1.1）で測定したところ、baas.c6bank.com.br（本番環境）と baas-sandbox.c6bank.com.br（サンドボックス環境）は DNS で解決されません。現在、C6 の開発者ポータルには、どちらも mTLS 経由の baas-api.c6bank.info（本番環境）と baas-api-sandbox.c6bank.info（サンドボックス環境）が記載されています。このサーバーのパスと認証はこれらに対応するよう作られておらず、確認もされていません。このサーバーのツールは、どれもサービスに接続できません。パッケージは npm で非推奨となっており、参考用としてこのリポジトリに残されています。稼働中のエンドポイントをお持ちの場合は、C6_BASE_URL でサーバーの接続先を指定してください。パッケージを再び利用可能にするには、プロバイダーのドキュメントに記載されたベース URL を添えて、mcp-dev-latam で Issue を作成してください。

C6 Bank 用の MCP サーバーです。JPMorgan の支援を受ける、ブラジル有数のデジタルバンクです。

C6 はリテール口座数でブラジル最大級のデジタルバンクに数えられ、中小企業向けおよび法人向けの銀行サービスを積極的に拡大してきました。加盟店は、Pix、ボレート、口座データの各種フローを直接連携できます。

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

C6 の開発者ポータルは契約締結済みの加盟店のみ利用可能です。Pix、Cobrança、口座 API の完全な OpenAPI 仕様は、オンボーディング済みの加盟店にのみ公開されます。このサーバーのエンドポイントパスは、（a）BACEN Pix v2 標準、（b）C6 の公開マーケティングページ、（c）Itaú／Santander／Bradesco に共通する慣例に基づく推定です。検証されていないパスには、ソース内で TODO(verify) のマークが付いています。

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

ツール（14）

ツール	用途
get_oauth_token	C6 開発者ポータル用の OAuth2 client_credentials ベアラートークンを発行するか、キャッシュ済みのトークンを返します。
create_pix_cob	QR コード付きの Pix 即時請求（cob）を作成します。
get_pix_cob	txid を指定して Pix 即時請求（cob）を取得します。
list_pix_cob	日付範囲内に加盟店が登録した Pix 即時請求（cob）の一覧を取得します。
create_pix_cobv	支払期日付きの Pix 請求（cobv）を作成します。支払人が期日以降にも支払える、ボレートに似た Pix に使用します...
get_pix_cobv	txid を指定して支払期日付きの Pix 請求（cobv）を取得します。
resolve_dict_key	Pix 送金の前に、DICT キー（CPF、CNPJ、メールアドレス、電話番号、EVP）から所有者の口座データを照会します。
register_pix_key	加盟店が所有する C6 口座に、DICT キー（CPF、CNPJ、メールアドレス、電話番号、EVP）を登録します。
delete_pix_key	加盟店が所有する DICT キーを削除します。
create_boleto	C6 Cobrança 経由でボレートを発行します。
get_boleto	C6 の識別子（id または nosso_numero）でボレートを取得します。
cancel_boleto	支払い前の未決済ボレートを取り消し（baixa）します。
get_account_balance	加盟店口座の現在の残高スナップショットを取得します。
get_statement	指定期間の口座取引明細を取得します。

インストール

npm install @codespar/[email protected]

環境変数

C6_CLIENT_ID="..."        # OAuth client_id from C6's Developer Portal
C6_CLIENT_SECRET="..."    # OAuth client_secret
C6_CERT_PATH="/abs/path/to/client.crt"   # mTLS client certificate
C6_KEY_PATH="/abs/path/to/client.key"    # mTLS private key
C6_ENV="sandbox"                          # or "production" (default: sandbox)

認証

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

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

加盟店契約の締結後、C6 開発者ポータルから証明書と秘密鍵のバンドルを取得します。

実行

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

注意事項

• パスは未検証です。 src/index.ts の TODO(verify) マーカーを参照してください。オンボーディング済みの加盟店は、ポータルから提供された OpenAPI 仕様と照合して検証し、PR を作成してください。
• サンドボックスのホスト名は推定です。 C6 は加盟店ごとにサンドボックスのサブドメインを発行します。割り当てられたサンドボックス URL と異なる場合は、BASE_URL を編集して上書きしてください。

エンタープライズ

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

ライセンス

MIT