Skip to main content
لا يتفاعل جميع المستخدمين مع ClickHouse عبر وحدة تحكم ClickHouse Cloud. فعلى سبيل المثال، يعمل كثير من المطورين مباشرةً من محررات الشيفرة المفضلة لديهم، أو عبر وكلاء CLI، أو يتصلون بقاعدة البيانات من خلال إعدادات مخصصة، بينما يعتمد آخرون على مساعدين عامّين للذكاء الاصطناعي مثل Anthropic Claude في معظم عمليات الاستكشاف. ويحتاج هؤلاء المستخدمون، وكذلك أحمال العمل القائمة على الوكلاء التي تعمل نيابةً عنهم، إلى وسيلة تتيح الوصول الآمن إلى ClickHouse Cloud وتنفيذ الاستعلامات عليه من دون إعدادات معقدة أو بنية تحتية مخصصة. تلبّي ميزة خادم MCP البعيد في ClickHouse Cloud هذه الحاجة من خلال توفير واجهة قياسية يمكن للوكلاء الخارجيين استخدامها لاسترجاع السياق التحليلي. ويُعد MCP، أو Model Context Protocol، معيارًا للوصول المنظّم إلى البيانات من قِبل تطبيقات الذكاء الاصطناعي المدعومة بنماذج اللغة الكبيرة. ومن خلال هذا التكامل، يمكن للوكلاء الخارجيين عرض قواعد البيانات والجداول، وفحص المخططات، وتشغيل استعلامات SELECT محددة النطاق وبوضع القراءة فقط. وتتم المصادقة عبر OAuth 2.0 أو مفتاح API الخاص بـ ClickHouse Cloud. كما أن الخادم مُدار بالكامل على ClickHouse Cloud، لذلك لا يلزم أي إعداد أو صيانة. وهذا يسهّل على الأدوات القائمة على الوكلاء التكامل مع ClickHouse واسترجاع البيانات التي تحتاج إليها، سواء للتحليل أو التلخيص أو توليد الشيفرة أو الاستكشاف.

​
خادم MCP البعيد مقابل خادم MCP مفتوح المصدر

توفّر ClickHouse خادمين لـMCP. يوفّر خادم MCP البعيد أوسع تكامل مع ClickHouse Cloud، بما في ذلك إدارة الخدمة، ومراقبة النسخ الاحتياطية، وإتاحة رؤية ClickPipe، وبيانات الفوترة، من دون أي بنية تحتية تحتاج إلى إدارتها. بالنسبة إلى مثيلات ClickHouse المستضافة ذاتيًا، راجع أدلة خادم MCP مفتوح المصدر.

​
تمكين خادم MCP البعيد

يجب تمكين خادم MCP البعيد على مستوى كل خدمة قبل أن يتمكن من قبول الاتصالات. في وحدة تحكم ClickHouse Cloud، افتح خدمتك، وانقر على زر Connect، ثم اختر MCP وقم بتمكينه. يتطلب تمكين خادم MCP البعيد أو تعطيله امتلاك الإذن control-plane:service:manage-mcp (راجع أدوار وأذونات وحدة التحكم). للاطلاع على خطوات مفصلة مع لقطات شاشة، راجع دليل الإعداد.

​
نقطة النهاية

بمجرد تفعيله، يصبح خادم MCP البعيد متاحًا على:

​
المصادقة

يدعم خادم MCP البعيد طريقتين للمصادقة:
  • OAuth 2.0: الطريقة الموصى بها للعملاء التفاعليين. عند اتصال عميل MCP لأول مرة، يفتح نافذة في المتصفح ليسجّل المستخدم الدخول باستخدام بيانات اعتماد ClickHouse Cloud الخاصة به. ويقتصر الوصول على المؤسسات والخدمات التي يملك المستخدم المُصادَق عليه إذنًا بالوصول إليها.
  • مفتاح واجهة برمجة تطبيقات ClickHouse Cloud: مخصص للبيئات البعيدة والبيئات عديمة الواجهة (headless) والبيئات المؤتمتة التي يتعذّر فيها استخدام تدفق OAuth عبر المتصفح. أرسل معرّف مفتاح API وسرّه باستخدام مصادقة HTTP Basic:
يخضع الوصول عبر مفتاح API للأدوار والأذونات وتاريخ انتهاء الصلاحية التي جرت تهيئتها للمفتاح. استخدم مفتاحًا مخصصًا بأدنى حد من الامتيازات، ومرّره عبر نظام لإدارة الأسرار. لا يُشفِّر ترميز Base64 بيانات الاعتماد، لذا لا تُثبِّت القيمة المُرمَّزة في نظام التحكم في الشيفرة المصدرية ولا تكشفها في السجلات. للاطلاع على مثال لتهيئة عميل MCP في بيئة عديمة الواجهة، راجع المصادقة من بيئة عديمة الواجهة.

​
الأمان

جميع الأدوات التي يتيحها خادم MCP البعيد هي للقراءة فقط. تُوسَم كل أداة بالتعليمة readOnlyHint: true في البيانات الوصفية الخاصة بها في MCP. ولا يمكن لأي أداة تعديل البيانات أو تغيير إعدادات الخدمة أو تنفيذ أي عملية مدمّرة.

​
الأدوات المتاحة

يوفّر خادم MCP البعيد 13 أداة مُصنَّفة ضمن الفئات التالية.

​
استكشاف الاستعلامات والمخطط

تمكّن هذه الأدوات الوكلاء من اكتشاف البيانات المتاحة وتشغيل استعلامات تحليلية.

​
المؤسسات

​
الخدمات

​
النسخ الاحتياطية

​
ClickPipes

​
الفوترة

​
البدء

راجع دليل الإعداد للحصول على تعليمات مفصلة خطوة بخطوة حول تمكين خادم MCP البعيد وربطه بعميل MCP.