تمكين خادم MCP البعيد في ClickHouse Cloud والاتصال به

يوضح هذا الدليل كيفية تمكين خادم MCP البعيد في ClickHouse Cloud وإعداده للاستخدام مع أدوات التطوير الشائعة.

المتطلبات الأساسية

• خدمة ClickHouse Cloud قيد التشغيل
• بيئة التطوير المتكاملة (IDE) أو أداة التطوير المعتمدة على الوكلاء التي تفضّلها

اتصل بخدمة ClickHouse Cloud التي تريد تمكين خادم MCP البعيد لها. في القائمة الجانبية اليسرى، انقر على Connect. ستُفتح نافذة تتضمن تفاصيل الاتصال.

اختر Connect with MCP:

بدّل الزر إلى وضع التشغيل لتمكين MCP لهذه الخدمة:

انسخ عنوان URL المعروض، وهو نفسه الظاهر أدناه:

https://mcp.clickhouse.cloud/mcp

اختر بيئة التطوير المتكاملة أو الأداة المناسبة أدناه، ثم اتبع تعليمات الإعداد المقابلة.

من دليل العمل الحالي، شغِّل الأمر التالي لإضافة تكوين ClickHouse Cloud MCP Server إلى Claude Code:

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

ثم شغِّل Claude Code:

claude

شغّل الأمر التالي لعرض خوادم MCP:

/mcp

حدِّد clickhouse-cloud وسجِّل الدخول عبر OAuth باستخدام بيانات الاعتماد الخاصة بك في ClickHouse Cloud.

1. انتقل إلى Customize > Connectors
2. انقر على أيقونة "+" ثم Add custom connector
3. سمِّ الموصل المخصص باسم مثل clickhouse-cloud ثم أضِفه
4. انقر على الموصل clickhouse-cloud الذي أُضيف حديثًا، ثم انقر على Connect
5. أكمِل المصادقة باستخدام بيانات اعتماد ClickHouse Cloud عبر OAuth

1. تصفّح خوادم MCP وثبّتها من متجر Cursor.
2. ابحث عن ClickHouse وانقر على "إضافة إلى Cursor" على أي خادم لتثبيته.
3. أكمل المصادقة باستخدام OAuth.

أضِف الإعداد التالي إلى .vscode/mcp.json:

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

لمزيد من التفاصيل، راجع وثائق Visual Studio Code.

حرِّر ملف mcp_config.json باستخدام التكوين التالي:

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

لمزيد من التفاصيل، اطّلع على وثائق Windsurf.

أضِف ClickHouse كخادم مخصّص. أضِف ما يلي إلى إعدادات Zed ضمن context_servers:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

بعد ذلك، من المفترض أن يطلب منك Zed المصادقة عبر OAuth عند اتصاله بالخادم للمرة الأولى. لمزيد من التفاصيل، راجع وثائق Zed.

نفّذ الأمر التالي لإضافة خادم MCP الخاص بـ ClickHouse Cloud عبر CLI:

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

بمجرد الاتصال، يمكنك التفاعل مع ClickHouse Cloud عبر مطالبات باللغة الطبيعية. فيما يلي بعض مسارات سير العمل الشائعة والأدوات التي سيستدعيها MCP client في الخلفية. للاطلاع على قائمة كاملة بالأدوات المتاحة، راجع مرجع الأدوات.

ابدأ بالتعرّف على المتاح:

اطرح أسئلة بلغة طبيعية، وسيتولى الوكيل ترجمتها إلى SQL:

لا تتيح الأداة run_select_query سوى عبارات SELECT. جميع الاستعلامات للقراءة فقط.

اطّلع على موارد ClickHouse Cloud لديك:

• ClickHouse agent skills