interbanking

interbanking-mcp

独立した非公式プロジェクトです。 Interbanking S.A.との関係はなく、同社の承認も受けていません。「Interbanking」はその所有者の登録商標であり、対応するAPIを示す目的でのみ記載しています。

エージェントからInterbanking（アルゼンチン）の口座を照会するためのMCPサーバーです。 残高、過去の残高、取引明細を、コードを書かずにスペイン語で確認できます。

読み取り専用です。 資金を動かすツールはありません。これは単なる慣例ではなく設計上の決定です。任意のHTTPメソッドを受け付けるクライアントの汎用機能は、意図的にサーバーから除外しています。

インストール

インストールは不要です。起動時に自動でダウンロードされます。

Claude Code

claude mcp add interbanking \
  --env IB_CLIENT_ID=tu_client_id \
  --env IB_CLIENT_SECRET=tu_client_secret \
  --env IB_REDIRECT_URL=https://localhost \
  --env IB_CUSTOMER_ID=tu_customer_id \
  -- npx -y interbanking-mcp

Claude Desktopまたは設定ファイルを使う別のクライアント

{
  "mcpServers": {
    "interbanking": {
      "command": "npx",
      "args": ["-y", "interbanking-mcp"],
      "env": {
        "IB_CLIENT_ID": "tu_client_id",
        "IB_CLIENT_SECRET": "tu_client_secret",
        "IB_REDIRECT_URL": "https://localhost",
        "IB_CUSTOMER_ID": "tu_customer_id"
      }
    }
  }
}

認証情報はInterbanking開発者ポータルから取得します。取得方法の手順は、interbanking-api-ejemploに記載されています。

認証情報の保存場所にご注意ください。 この設定ファイルはディスク上に平文で保存されます。認証情報を貼り付ける前に、トークン管理をお読みください。

ツール

ツール	説明
listar_cuentas	利用可能な口座を銀行、種類、通貨、口座番号とともに表示します
saldos	現在の残高（会計残高と利用可能残高）を表示します。最大64日間の任意の期間を指定できます
saldos_historicos	長期間の日ごとの残高を表示します。期間は自動的に分割されます
movimientos	すべての口座の取引明細を、入金と出金の合計とともに表示します

設定後は、スペイン語で話しかけます。

• 「各口座にいくらありますか？」
• 「9月の取引明細を見せて」
• 「1月以降、Galiciaの残高はどう推移しましたか？」
• 「先週、どんな振込がありましたか？」

データ量について

movimientosとsaldos_historicosは、デフォルトで要約を返します。口座ごとの合計と、直近25件の取引明細です。1年分の期間では何千件もの記録になり、それをすべて出力すると、何のメリットもないままエージェントのコンテキストウィンドウを埋めてしまいます。すべて確認するには、*「詳細付きで」*と依頼してください。期間は短めに指定するのがおすすめです。

内部の仕組み

interbanking-clientを使用し、ポータル特有の仕様に対応しています。トークンのパラメーターはリクエストボディではなくクエリー文字列に指定すること、serviceヘッダーにはhttps://を含める必要があること、customer-idはクエリーパラメーターであること、取引明細には残高とは異なるベースURLを使うことなどです。これらはすべてinterbanking-api-ejemploに記載されています。

開発

npm install
npm run check
npm test

手動でテストするには：

npx @modelcontextprotocol/inspector node server.js

プライバシー

あなたの認証情報を使ってあなたのマシン上で動作し、接続先は組織のみです。情報を収集したり、どこかに送信したりすることはありません。詳細はPRIVACY.mdをご覧ください。

サポート

現状のまま公開しています。問い合わせはリポジトリのissueからお願いします。回答の期限は設けておらず、対応できるときに返答します。メールや電話によるサポートはありません。

サードパーティのAPIは予告なく変更され、動作しなくなることがあります。専門的な助言ではありません。利用者ご自身の責任でご利用ください。

役に立った場合

⭐ リポジトリにスターを付けるか、コーヒーをおごってください。

（メッセージを送って、話をするのも歓迎です。）

ライセンス

MIT