خادم MongoDB MCP: الأدوات، والإعداد، وسبب كون وضع القراءة فقط هو الخيار الافتراضي الأمثل

ما هو خادم MongoDB MCP

يقوم خادم MongoDB MCP بعرض قاعدة بيانات MongoDB كأدوات يمكن لوكيل الذكاء الاصطناعي استدعاؤها. بروتوكول سياق النموذج (Model Context Protocol) هو المعيار المفتوح الذي يتيح للوكلاء اكتشاف واستدعاء الأدوات في الأنظمة الخارجية؛ ويقوم هذا الخادم بتحويل عمليات قاعدة البيانات إلى تلك الأدوات.

تصف وثائق TrueFoundry هذا الخادم بناءً على القدرات وليس أسماء الوظائف، وهذا هو النهج الذي سنتبعه في وصفنا:

يختلف هذا الخادم هيكلياً عن خوادم MCP الخاصة بـ GitHub أو Notion؛ فبينما تقوم تلك الخوادم بتغليف واجهة برمجة تطبيقات (SaaS) بنموذج أذونات خاص بها وتوفر إمكانية التراجع عن الإجراءات، يقوم هذا الخادم بتغليف اتصال برنامج تشغيل قاعدة البيانات: أي أن الأدوات يمكنها تنفيذ كل ما يسمح به سلسلة الاتصال. كما أن MongoDB ليس مدرجاً في الكتالوج المُدار لـ TrueFoundry، لذا فإن إعداد mongodb mcp يتطلب جهداً أكبر مقارنة بعمليات التكامل التي تتم بنقرة واحدة.

ما الذي يفعله الوكلاء به فعلياً

تكمن القيمة الحقيقية في ربط الأدوات ببعضها البعض:

• تصحيح أخطاء بيئة الإنتاج. عند ورود تذكرة تفيد بأن طلب أحد المستخدمين لم يظهر، يقوم الوكيل بفحص مخطط الطلبات، والاستعلام عن مستندات ذلك المستخدم، ثم يبلغ بأن السجل موجود بالفعل ولكنه يفتقر إلى حقل الحالة الذي تتطلبه واجهة المستخدم.
• تحليل المخططات (Schema archaeology). عندما يتولى مطور مسؤولية خدمة تفتقر إلى قاموس بيانات، يقوم الوكيل باستعراض المجموعات، وأخذ عينات من المستندات، ووصف البيانات المخزنة فعلياً مقارنة بما يدعيه الكود البرمجي.
• مراجعة الفهارس. سرد الفهارس في مجموعة بيانات نشطة، ومقارنتها بأنماط استعلامات التطبيق، وتحديد الاستعلامات التي لا تدعمها أي فهارس.
• فحوصات جودة البيانات. حصر المستندات التي تخالف القواعد الثابتة، مثل الحقول المفقودة، أو المراجع اليتيمة، أو الطوابع الزمنية غير المنطقية.

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

لماذا يؤدي الاتصال المباشر إلى مشاكل على مستوى الفريق

أن يقوم مهندس واحد بتوجيه عميل MCP محلي إلى بيئة الاختبار (staging) هو أمر مقبول، لكن تكرار النمط نفسه في بيئة الإنتاج ليس كذلك.

أدوات الكتابة لا توفر خيار التراجع. إذا قام وكيل (agent) بحذف جدول في مستودع بيانات، يمكنك إعادة تشغيل خط المعالجة. أما إذا حذف مجموعة بيانات يعتمد عليها MongoDB في حركة المرور المباشرة، فسيتعين عليك الاستعادة من نسخة احتياطية، وقبول فقدان البيانات منذ آخر لقطة، وتبرير الانقطاع. حذف الفهرس أكثر دقة وضرراً على المدى القصير: لا تظهر أي أخطاء، لكن أداء التطبيق يتدهور بشكل مفاجئ وصامت.

قيام الوكيل بكتابة استعلاماته الخاصة يمثل مخاطرة على الأداء. الوكلاء لا يعرفون فهارسك. عند سؤال النموذج "كم عدد المستخدمين الذين سجلوا في الربع الأخير؟"، سيقوم النموذج بكل سرور بالتصفية بناءً على حقل غير مفهرس، وسيقوم MongoDB بمسح المجموعة بالكامل للإجابة. في مجموعة بيانات صغيرة، لا يذكر هذا التأثير، لكن في مجموعة كبيرة وعلى خادم مخصص لحركة مرور الإنتاج، فإنه يتنافس مع الطلبات الحقيقية على موارد الإدخال والإخراج (IOPS) والذاكرة. استعلام سيئ في مستودع البيانات يكلف زيادة في الفاتورة، أما هنا فإنه يكلف تأخيراً يلمسه المستخدم.

