Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 3/3 통과 · 내 컴퓨터에서 실행돼요
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
comdirect 키가 필요해요 (제작자 사이트에서 만들기) · 먼저 컴퓨터에 Python (uv)를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
SettingsDeveloperEdit Config
{
"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"
}
}
}
}키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
comdirect을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 comdirect을 쓰고 있다고 하거나 답에 comdirect 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 comdirect에 연결할 수 없어요
comdirect는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
A · comdirect에 연결되는 앱 쓰기
B · 온라인 쇼핑몰 및 결제에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
comdirect 키가 필요해요 (제작자 사이트에서 만들기) · 먼저 컴퓨터에 Python (uv)를 설치하세요 (한 번만)
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
claude mcp add --scope user 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-mcpEnter 전에 “your-value”를 내 키로 바꾸세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
comdirect이 목록에 있고 연결됨으로 보이면 돼요
comdirect을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 comdirect을 쓰고 있다고 하거나 답에 comdirect 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
comdirect 키가 필요해요 (제작자 사이트에서 만들기) · 먼저 컴퓨터에 Python (uv)를 설치하세요 (한 번만)
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
comdirect 설정에서 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가 비어 있어요. 내 키를 넣고 저장하세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
comdirect을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 comdirect을 쓰고 있다고 하거나 답에 comdirect 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
comdirect 키가 필요해요 (제작자 사이트에서 만들기) · 먼저 컴퓨터에 Python (uv)를 설치하세요 (한 번만)
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
comdirect 설정에서 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가 비어 있어요. 내 키를 넣고 저장하세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
comdirect을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 comdirect을 쓰고 있다고 하거나 답에 comdirect 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Claude Code
claude mcp add --scope user 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-mcpClaude Desktop (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"
}
}
}
}Cursor (~/.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"
}
}
}
}VS Code (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"
}
}
}
}COMDIRECT_CLIENT_ID 비밀 envCOMDIRECT_CLIENT_SECRET 비밀 envCOMDIRECT_USERNAME 비밀 envCOMDIRECT_PASSWORD 비밀 envCOMDIRECT_MCP_PUSH_TAN_WAIT envCOMDIRECT_MCP_UNMASK_IBANS envCOMDIRECT_MCP_MASK_NAMES envCOMDIRECT_ENV_FILE envCOMDIRECT_MCP_CACHE_TTL envCOMDIRECT_MCP_MAX_DOCUMENT_BYTES envCOMDIRECT_MCP_CATEGORIES envCOMDIRECT_MCP_SKIP_ELICITATION envCOMDIRECT_MCP_LOG_FILE envCOMDIRECT_MCP_LOG_LEVEL env이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
pypi: comdirect-mcp이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 12일 점검
레지스트리 이름이 GitHub 계정 mad4ms 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
코드 마지막 변경: 10일 전
MIT 사용
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
아직 리뷰가 없어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
입력해야 할 값: COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 10일 전 변경됐고, 최신 버전(0.6.1)은 29일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.
같은 카테고리에는: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
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.
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:
comdirect-mcp configure). Eine .env enthält das Passwort im Klartext: niemals committen.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!
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.
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.
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)
Documentation · CHANGELOG · CONTRIBUTING · AGENTS.md for AI coding agents · MIT License