mcpField
M
mcp-inter-bank

mcp-inter-bank

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

mcp-inter-bank について

@codespar/mcp-inter-bank は、ブラジルのデジタルバンク Banco Inter の MCP サーバーです。銀行 API を通じて boleto、Pix、振込、口座照合を扱うアプリケーションを想定しています。OAuth2 クライアント認証情報フローを用い、API ごとにスコープが分かれています。

主な機能

  1. 01boleto の作成、取得、一覧表示、取消
  2. 02Pix 即時請求と期限付き請求、返金
  3. 03残高、明細、PDF 明細の取得
  4. 04TED および社内振込の作成
  5. 05boleto と Pix のイベント用 Webhook 登録

活用シーン

  1. 01顧客向けの boleto および Pix 請求の作成
  2. 02口座残高の確認と明細の出力
  3. 03Webhook による Pix および boleto の状態通知の受信

MCP 対応

本プロジェクトは MCP サーバーとして動作し、請求、振込、明細、Webhook に関する 22 個の銀行関連ツールを MCP クライアントに公開します。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-inter-bank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-inter-bank"
      ],
      "env": {
        "INTER_CLIENT_ID": "<INTER_CLIENT_ID>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-inter-bank
設定が必要な環境変数
INTER_CLIENT_IDシークレットAPI key/token for inter-bank

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

パッケージ
npm@codespar/mcp-inter-bank0.2.2

ツール

22

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

パラメーター型必須説明
amountnumberはいBRL 建ての Boleto 金額
due_datestringはい期限日（YYYY-MM-DD）
payer_zipstringいいえ支払人の郵便番号（CEP）
payer_citystringいいえ支払人の市区町村
payer_namestringはい支払人の氏名
descriptionstringいいえBoleto の説明
payer_statestringいいえ支払人の州（UF）
payer_addressstringいいえ支払人の住所（番地・通り）
payer_cpf_cnpjstringはい支払人の CPF または CNPJ

詳細

@codespar/mcp-inter-bank

boletos、PIX、振込、銀行業務に対応する包括的な開発者 API を備えたブラジルのデジタル銀行、Banco Inter 向けの MCP サーバーです

npm License: MIT

クイックスタート

# Set your credentials
export INTER_CLIENT_ID="your-client-id"
export INTER_CLIENT_SECRET="your-client-secret"

# Run via stdio
npx -y @codespar/mcp-inter-bank

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-inter-bank

環境変数

変数必須説明
INTER_CLIENT_IDはいOAuth2 クライアント ID
INTER_CLIENT_SECRETはいOAuth2 クライアントシークレット
MCP_HTTPいいえHTTP トランスポートを有効にするには "true" に設定します
MCP_PORTいいえHTTP ポート（デフォルト：3000）

ツール（22）

ツール目的
create_boletoboleto bancario（銀行振込票）を作成します
get_boletoID で boleto の詳細を取得します
list_boletosフィルターを指定して boletos を一覧表示します
cancel_boletoboleto をキャンセル（支払い停止）します
get_boleto_pdfboleto の PDF をダウンロードします（base64 ペイロードを返します）
create_pixPIX 支払いを作成します
get_pixID で PIX 取引の詳細を取得します
list_pixPIX 取引を一覧表示します
create_pix_cobtxid 付きの PIX 即時請求（cob）を作成します — BR Code／コピー＆ペースト用コードを返します
get_pix_cobtxid で PIX 即時請求を取得します
list_pix_cob期間を指定して PIX 即時請求を一覧表示します（オプションで end_to_end_id フィルターを指定できます）
create_pix_cobvdueDate 付きの PIX 期限付き請求（cobv）を作成します — 有効期限のある boleto 形式の PIX です
get_pix_cobvtxid で PIX 期限付き請求（cobv）を取得します
create_pix_devolucao受け取った取引に対する PIX 返金（devolução）を作成します
list_pix_keysInter アカウントに登録されている PIX キー（chaves）を一覧表示します
get_balance口座残高を取得します
get_statement指定期間の口座取引明細を取得します
get_statement_enriched取引の詳細情報（取引相手、カテゴリ、Pix の詳細）を含む拡張取引明細を取得します
get_statement_pdf指定期間の口座取引明細を PDF としてダウンロードします（base64 ペイロード）
create_transferTED または口座内振込を作成します
get_webhook設定済みの webhook を取得します
create_webhook通知用の webhook を登録します

認証

OAuth2 クライアントクレデンシャルフローを使用します。トークンエンドポイントは /oauth/v2/token で、API ごとにスコープ付き権限が必要です。

  • Boletos：boleto-cobranca.read、boleto-cobranca.write
  • PIX：pix.read、pix.write
  • 銀行業務：extrato.read、pagamento-ted.write
  • Webhook：webhook-boleto.read、webhook-boleto.write、webhook-pix.read、webhook-pix.write

Banco Inter Developer Portal でアプリケーションを登録してください。

API リファレンス

エンタープライズ

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

認証

サーバーを起動する前に、次の環境変数を設定してください。

  • INTER_CLIENT_ID (必須、シークレット) — inter-bank の API キー／トークン

認証情報はプロバイダーの開発者ポータルで発行してください：https://developers.inter.co。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

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

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