Codex يتعامل مع MCP بشكل مختلف قليلاً
إذا سبق أن أضفت خوادم MCP إلى Claude Desktop أو Cursor، فقد كنت تحرّر JSON. Codex CLI لا يستخدم JSON. إعداداته موجودة في ~/.codex/config.toml، وخوادم MCP توضع في جداول [mcp_servers.<name>]، جدول لكل خادم.
هناك تفصيل ثانٍ. يدعم Codex نوعين من خوادم MCP: خوادم stdio محلية يُشغّلها كعمليات فرعية (تعطيه command و args)، وخوادم بعيدة عبر streamable-HTTP يتصل بها عبر الشبكة (تعطيه url). BankBridge من النوع البعيد، خادم مُستضاف تشير إليه فقط. والخوادم البعيدة حالياً خلف علامة ميزة. إن فاتتك العلامة، حمّل Codex صفر أدوات دون حتى تحذير.
وثائق OpenAI تغطي الآلية لكنها شحيحة بالأمثلة الكاملة العاملة، وربما لهذا أنت هنا. الإعداد كله أربعة أسطر من TOML ومتغير بيئة واحد.
احصل على مفتاح BankBridge
BankBridge خادم MCP مُستضاف يمنح الوكلاء وصولاً للقراءة فقط إلى بيانات بنكك الحية. سجّل في bankbridge.money بريدك الإلكتروني (رابط سحري، دون كلمة مرور)، ثم اربط بنكاً من لوحة التحكم.
يعمل تدفق الربط داخل واجهة آمنة يقدّمها البنك. تختار مؤسستك، تسجّل الدخول هناك، وتوافق على وصول القراءة فقط. يخزّن BankBridge رمز وصول مشفّراً، وليس كلمة مرور بنكك أبداً، ولا يُخزَّن أي من بياناتك المالية على خوادمنا. كل سؤال يطرحه Codex يُجاب عليه بجلب حي.
بعد ربط بنك، أنشئ مفتاح API. يبدأ بـ bbk_ ويُعرض مرة واحدة فقط، لذا انسخه الآن. التسعير $5/mo لكل بنك متصل، ألغِ في أي وقت.
مدخل 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 إعداد على المستوى الأعلى. يجب أن يظهر فوق أي رأس [section]. TOML يُسنِد كل مفتاح إلى الجدول الذي يقع تحته، لذا إن انتهى الأمر بالعلامة داخل [mcp_servers.bankbridge]، عاملها Codex كخيار خادم عشوائي ولن يُحمَّل خادمك البعيد أبداً.
ثانياً، url يشير إلى نقطة نهاية BankBridge المُستضافة. لا شيء لتثبيته، لا غلاف npx، ولا عملية محلية تعتني بها.
ثالثاً، bearer_token_env_var يسمّي متغير بيئة بدلاً من احتواء المفتاح نفسه. يقرأ Codex السر الفعلي من صدفتك، مما يُبقيه خارج ملف يميل إلى الانتهاء في مستودعات dotfile عامة.
صدّر المفتاح في صدفتك
سطر واحد:
export BANKBRIDGE_API_KEY="bbk_your_key_here"
شغّله في الطرفية التي ستُطلق منها Codex، وأضفه إلى ~/.zshrc أو ~/.bashrc كي تحصل عليه الأصداف الجديدة أيضاً. إبقاء المفتاح في متغير بيئة يجعل التدوير سهلاً: بدّل التصدير، واترك TOML كما هو. لدينا دليل قصير عن تدوير مفتاحك إن احتجت يوماً.
تأكّد من تحميل الأدوات الإحدى عشرة
ابدأ جلسة جديدة بـ codex. داخل واجهة TUI، اكتب /mcp. يعرض Codex كل خادم مُعدّ إلى جانب الأدوات التي يكشف عنها. الإصدارات الأخيرة تشحن أيضاً أمراً فرعياً codex mcp list يمكنك تشغيله من الصدفة دون بدء جلسة.
تبحث عن bankbridge مع 11 أداة: 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 ويعود بأرقام من حسابك الفعلي. لا توجد خطوة مزامنة ولا لقطة؛ كل إجابة تُجلب حية في اللحظة التي تسأل فيها.
إذا حمّل Codex صفر أدوات
نمط الفشل صامت، مما يجعله أكثر إزعاجاً من الانهيار. اعمل خلال هذه الخطوات بالترتيب.
العلامة مفقودة أو في المكان الخطأ. هذا هو السبب تسع مرات من أصل عشر. experimental_use_rmcp_client = true تنتمي إلى قمة config.toml تماماً، فوق كل [section]. داخل كتلة الخادم لا تفعل شيئاً.
المفتاح ليس في بيئة Codex. يحلّ Codex bearer_token_env_var عند البدء، لذا تصدير من تبويب طرفية مختلف، أو تصدير أضفته إلى .zshrc لكنك لم تُحمّله (source)، لن يكون مرئياً. شغّل echo $BANKBRIDGE_API_KEY في نفس الصدفة قبل الإطلاق مباشرة.
لصقت JSON. المقتطفات من وثائق Claude Desktop أو Cursor لن تُحلَّل كـ TOML. إن اشتكى Codex من ملف الإعداد، أو تجاهله بصمت، ابحث عن أقواس متعرجة ونقطتين متبقيتين.
Codex قديم. دعم MCP عبر streamable-HTTP حديث نسبياً. رقّه بـ npm install -g @openai/codex (أو brew upgrade codex إن كنت ثبّتّه عبر Homebrew) وحاول مرة أخرى.
ماذا تسأل بعد أن يعمل
بعض نقاط البداية التي تنطبق بوضوح على الأدوات:
ما هي رسومي المتكررة، مرتبة حسب التكلفة الشهرية؟
مع أي التجّار أنفقت أكثر الشهر الماضي؟
قارن دخلي بمصاريفي لشهر يونيو.
كل شيء للقراءة فقط بالتصميم. لا توجد أدوات لتحريك الأموال، دفع الفواتير، أو إجراء الصفقات، لذا نطاق تأثير أي وكيل فضولي هو صفر دولار بالضبط. والمفتاح ليس خاصاً بـ Codex: نفس مفتاح bbk_ يعمل في Claude Code و Gemini CLI و Cursor وباقي مضيفي MCP الذين نوثّقهم، لذا ربط وكيلك الثاني يستغرق حوالي ثلاثين ثانية.