BankConv

BankConv MCP サーバー

Claude、Cursor、VS Code、その他の AI アシスタントから、銀行取引明細の PDF を取引データ、CSV、OFX、QFX、QBO、Xero CSV に変換できます。

コンピューター上の明細をアシスタントに指定して、必要なものを依頼してください。分析用の取引データ、CSV、または会計ソフトでインポートできるファイルを取得できます。サーバーは PDF を BankConv にアップロードして変換が完了するまで待ち、取引データを返すか、PDF と同じ場所にファイルを保存します。

You: Convert ~/Downloads/chase-september.pdf to QBO for QuickBooks Desktop.
Assistant: Saved QBO to ~/Downloads/chase-september.qbo.

利用できる機能

• 取引データ：実際の日付、符号付き金額（入金は正、出金は負）、残高が含まれます。期首残高と合計行は除外されます。
• ファイル：CSV、OFX（Xero、Sage、MYOB、QuickBooks Online）、QFX（Quicken）、QBO（QuickBooks Desktop Web Connect。銀行のQuickBooks IDを使用）、Xero CSV（Xero独自の列形式）。
• パスワードで保護された PDF、スキャンされた明細、複数ページの明細に対応しています。

セットアップ

1. BankConv の Team → API keys で API キーを作成します（https://app.bankconv.com/teams/api-keys）。変換では、BankConv プランのページ数が使用されます。
2. BANKCONV_API_KEY にキーを設定して、アシスタントにサーバーを追加します。

Claude Code

claude mcp add bankconv -e BANKCONV_API_KEY=sk_live_your_key -- npx -y bankconv-mcp

Claude Desktop

ワンクリックで設定できます。bankconv.mcpb をダウンロードして開いてください。Claude Desktop がサーバーをインストールし、API キーの入力を求めます。

または、次の内容を claude_desktop_config.json に追加します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_key" }
    }
  }
}

Cursor、Windsurf、その他のクライアント

クライアントの MCP 設定で、同じ command、args、env を使用します（Cursor の場合は ~/.cursor/mcp.json）。

VS Code

{
  "servers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_key" }
    }
  }
}

Node.js 20 以降が必要です。

ツール

ツール	機能
convert_statement	このコンピューター上の PDF を変換します。取引データを返すか、CSV、OFX、QFX、QBO、Xero CSV を保存します（save_to を指定しない場合は PDF と同じ場所に保存）。PDF にパスワードが設定されている場合は、そのパスワードを指定します。
get_transactions	以前の変換で取得した取引データを取得します。
download_statement	以前の変換結果を CSV、OFX、QFX、QBO、Xero CSV として保存します（保存場所を指定しない場合は Downloads に保存）。
list_conversions	最近の変換とそのステータスを一覧表示します。
get_credits	現在の請求期間に残っているページ数を確認します。

プロンプトの例

• 「statement.pdf を変換して、金額の大きい支出を5件教えてください。」
• 「~/Statements/2026 にあるすべての PDF を Xero 用の OFX ファイルに変換してください。」
• 「amex-march.pdf を QuickBooks Desktop 用の QBO に変換してください。PDF のパスワードは 4821 です。」
• 「chase-sep.pdf から、9月の支出合計をカテゴリ別に集計してください。」

エージェントスキル

MCP に対応していないエージェント向けに、skills/bankconv/SKILL.md では curl を使った REST API 経由で同じワークフローを実行する方法を説明しています。

プライバシー

PDF は HTTPS 経由で BankConv にアップロードされ、そこで処理されます。チームがより長い保存期間を選択している場合を除き、PDF と変換後のファイルは24時間後に自動削除されます。より長い保存期間は48時間または72時間です。詳細については、セキュリティとデータの取り扱いをご覧ください。サーバーは指定されたファイルのみを読み取り、要求されたファイルのみを書き込みます。

設定

変数	デフォルト
BANKCONV_API_KEY	(必須)	BankConv API キー
BANKCONV_API_URL	https://bankconv.com/api/v1	API のベース URL

リンク

• BankConv · MCP サーバーのページ · API ドキュメント · 対応銀行

ライセンス

MIT