गाइड

अपने बैंक को Codex CLI से कैसे जोड़ें

5 मिनट read
Direct answer: ~/.codex/config.toml में एक [mcp_servers.bankbridge] table जोड़ें जिसमें url = "https://bankbridge.money/api/mcp" और bearer_token_env_var = "BANKBRIDGE_API_KEY" हों, फ़ाइल के top level पर experimental_use_rmcp_client = true सेट करें, फिर अपनी bbk_ key export करें और Codex को restart करें। सभी 11 BankBridge tools लोड होने की पुष्टि के लिए session के अंदर /mcp चलाएँ।

Codex MCP को थोड़ा अलग तरीके से करता है

यदि आपने पहले Claude Desktop या Cursor में MCP servers जोड़े हैं, तो आप JSON edit करते आए हैं। Codex CLI JSON का उपयोग नहीं करता। इसकी config ~/.codex/config.toml में रहती है, और MCP servers [mcp_servers.<name>] tables में जाते हैं, प्रति server एक table।

एक दूसरी बात है। Codex दो तरह के MCP servers को support करता है: local stdio servers जिन्हें वह child processes के रूप में spawn करता है (आप एक command और args देते हैं), और remote streamable-HTTP servers जिनसे वह network पर जुड़ता है (आप एक url देते हैं)। BankBridge remote किस्म का है, एक hosted server जिस पर आप बस point करते हैं। और remote servers अभी एक feature flag के पीछे बैठे हैं। flag छूटा तो Codex चेतावनी तक दिए बिना शून्य tools लोड करता है।

OpenAI के docs इस तंत्र को कवर करते हैं लेकिन पूरे काम करते उदाहरणों पर कम हैं, इसीलिए शायद आप यहाँ हैं। पूरा setup TOML की चार lines और एक environment variable है।

BankBridge API key लें

BankBridge एक hosted MCP server है जो agents को आपके live बैंक डेटा तक read-only access देता है। bankbridge.money पर अपने email से sign up करें (magic link, कोई password नहीं), फिर dashboard से एक बैंक जोड़ें।

link flow एक सुरक्षित, बैंक-प्रदत्त UI के अंदर चलता है। आप अपना संस्थान चुनते हैं, वहाँ sign in करते हैं, और read-only access को approve करते हैं। BankBridge एक encrypted access token store करता है, आपका बैंक password कभी नहीं, और आपका कोई भी वित्तीय डेटा हमारे servers पर cache नहीं किया जाता। Codex द्वारा पूछा गया हर सवाल live fetch से जवाब पाता है।

एक बैंक जुड़ जाने पर, एक API key बनाएँ। यह bbk_ से शुरू होती है और केवल एक बार दिखाई जाती है, इसलिए इसे अभी copy करें। क़ीमत $5/mo प्रति जुड़े बैंक है, कभी भी cancel करें।

config.toml एंट्री

~/.codex/config.toml खोलें। यदि फ़ाइल अभी मौजूद नहीं है, तो इसे बनाएँ। यह जोड़ें:

experimental_use_rmcp_client = true
[mcp_servers.bankbridge]
url = "https://bankbridge.money/api/mcp"
bearer_token_env_var = "BANKBRIDGE_API_KEY"

तीन बातें जानने योग्य हैं। पहली, experimental_use_rmcp_client = true एक top-level setting है। इसे किसी भी [section] header से ऊपर आना चाहिए। TOML हर key को उस table को assign करता है जिसके नीचे वह दिखाई देता है, इसलिए यदि flag [mcp_servers.bankbridge] के अंदर पहुँच जाता है, तो Codex इसे एक यादृच्छिक server option मानता है और आपका remote server कभी लोड नहीं होता।

दूसरी, url BankBridge के hosted endpoint की ओर इशारा करता है। install करने के लिए कुछ नहीं है, कोई npx wrapper नहीं, कोई local process जिसे संभालना पड़े।

तीसरी, bearer_token_env_var key को ख़ुद रखने के बजाय एक environment variable को नाम देता है। Codex असली secret आपकी shell से पढ़ता है, जो इसे उस फ़ाइल से बाहर रखता है जिसकी आदत public dotfile repos में पहुँचने की है।

अपनी shell में key export करें

एक line:

export BANKBRIDGE_API_KEY="bbk_your_key_here"

इसे उस terminal में चलाएँ जहाँ आप Codex launch करेंगे, और इसे ~/.zshrc या ~/.bashrc में जोड़ें ताकि नई shells को भी यह मिल जाए। key को env var में रखने से rotation आसान हो जाता है: export बदलें, TOML को छोड़ दें। अगर कभी ज़रूरत पड़े तो हमारे पास key rotate करने पर एक छोटा गाइड है।

सभी 11 tools लोड होने की पुष्टि करें

codex के साथ एक नया session शुरू करें। TUI के अंदर, /mcp टाइप करें। Codex हर configured server को उन tools के साथ सूचीबद्ध करता है जो वह exposed करता है। हाल के builds में एक codex mcp list subcommand भी है जिसे आप बिना session शुरू किए shell से चला सकते हैं।

आप 11 tools के साथ bankbridge ढूँढ रहे हैं: list_accounts, get_account, list_transactions, search_transactions, get_spending_summary, get_recurring_charges, get_monthly_cashflow, get_merchant_history, list_categories, list_holdings, और list_investment_transactions।

