- خدمة ClickHouse Cloud قيد التشغيل
- بيئة التطوير المتكاملة (IDE) أو أداة التطوير المعتمدة على الوكلاء التي تفضّلها
- للمصادقة غير التفاعلية (headless)، مفتاح API لـ ClickHouse Cloud يمتلك صلاحية الوصول إلى المؤسسة والخدمات المطلوبة
تمكين خادم MCP البعيد لـ Cloud
اتصل بخدمة ClickHouse Cloud التي تريد تمكين خادم MCP البعيد لها. في القائمة الجانبية اليسرى، انقر على Connect. ستُفتح نافذة تتضمن تفاصيل الاتصال. اختر Connect with MCP: بدّل الزر إلى وضع التشغيل لتمكين MCP لهذه الخدمة. يتطلب تمكين MCP أو تعطيله امتلاك الصلاحيةcontrol-plane:service:manage-mcp (راجع أدوار وصلاحيات Console):
انسخ عنوان URL المعروض، وهو نفسه الظاهر أدناه:
إعداد Remote MCP للتطوير
المصادقة من بيئة غير تفاعلية
إذا كان عميل MCP يعمل على مضيف بعيد أو غير تفاعلي، بحيث يتعذّر عمليًا استخدام تدفق OAuth عبر المتصفح، فاستخدم مفتاح واجهة برمجة تطبيقات ClickHouse Cloud للمصادقة بدلًا من ذلك.- في وحدة تحكم ClickHouse Cloud، افتح مؤسستك واختر API Keys.
- أنشئ مفتاحًا يتضمن الحد الأدنى من الأدوار والأذونات اللازمة للمؤسسات والخدمات التي يحتاج عميل MCP إلى الوصول إليها، ثم نزّل معرّف المفتاح والسر الخاص به.
- على المضيف البعيد، مرّر بيانات الاعتماد عبر نظام إدارة الأسرار المعتمد لديك، ثم أنشئ قيمة تفويض HTTP Basic:
- اختر عميل MCP الذي تستخدمه وأضف خادم MCP البعيد:
- Claude Code
- Codex
- OpenCode
CH_AUTH بقيمته من البيئة عند الاتصال. شغّل Claude Code ونفّذ /mcp للتأكد من أن clickhouse-cloud متصل.راجع توثيق MCP في Claude Code للاطلاع على تفاصيل خوادم HTTP البعيدة وتهيئة الترويسات.CH_AUTH متاحًا في كل session للعميل، ولا تُثبّت مفتاح API أو الـ Secret أو قيمة CH_AUTH في نظام التحكم بالمصدر. تذكّر أن ترميز Base64 لا يُشفّر بيانات الاعتماد.
لا تتطلب طريقة المصادقة هذه بمفتاح API متصفحًا ولا تسجيل دخول منفصلًا عبر clickhousectl.
Claude Code
clickhouse-cloud وسجِّل الدخول عبر OAuth باستخدام بيانات الاعتماد الخاصة بك في ClickHouse Cloud.
واجهة الويب لـ Claude
- انتقل إلى Customize > Connectors
- انقر على أيقونة ”+” ثم Add custom connector
- سمِّ الموصل المخصص باسم مثل
clickhouse-cloudثم أضِفه - انقر على الموصل
clickhouse-cloudالذي أُضيف حديثًا، ثم انقر على Connect - أكمِل المصادقة باستخدام بيانات اعتماد ClickHouse Cloud عبر OAuth
Cursor
- تصفّح خوادم MCP وثبّتها من متجر Cursor.
- ابحث عن ClickHouse وانقر على “إضافة إلى Cursor” على أي خادم لتثبيته.
- أكمل المصادقة باستخدام OAuth.
Visual Studio Code
.vscode/mcp.json:
Windsurf
mcp_config.json باستخدام التكوين التالي:
Zed
Codex
مثال على الاستخدام
استكشاف بياناتك
تشغيل الاستعلامات التحليلية
لا تتيح الأداة
run_select_query سوى عبارات SELECT. جميع الاستعلامات للقراءة فقط.