Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
comdirect
概要
作者による説明(英語の原文)
Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況i未計測★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: ネットショップ・決済
- 入力が必要なもの:COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
COMDIRECT_CLIENT_ID,COMDIRECT_CLIENT_SECRET,COMDIRECT_USERNAME,COMDIRECT_PASSWORD,COMDIRECT_MCP_PUSH_TAN_WAIT,COMDIRECT_MCP_UNMASK_IBANS,COMDIRECT_MCP_MASK_NAMES,COMDIRECT_ENV_FILE,COMDIRECT_MCP_CACHE_TTL,COMDIRECT_MCP_MAX_DOCUMENT_BYTES,COMDIRECT_MCP_CATEGORIES,COMDIRECT_MCP_SKIP_ELICITATION,COMDIRECT_MCP_LOG_FILE,COMDIRECT_MCP_LOG_LEVEL
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- PyPIPythonのuvのインストール(uvxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"comdirect": {
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add comdirect --env COMDIRECT_CLIENT_ID=your-value --env COMDIRECT_CLIENT_SECRET=your-value --env COMDIRECT_USERNAME=your-value --env COMDIRECT_PASSWORD=your-value --env COMDIRECT_MCP_PUSH_TAN_WAIT=your-value --env COMDIRECT_MCP_UNMASK_IBANS=your-value --env COMDIRECT_MCP_MASK_NAMES=your-value --env COMDIRECT_ENV_FILE=your-value --env COMDIRECT_MCP_CACHE_TTL=your-value --env COMDIRECT_MCP_MAX_DOCUMENT_BYTES=your-value --env COMDIRECT_MCP_CATEGORIES=your-value --env COMDIRECT_MCP_SKIP_ELICITATION=your-value --env COMDIRECT_MCP_LOG_FILE=your-value --env COMDIRECT_MCP_LOG_LEVEL=your-value -- uvx comdirect-mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"comdirect": {
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"comdirect": {
"type": "stdio",
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- comdirect API client id (or stored in the OS keychain via `comdirect-mcp configure`)
- comdirect API client secret (or stored in the OS keychain via `comdirect-mcp configure`)
- comdirect Zugangsnummer (or stored in the OS keychain via `comdirect-mcp configure`)
- comdirect PIN (or stored in the OS keychain via `comdirect-mcp configure`)
COMDIRECT_MCP_PUSH_TAN_WAITenvSeconds to wait for the push TAN approval if the client cannot show a confirmation dialogCOMDIRECT_MCP_UNMASK_IBANSenvSet to true to return counterparty IBANs unmaskedCOMDIRECT_MCP_MASK_NAMESenvSet to true to replace counterparty names with stable pseudonymsCOMDIRECT_ENV_FILEenvPath to a dotenv file with the credentials (opt-in; prefer the OS keychain)COMDIRECT_MCP_CACHE_TTLenvSeconds the server keeps bank results within a session; 0 disables the cacheCOMDIRECT_MCP_MAX_DOCUMENT_BYTESenvSize limit for postbox documents in bytesCOMDIRECT_MCP_CATEGORIESenvPath of the category rules file (default ~/.config/comdirect-mcp/categories.toml)COMDIRECT_MCP_SKIP_ELICITATIONenvSet to 1 to skip the login confirmation dialog and wait for the push TAN approval insteadCOMDIRECT_MCP_LOG_FILEenvFile the server appends its log to (default stderr)COMDIRECT_MCP_LOG_LEVELenvLog level of the server
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント mad4ms で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
ネットショップ・決済のほかのサーバーとの比較i
- このカテゴリのほかの1748件のうち0%よりスターが多い
- このカテゴリのほかの1748件のうち56%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1748件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
comdirectは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.6.1)がレジストリに届いたのは24 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは?
同じカテゴリには:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
comdirect-mcp
Read-only [MCP](https://modelcontextprotocol.io) server and typed Python client for the [comdirect REST API](https://www.comdirect.de/cms/kontakt-zugaenge-api.html). Let Claude, GitHub Copilot or a local model look at your accounts, transactions, depot and postbox. You approve the login in the photoTAN app, and no tool can move money.
[!WARNING]
Unofficial, not affiliated with comdirect. It handles your banking credentials, and every tool result goes to the
model behind your MCP client: with a cloud assistant your financial data leaves your computer. For the most
privacy use a local model. See SECURITY.md.
Warnung (auf Deutsch, weil comdirect)
Leute, hier geht es um euer Geld. Nutzt das nur, wenn ihr den Code versteht und die Risiken kennt. MIT-Lizenz: Jeder darf damit machen, was er/sie will (auch ihr, comdirect 👀), aber ohne Gewährleistung und ohne Haftung.
Transparenz: Ein Teil des Codes stammt von Opus 5.5 und gpt-6.1-sol, ich habe reviewed, getestet und weise genickt. Genau deshalb: Code verstehen.
Der Server nutzt nur lesende Endpunkte, aber Fehler passieren trotzdem: comdirect kann die API ändern, Dependencies können kompromittiert werden, und 2FA ist kein Freifahrtschein. Deshalb:
- Nur lokal auf dem eigenen Rechner nutzen, Zugangsdaten niemandem geben.
- Zugangsdaten in den OS-Schlüsselbund (
comdirect-mcp configure). Eine.enventhält das Passwort im Klartext: niemals committen. - Updates nicht blind einspielen: Version pinnen, Änderungen anschauen.
MCP-Server: Hängt ihr ihn an einen Cloud-Client, verlassen eure Daten euren Rechner und können in Logs landen. Verwendungszwecke und Dokumente können Prompt-Injections enthalten. Also nur in Umgebungen nutzen, denen ihr vertraut.
Wer seine Kontoauszüge eh schon in ChatGPT kopiert: Macht, was ihr wollt, aber auf eigene Verantwortung!
Features
- Safe login: push TAN confirmed in your client; stops before comdirect's lock after five unconfirmed challenges; revokes the session on logout and shutdown
- Credentials in the OS keychain, read-only tools with truthful annotations
- Answers on the server: cash flow and spending per month, counterparty or your own categories, subscriptions with yearly costs, portfolio allocation
- Clean data: transfers between your own accounts are kept out of spending, PayPal payments show the merchant, payment texts are cleaned up, IBANs masked
- Typed Python client for your own scripts
The API returns account transactions of the last 180 days only.
| Tool | |
|---|---|
login / logout | Start a session (push TAN) / end and revoke it |
list_accounts, list_cards, get_wealth_overview | Balances of accounts, cards and all products |
list_transactions | Individual transactions |
summarize_transactions | Income, expenses and net per month, counterparty, type or category |
find_recurring_payments | Subscriptions, contracts and standing orders |
list_depots, get_depot_positions, summarize_portfolio | Depot positions and allocation |
list_depot_transactions, list_orders, get_order, get_instrument | Securities movements, order book, security data |
list_documents, read_document | Postbox documents as text or PDF (reading marks them as read) |
Prompts: monthly_review, find_subscriptions, tax_documents. Details: Tools reference.
Quickstart
You need uv, comdirect API access (Client ID and Secret) and photoTAN Push as default TAN method.
uvx comdirect-mcp@0.6.1 configure # stores your credentials in the OS keychain
Add the server to your client, e.g. Claude Code:
claude mcp add --transport stdio --scope user comdirect -- uvx comdirect-mcp@0.6.1
or Claude Desktop, LM Studio and others:
{
"mcpServers": { "comdirect": { "command": "uvx", "args": ["comdirect-mcp@0.6.1"] } } }
Then ask, e.g. *„Welche Abos zahle ich, und was kosten sie im Jahr?“* The assistant calls login and you approve the push in the app. VS Code, Ollama and more: Configure MCP clients · step by step: Getting started · problems: Troubleshoot.
Python library
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)
See Use the Python library.
More
Documentation · CHANGELOG · CONTRIBUTING · AGENTS.md for AI coding agents · MIT License