سلسلة الاتصال هي نموذج الصلاحيات. لا توجد شاشة موافقة، ولا تحديد نطاق لكل مستخدم، ولا صلاحيات يمكن إلغاؤها؛ هو اعتماد واحد يستخدمه كل استدعاء. إذا كان لديه صلاحية الكتابة، فإن كل طلب من الوكيل يمتلك صلاحية الكتابة.

حقن الأوامر (Prompt injection) يصل إلى أبعد من المعتاد. الوكيل الذي يقرأ المستندات ويمتلك أدوات الكتابة يمكن توجيهه من خلال تلك المستندات نفسها. إذا قرأ الوكيل حقلاً يحتوي على تعليمات أثناء مهمة تصحيح أخطاء، فقد يُطلب منه تعديل سجل بدلاً من شرحه. الخطأ يكمن في منح أدوات الكتابة لاتصال مخصص لمهام القراءة.

لا شيء مما سبق يعارض ربط MongoDB، بل هو حجة لوجود طبقة تحكم أمامه — أي بوابة MCP.

Want to try it on a real cluster?

Register your MongoDB MCP server on TrueFoundry, disable every write tool, and hand your team a genuinely read-only database agent.

Get started free

ربط خادم MongoDB MCP عبر TrueFoundry

توضح المستندات كيفية تشغيل خادم ذاتي مسجل كـ MCP عن بُعد، وذلك عبر أربع خطوات.

الخطوة 1 — إنشاء سلسلة اتصال مخصصة لـ Atlas. في Atlas، افتح قاعدة البيانات (Database) ← اتصال (Connect) ← برامج التشغيل (Drivers) وانسخها. أنشئ مستخدم قاعدة بيانات مخصص تحت الوصول إلى قاعدة البيانات (Database Access) مع منح الحد الأدنى من الصلاحيات. توضح المستندات بدقة ما يعنيه الحد الأدنى لعمل الوكيل: وصول للقراءة فقط لسير عمل الاستكشاف. يُعد هذا أقوى إجراء تحكم في الإعداد، لأن MongoDB هي من تفرض هذه القيود وليس حزمة الوكيل؛ فالمستخدم الذي يمتلك صلاحية القراءة فقط لا يمكنه حذف مجموعة بيانات حتى في حال فشل جميع عناصر التحكم في البوابة.

الخطوة 2 — تشغيل خادم MCP. قم بنشره على TrueFoundry أو على بنيتك التحتية الخاصة مع ضبط سلسلة الاتصال كـ MDB_MCP_CONNECTION_STRING. بالنسبة لإصدار stdio المستضاف، اضبط نفس المتغير واحتفظ ببيانات الاعتماد في مخزن سري، وليس بشكل مباشر داخل الكود.

الخطوة 3 — السماح بالوصول إلى الشبكة. تحظر Atlas المصادر غير المعروفة، لذا أضف عنوان IP الخاص بالخروج (egress IP) لنشرك تحت الأمان (Security) ← الوصول إلى الشبكة (Network Access). الخادم الذي يبدأ تشغيله بشكل سليم ولكنه يواجه مهلة زمنية (timeout) عند كل استدعاء، يكون السبب في الغالب هو هذا الإعداد.

الخطوة 4 — تسجيل الرابط (URL). في بوابة MCP (MCP Gateway)، انقر على إضافة خادم واختر اتصل بأي خادم MCP عن بُعد.

املأ الاسم (أحرف صغيرة، أرقام، شرطات — يظهر في عناوين URL)، و اسم العرضالاختياري، و الوصف، و رابط URL الخاص بخادمك قيد التشغيل، و المتعاونون، و بيانات المصادقة.

كيف تعمل المصادقة فعلياً

من المهم توخي الدقة، لأن MongoDB لا يتبع نمط OAuth الذي تفترضه معظم منشورات MCP. تفصل TrueFoundry بين واردة المصادقة (كيف يثبت العميل هويته للبوابة) من صادرة المصادقة (كيف تثبت البوابة هويتها للجهة الأعلى).

الواردة — أربع طرق:

الصادرة — هنا يختلف MongoDB عن MCP المُدار. نظرًا لأن بيانات اعتماد قاعدة البيانات موجودة في بيئة خادم MCP نفسه كـ MDB_MCP_CONNECTION_STRING، فلا يوجد تدفق رمز تفويض OAuth ولا يوجد عنوان URI لإعادة التوجيه لتسجيله. لا أحد ينقر على اتصل الآن، ولا توجد شاشة موافقة، ولا يوجد منح من جانب المستخدم لإلغائه.

