mcp-open-finance

@codespar/mcp-open-finance

Open Finance Brasil 向け MCP サーバー — 口座、取引、同意のためのオープンバンキング標準

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "open-finance": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-open-finance"],
      "env": {
        "OPEN_FINANCE_BASE_URL": "https://api.institution.com.br",
        "OPEN_FINANCE_CLIENT_ID": "your-client-id",
        "OPEN_FINANCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

claude mcp add open-finance -- npx @codespar/mcp-open-finance

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "open-finance": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-open-finance"],
      "env": {
        "OPEN_FINANCE_BASE_URL": "https://api.institution.com.br",
        "OPEN_FINANCE_CLIENT_ID": "your-client-id",
        "OPEN_FINANCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

ツール（18）

ツール	用途
list_accounts	Open Finance 経由で顧客の銀行口座を一覧表示します
get_account_balance	Open Finance 経由で口座残高を取得します
list_transactions	Open Finance 経由で口座の取引を一覧表示します
get_account_overdraft_limits	Open Finance 経由で口座の当座貸越限度額（limites）を取得します
get_consent	ID で同意の詳細を取得します
create_consent	データアクセス用の新しい同意リクエストを作成します
revoke_consent	既存の同意（データまたは決済）を取り消します
list_credit_cards	Open Finance 経由でクレジットカード口座を一覧表示します
get_credit_card_bills	Open Finance 経由でクレジットカードの請求書（faturas）を取得します
get_credit_card_transactions	Open Finance 経由でクレジットカードの取引を取得します
list_loans	Open Finance 経由でローン契約（empréstimos）を一覧表示します
get_loan_payments	Open Finance 経由でローンの返済予定を取得します
list_financings	Open Finance 経由で融資契約（financiamentos）を一覧表示します
list_investments	Open Finance 経由で投資商品を一覧表示します
create_payment_consent	Open Finance 経由で決済開始の同意（例：PIX）を作成します
create_payment	認可済みの決済同意を使用して決済を開始します
get_personal_qualifications	Open Finance 経由で個人顧客の属性（収入、職業）を取得します
get_business_qualifications	Open Finance 経由で法人顧客の属性を取得します

認証

Open Finance Brasil は OAuth2 クライアントクレデンシャルを使用します。各金融機関から、それぞれのベース URL と認証情報が提供されます。

サンドボックス／テスト

サンドボックスの利用可否は金融機関によって異なります。Open Finance のサンドボックスへのアクセスについては、ご利用の金融機関にお問い合わせください。

認証情報を取得する

1. Open Finance Brasil にアクセスします
2. 参加金融機関に登録します
3. OAuth2 クライアント認証情報を取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
OPEN_FINANCE_BASE_URL	はい	金融機関の API ベース URL
OPEN_FINANCE_CLIENT_ID	はい	OAuth2 クライアント ID
OPEN_FINANCE_CLIENT_SECRET	はい	OAuth2 クライアントシークレット

ロードマップ

v0.2（予定）

• revoke_consent — データ共有の同意を取り消します
• list_payments — 開始した決済を一覧表示します
• create_payment_consent — 決済開始の同意を作成します
• initiate_payment — Open Finance 経由で決済を開始します
• get_payment_status — 決済開始のステータスを取得します

v0.3（予定）

• insurance_products — 金融機関の保険商品を一覧表示します
• pension_products — 金融機関の年金商品を一覧表示します

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• Open Finance Brasil
• Open Finance Brasil 開発者ポータル
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT