دليل عملي

افحص رصيدك المصرفي دون مغادرة محرر الأكواد

6 دقائق read
Direct answer: لفحص رصيدك المصرفي في Cursor، أضف BankBridge بوصفه خادم MCP في ~/.cursor/mcp.json، والصق مفتاح API الذي يبدأ بـ bbk_ كرمز حامل، ثم اسأل لوحة المحادثة عن رصيد حسابك الجاري. يعمل الخادم نفسه في Windsurf (mcp_config.json) وZed (settings.json). تُجلب كل إجابة مباشرة من بنكك، للقراءة فقط، بسعر $5 شهرياً لكل بنك متصل.

لماذا تفحص رصيدك من داخل محرر أصلاً

أنت في منتصف جلسة عمل، على وشك تجديد نطاق أو ترقية خطة خادم، وتريد أن تعرف ما إذا كان حسابك الجاري يستطيع تحمّل التكلفة. التدفق القديم: افتح هاتفك، وشغّل تطبيق البنك، وانتظر تسجيل الدخول، وابحث عن الحساب المناسب، وحدّق في الرقم. التدفق الجديد: اسأل الوكيل المفتوح أمامك أصلاً.

يتحدث كل من Cursor وWindsurf وZed لغة Model Context Protocol، ما يعني أن الثلاثة قادرون على التواصل مع BankBridge، وهو خادم MCP مستضاف يمنح وكيلك وصولاً للقراءة فقط إلى بياناتك المصرفية الحية. إدخال إعداد واحد وتتحوّل عبارة "ما رصيد حسابي الجاري" إلى سؤال يستطيع محررك الإجابة عنه.

يغطي هذا الدليل ملف الإعدادات الدقيق لكل من المحررات الثلاثة، ثم مجموعة من الطلبات التي تستحق التجربة بعد الاتصال.

ما تحتاجه أولاً

ثلاثة أشياء، وتستغرق مجتمعةً نحو خمس دقائق: حساب BankBridge، وبنك متصل واحد على الأقل ($5 شهرياً لكل بنك، الإلغاء في أي وقت)، ومفتاح API. تبدأ المفاتيح بـ bbk_ وتعمل كرموز حاملة. يدعم BankBridge أيضاً OAuth 2.1 للمضيفين الذين يفضّلون تدفق تسجيل الدخول عبر المتصفح، لكن بالنسبة لمحررات الأكواد يكون المفتاح هو المسار الأبسط.

اربط بنكك من لوحة التحكم على bankbridge.money. تسجّل الدخول إلى بنكك عبر طبقة الاتصال المصرفي مباشرة، لذا لا يرى BankBridge كلمة مرور بنكك أبداً، ولا يراها محررك. حالما يظهر الاتصال نشطاً، أنشئ مفتاحاً واحتفظ به قريباً للخطوة التالية.

Cursor

يقرأ Cursor خوادم MCP من ملف JSON. لكل مشاريعك، هذا هو ~/.cursor/mcp.json في مجلد المستخدم الرئيسي. لمشروع واحد، أنشئ .cursor/mcp.json في جذر المشروع بدلاً من ذلك، وهو مفيد إذا كنت تريد الوصول المصرفي داخل، مثلاً، مستودع محاسبتك فقط.

داخل كائن mcpServers، أضف إدخالاً باسم bankbridge يحوي حقلين: رابط الخادم من لوحة تحكم BankBridge الخاصة بك، وكائن headers يحمل Authorization: Bearer متبوعاً بمفتاح bbk_. مقطع النسخ واللصق موجود على صفحة توثيق Cursor على /docs/cursor. احفظ الملف، وافتح إعدادات Cursor، وابحث عن قسم MCP، وتأكد من ظهور bankbridge بنقطة حالة خضراء وقائمة أدواته.

ثم افتح لوحة المحادثة في وضع الوكيل واسأل.

ما رصيد حسابي الجاري الآن؟