بالنسبة للقفزة من البوابة إلى الخادم، فإن أنواع المصادقة هي مفتاح API، OAuth2، AWS SigV4، و تمرير الرموز المميزةيُعد مفتاح واجهة برمجة التطبيقات (API Key) الخيار العملي للخوادم ذاتية التشغيل.

وضعان. بيانات الاعتماد المشتركة — مفتاح واحد للجميع، يتم تعيينه كترويسة (header):

بيانات الاعتماد الفردية — يقدم كل مستخدم بياناته الخاصة عبر عنصر نائب Bearer {{API_KEY}} وعلامة التبويب تجاوزات المصادقة :

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

تحديد نطاق الأدوات قبل الإطلاق

تعرض علامة التبويب الأدوات كل ما يكشفه الخادم. بالنسبة لـ MongoDB، تُعد هذه أهم شاشة في وحدة التحكم.

علامة تبويب أدوات خادم MCP مع مفاتيح تبديل لكل أداة، وعناصر تحكم للتجربة والتعديل، وتفعيل الأدوات الجديدة افتراضياً، والإجراءات المجمعة

مفاتيح تبديل لكل أداة. قم بإيقاف تشغيل أداة ما وسيتم حذفها من قائمة الأدوات (tools/list) تماماً — لن يراها العملاء ولن يمكن استدعاؤها. هذا ليس مجرد تصفية على مستوى المطالبة (prompt)؛ بل الأداة تختفي تماماً.

توصيتنا هنا أكثر صراحةً مما هي عليه بالنسبة لمعظم الخوادم: عطّل إدارة المجموعات والفهارس تماماً. لا تكتفِ بوضع قيود الموافقة، بل عطّلها. فقيود الموافقة تناسب العمليات التي تُعد جزءاً مشروعاً من سير العمل وتحتاج إلى مراجعة إضافية، أما حذف مجموعة في بيئة الإنتاج فلا يُعد جزءاً من أي سير عمل للوكيل (Agent) نعتمد استخدامه. فالوكيل الذي لا يمكنه استدعاء أداة الحذف لا يمكن إقناعه بذلك، ولا يمكن توجيهه إليه عبر مستند ملغوم، ولا يمكنه الوصول إليه حتى لو قام شخص ما بالموافقة على الطلب في الساعة الثانية صباحاً.

إذا كنت بحاجة إلى مسار للكتابة، فلا تقم بتمكينه على الخادم المشترك. قم بإنشاء خادم MCP افتراضي منفصل يحتوي فقط على تلك الأدوات وامنحه صلاحيات محدودة. تؤكد ملاحظات أمان MongoDB الخاصة بـ TrueFoundry على الأمر نفسه: لا تعرض الأدوات القادرة على الكتابة إلا من خلال خوادم MCP افتراضية مخصصة.

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

الإجراء المجمع. يحول الصفوف إلى مربعات اختيار لتتمكن من تعديل العديد من الأدوات دفعة واحدة. أسرع طريق للوصول إلى وضع القراءة فقط: حدد الكل، ثم ألغِ تحديد أدوات الاستعلام والفحص، واحفظ التغييرات.

انقر على أيقونة القلم بجانب أي أداة لتجاوز طريقة عرضها:

نافذة تعديل الأداة المنبثقة مع حقل لتجاوز الوصف ومحدد لتعليقات أداة MCP لتعيينها كـ "للقراءة فقط" أو "تدميرية"

تعد الوصف (الذي يصل إلى 20,000 حرف) ميزة قيّمة للغاية هنا: أخبر النموذج أي المجموعات كبيرة وأي الحقول مفهرسة، حتى يقوم بالتصفية بناءً عليها. هذا هو أقل الحلول تكلفةً لتجنب مشكلة المسح بدون فهارس. تعليقات أداة MCP لتمييز أداة ما بـ للقراءة فقط أو تدميري، مع تعيين readOnlyHint أو destructiveHint للعملاء الذين يدعمونها.

من يمكنه فعل ماذا: أدوار المتعاونين

يرتبط التحكم في الوصول بالمستخدمين أو الفرق أو الحسابات الافتراضية عبر بُعدين: الخوادم التي يمكن للهوية الوصول إليها، والأدوات التي يمكنها استدعاؤها.

تحديث درج خادم MCP الذي يعرض المتعاونين الحاصلين على أدوار مدير خادم MCP وموافق خادم MCP

‍