फिर इससे कुछ असली पूछें:

इस हफ़्ते मैंने कितना ख़र्च किया?

Codex को get_spending_summary या list_transactions call करना चाहिए और आपके असली account से आँकड़ों के साथ वापस आना चाहिए। कोई sync step नहीं है और कोई snapshot नहीं; हर जवाब उसी क्षण live fetch किया जाता है जब आप पूछते हैं।

यदि Codex शून्य tools लोड करे

failure mode चुप है, जो इसे crash से ज़्यादा परेशान करता है। इन पर क्रम से काम करें।

flag गायब है या ग़लत जगह पर है। दस में से नौ बार यही कारण होता है। experimental_use_rmcp_client = true config.toml के बिल्कुल top पर, हर [section] से ऊपर होना चाहिए। server block के अंदर यह कुछ नहीं करता।

key Codex के environment में नहीं है। Codex startup पर bearer_token_env_var को resolve करता है, इसलिए किसी दूसरे terminal tab से किया गया export, या जो आपने .zshrc में जोड़ा पर कभी source नहीं किया, दिखाई नहीं देगा। launch करने से ठीक पहले उसी shell में echo $BANKBRIDGE_API_KEY चलाएँ।

आपने JSON paste कर दिया। Claude Desktop या Cursor docs से snippets TOML के रूप में parse नहीं होंगे। यदि Codex config फ़ाइल के बारे में शिकायत करता है, या चुपचाप इसे नज़रअंदाज़ करता है, तो भटके हुए braces और colons देखें।

Codex पुराना है। Streamable-HTTP MCP support अपेक्षाकृत नया है। npm install -g @openai/codex से upgrade करें (या brew upgrade codex यदि आपने Homebrew से install किया था) और फिर से try करें।

एक बार जुड़ने के बाद क्या पूछें

कुछ शुरुआती बिंदु जो tools पर साफ़-साफ़ मैप होते हैं:

मेरे recurring charges क्या हैं, मासिक लागत से क्रमबद्ध?
पिछले महीने मैंने किन merchants के साथ सबसे अधिक ख़र्च किया?
जून के लिए मेरी आय की मेरे ख़र्चों से तुलना करें।

डिज़ाइन से सब कुछ read-only है। पैसा हिलाने, bills चुकाने, या trades लगाने के लिए कोई tools नहीं हैं, इसलिए किसी उत्सुक agent का blast radius ठीक शून्य dollars है। और key Codex-specific नहीं है: वही bbk_ key Claude Code, Gemini CLI, Cursor, और अन्य MCP hosts में काम करती है जिनके बारे में हम बताते हैं, इसलिए आपके दूसरे agent को जोड़ने में लगभग तीस सेकंड लगते हैं।

FAQ

Codex CLI MCP server config कहाँ देखता है?

~/.codex/config.toml में। हर server को अपना [mcp_servers.<name>] table मिलता है। Local stdio servers command और args keys का उपयोग करते हैं; BankBridge जैसे remote streamable-HTTP servers url का उपयोग करते हैं, साथ में authentication के लिए bearer_token_env_var। यह फ़ाइल तब तक मौजूद नहीं होती जब तक आप इसे बनाते नहीं।

Server जोड़ने के बाद Codex शून्य MCP tools क्यों दिखाता है?

लगभग हमेशा इसलिए क्योंकि experimental_use_rmcp_client = true गायब है या ग़लत जगह पर है। इसे config.toml के top level पर, किसी भी [section] header से ऊपर रहना चाहिए। Remote HTTP MCP servers इस flag के पीछे हैं, और इसके बिना Codex बिना किसी error message के उन्हें छोड़ देता है।

क्या Codex से BankBridge access read-only है?

हाँ। सभी 11 tools डेटा पढ़ते हैं: balances, transactions, spending summaries, recurring charges, cashflow, merchant history, categories, और investment holdings। Transfers, payments, या trades के लिए कोई tools नहीं हैं, इसलिए BankBridge से जुड़ा कोई भी agent आपका पैसा नहीं हिला सकता।

Codex CLI के साथ BankBridge की क़ीमत क्या है?

$5 प्रति माह प्रति जुड़े बैंक, चाहे कितने भी agents इसका उपयोग करें। वही bbk_ key Codex CLI, Claude Code, Gemini CLI, Cursor, और हर दूसरे MCP host में काम करती है। dashboard से कभी भी cancel करें और billing रुक जाती है।

क्या यह Codex Cloud के लिए भी काम करता है?

यह गाइड local Codex CLI को कवर करता है, जो ~/.codex/config.toml पढ़ता है। OpenAI का cloud-hosted Codex (GitHub-connected वाला) MCP servers को अपनी settings में per environment configure करता है। BankBridge वहाँ भी काम करता है; endpoint और bearer key वही हैं।

क्या मैं API key को config.toml से बाहर रख सकता हूँ?

यहाँ यही default है। bearer_token_env_var Codex से कहता है कि key को एक environment variable से पढ़े, इसलिए config.toml में कभी secret नहीं होता। अपनी shell profile में BANKBRIDGE_API_KEY export करें, और जब आप key rotate करें तो केवल export बदलें।