يستدعي Cursor أداة list_accounts، ويجلب BankBridge الرصيد مباشرة من بنكك، وتعود الإجابة كجملة بدل شاشة من واجهة تطبيق البنك. في المرة الأولى، سيطلب Cursor موافقتك على استدعاء الأداة، ويمكنك السماح بذلك لبقية الجلسة.

Windsurf

يحتفظ Windsurf بإعدادات MCP في ~/.codeium/windsurf/mcp_config.json. يمكنك تعديل الملف مباشرة، أو الوصول إليه عبر الواجهة: افتح إعدادات Windsurf، وتوجّه إلى قسم Cascade، وانقر خيار خوادم MCP، الذي يفتح الملف نفسه.

الشكل مطابق تقريباً لشكل Cursor. أضف إدخال bankbridge تحت mcpServers مع رابط الخادم (يسمّي Windsurf هذا الحقل serverUrl) وترويسة Authorization نفسها. المقطع الدقيق لإصدار Windsurf الذي تستخدمه موجود على /docs/windsurf.

أعد تحميل Windsurf، وافتح Cascade، وجرّب.

كم في حسابي الجاري؟

يعرض Cascade استدعاء الأداة للموافقة عليه في المرة الأولى، ثم يجيب بالرقم الحي.

Zed

لا يستخدم Zed ملف MCP منفصلاً. تعيش الخوادم في ملف settings.json الرئيسي لديك، الذي يمكنك فتحه بأمر zed: open settings. أضف كائن context_servers في المستوى الأعلى، أو وسّعه إن كان لديك واحد أصلاً، مع إدخال bankbridge.

بحسب إصدار Zed لديك، ستوجّهه إما إلى رابط BankBridge مباشرة، أو ستشغّله عبر أمر جسر صغير يمرّر إلى الخادم المستضاف. تحافظ صفحة /docs/zed على تحديث كلا البديلين مع ملاحظة تبيّن أي الإصدارات يحتاج أياً منهما. في كل الأحوال، يدخل مفتاح bbk_ الخاص بك كرمز حامل، تماماً كما في المحررين الآخرين.

حالما يلتقط Zed التغيير، افتح لوحة الوكيل واطرح سؤال الرصيد نفسه. يسرد Zed أدوات كل خادم في إعدادات اللوحة، فتتمكن من التحقق من وصول أدوات BankBridge الإحدى عشرة كلها قبل أن تسأل.

طلبات تعمل بعد الاتصال

سؤال الرصيد هو البوابة. حالما يعمل، يجيب الاتصال نفسه على معظم الأسئلة المالية اليومية دون مغادرة المحرر.

ما رصيد حسابي الجاري، وكم منه محجوز أصلاً لرسوم متكررة هذا الشهر؟
قارن رصيد الحساب الجاري الآن بالنقطة نفسها من الشهر الماضي.
كم أنفقت على AWS خلال الـ 90 يوماً الماضية؟

تحت الغطاء تستدعي هذه الطلبات أدوات مختلفة (get_recurring_charges، get_monthly_cashflow، get_merchant_history)، لكنك لست بحاجة إلى معرفة ذلك. اسأل بلغة بسيطة ويختار الوكيل الأداة الصحيحة. إن أردت مزيداً من الأفكار، فدليلنا حول أنماط الطلبات للأسئلة المالية يحتوي قائمة متجددة.

أي المحررات تستطيع الاستعلام عن بيانات مصرفية حية

للتوضيح، بما أن هذا هو السؤال الذي يبحث عنه الناس: يستطيع كل من Cursor وWindsurf وZed الاستعلام عن بيانات مصرفية حية، لأن الثلاثة مضيفو MCP، وBankBridge خادم MCP. يستطيع ذلك أيضاً Claude Code وClaude Desktop وChatGPT وGemini CLI وCodex وعشرات أخرى. نوثّق 29 تكاملاً مع مضيفين، لكل منها صفحة إعداد خاصة تحت /docs.

