comdirect

comdirect-mcp

comdirect REST API用の読み取り専用MCPサーバーと、型付きのPythonクライアントです。 Claude、GitHub Copilot、またはローカルモデルから、口座、取引、証券口座、郵便受信箱を確認できます。photoTANアプリでログインを承認する必要があり、資金を移動できるツールはありません。

警告

comdirectとは無関係の非公式ツールです。銀行の認証情報を扱い、各ツールの結果はMCPクライアントの背後にあるモデルに送信されます。クラウドアシスタントを使う場合、金融データはお使いのコンピューターの外に送信されます。プライバシーを最優先する場合は、ローカルモデルを使用してください。SECURITY.mdもご覧ください。

警告（comdirectのため、ドイツ語で）

皆さんのお金を扱うツールです。コードを理解し、リスクを把握したうえでのみ使用してください。MITライセンスのため、誰でも自由に利用できます（もちろん、comdirectも 👀）。ただし、無保証・免責です。

透明性について：コードの一部はOpus 5.5とgpt-6.1-solによるもので、私はレビューとテストを行い、うなずいて承認しました。だからこそ、コードを理解してください。

サーバーは読み取り専用のエンドポイントのみを使用しますが、それでも問題は起こり得ます。comdirectがAPIを変更する可能性があり、依存関係が侵害される可能性もあります。また、2FAがあれば安全というわけではありません。そのため、次の点を守ってください。

• 自分のコンピューター上でのみ使用し、認証情報を他人に渡さないでください。
• 認証情報はOSのキーチェーンに保存してください（comdirect-mcp configure）。.envにはパスワードが平文で保存されます。絶対にコミットしないでください。
• 更新を無条件に適用しないでください。バージョンを固定し、変更内容を確認してください。

MCPサーバー：クラウドクライアントに接続すると、データはお使いのコンピューターの外に送信され、ログに記録される可能性があります。取引の詳細や書類にプロンプトインジェクションが含まれている可能性もあります。信頼できる環境でのみ使用してください。

どうせ口座明細をChatGPTにコピーしているという方は、ご自由にどうぞ。ただし、自己責任でお願いします！

機能

• 安全なログイン：クライアントでプッシュ TAN を承認します。未承認のチャレンジが 5 回に達する前に停止し、ログアウト時とシャットダウン時にセッションを無効化します
• 認証情報は OS のキーチェーンに保存し、読み取り専用ツールには実態に即した注釈を付けています
• サーバー上で回答を生成：月ごと、取引先ごと、またはご自身のカテゴリごとのキャッシュフローと支出、年間コスト付きのサブスクリプション、ポートフォリオ配分
• データを整理：ご自身の口座間の振替は支出から除外し、PayPal の支払いには加盟店名を表示し、支払いの摘要を整理し、IBAN をマスキングします
• ご自身のスクリプトで使える型付き Python クライアント

API が返す口座取引は、過去 180 日分のみです。

ツール
login / logout	セッションを開始（プッシュ TAN）／終了して無効化
list_accounts、list_cards、get_wealth_overview	口座、カード、すべての商品残高
list_transactions	個々の取引
summarize_transactions	月、取引先、種類、カテゴリごとの収入、支出、差引額
find_recurring_payments	サブスクリプション、契約、定額振込
list_depots、get_depot_positions、summarize_portfolio	証券口座の保有商品と配分
list_depot_transactions、list_orders、get_order、get_instrument	有価証券の取引、注文一覧、有価証券データ
list_documents、read_document	テキストまたは PDF 形式の郵便受け書類（読み取ると既読になります）

プロンプト：monthly_review、find_subscriptions、tax_documents。詳細：ツールリファレンス。

クイックスタート

uv、comdirect API へのアクセス権（クライアント ID とシークレット）、および既定の TAN 方式として photoTAN Push が必要です。

uvx [email protected] configure   # stores your credentials in the OS keychain

クライアントにサーバーを追加します。たとえば Claude Code の場合：

claude mcp add --transport stdio --scope user comdirect -- uvx [email protected]

Claude Desktop、LM Studio などの場合：

{
  "mcpServers": {
    "comdirect": {
      "command": "uvx",
      "args": ["[email protected]"]
    }
  }
}

次に、たとえば 「どのサブスクリプションを支払っていて、年間いくらかかりますか？」 と質問します。アシスタントが login を呼び出すので、アプリでプッシュを承認してください。VS Code、Ollama などについてはMCP クライアントの設定をご覧ください。ステップごとの手順：はじめに · 問題が発生した場合：トラブルシューティング。

Python ライブラリ

from comdirect_mcp import ComdirectClient
from comdirect_mcp.utils import default_push_tan_callback

client = ComdirectClient(
    {"client_id": "...", "client_secret": "...", "username": "...", "password": "..."},
    {"push_tan_cb": default_push_tan_callback},
)
client.login()  # approve the push TAN, then press Enter
for account in client.list_accounts():
    print(account.id, account.balance, account.currency)

Python ライブラリの使用をご覧ください。

その他

ドキュメント · 変更履歴 · コントリビューション · AI コーディングエージェント向けの AGENTS.md · MIT ライセンス