يختلف تنسيق الإعدادات بحسب المضيف، لكن الخادم خلفه هو الخادم نفسه. حساب BankBridge واحد، ومفتاح bbk_ واحد إن شئت، يعمل عبر كل محرر تستخدمه. غيّر المحرر الشهر القادم واصطحب اتصالك المصرفي معك. تغيير إعدادات بخمسة أسطر، لا هجرة.

ما يستطيع المحرر فعله وما لا يستطيع

كل أداة في BankBridge للقراءة فقط. لا توجد أداة تحويل، ولا أداة دفع، ولا شيء يحرّك الأموال. أسوأ ما يمكن أن يفعله وكيل مختل هو قراءة رصيدك مرتين.

ولا شيء يُخبّأ على خوادمنا أيضاً. حين يسأل Cursor عن رصيدك، يجلبه BankBridge من بنكك في تلك اللحظة ويمرّره كما هو. أغلق المحرر ولن تبقى نسخة من بياناتك المالية في أي مكان، تنتظر أن تصبح قديمة أو تُسرَّب.

مفتاح API هو الشيء الوحيد الذي يجب حمايته. عامله كأي سر آخر: يبقى ~/.cursor/mcp.json العالمي خارج مستودعاتك افتراضياً، لكن .cursor/mcp.json على مستوى المشروع يحتاج سطراً في .gitignore. إن انتهى مفتاح في مكان عام يوماً، فدوّره من لوحة التحكم، ويموت القديم فوراً وينتقل اتصالك المصرفي إلى الجديد.

FAQ

هل يستطيع Cursor فحص رصيدي المصرفي؟

نعم. أضف BankBridge بوصفه خادم MCP في ~/.cursor/mcp.json مع مفتاح API الخاص بك كرمز حامل، ثم اطلب من وكيل Cursor رصيد حسابك الجاري. يستدعي Cursor أداة list_accounts، ويجلب BankBridge الرقم مباشرة من بنكك، للقراءة فقط.

هل يدعم Windsurf وZed بيانات MCP المصرفية أيضاً؟

نعم. يقرأ Windsurf خوادم MCP من ~/.codeium/windsurf/mcp_config.json، ويهيّئها Zed ضمن context_servers في settings.json. يتصل كلاهما بخادم BankBridge المستضاف نفسه الذي يتصل به Cursor، لذا يغطي حساب واحد ومفتاح API واحد المحررات الثلاثة.

هل من الآمن ربط حساب مصرفي بمحرر أكواد؟

لا يرى المحرر أبداً بيانات اعتماد بنكك. تسجّل الدخول إلى بنكك عبر تدفق اتصال آمن، ولا يحتفظ المحرر إلا بمفتاح API قابل للإلغاء من BankBridge. جميع الأدوات للقراءة فقط، لذا لا يستطيع أي وكيل تحريك الأموال، ويمكنك تدوير المفتاح أو إلغاؤه في أي وقت.

هل يخزّن BankBridge رصيدي أو يخبّئه؟

لا. يجلب BankBridge البيانات مباشرة من بنكك في اللحظة التي يسأل فيها محررك ويمرّرها كما هي. لا شيء يُخبّأ أو يُخزّن على خوادم BankBridge، فلا توجد نسخة قديمة من بياناتك المالية باقية بعد انتهاء المحادثة.

كم يكلّف؟

BankBridge بسعر $5 شهرياً لكل بنك متصل، ويمكنك الإلغاء في أي وقت. بنك واحد متصل يعمل عبر كل مضيف MCP تستخدمه، بما في ذلك Cursor وWindsurf وZed وClaude Code وChatGPT، فلا تدفع أبداً لكل محرر.

ماذا لو قال محرري إن الخادم فشل في الاتصال؟

تحقق من ثلاثة أشياء: أن رابط الخادم يطابق لوحة تحكمك تماماً، وأن ترويسة Authorization تكتب Bearer متبوعة بمفتاح bbk_ الخاص بك مع مسافة بينهما، وأن JSON صالح. ثم أعد تشغيل المحرر، فمعظم المضيفين لا يعيدون تحميل إعدادات MCP إلا عند الإقلاع.