> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> يشرح هذا الدليل كيفية تمكين ClickHouse Cloud Remote MCP واستخدامه

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

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

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

* [خدمة ClickHouse Cloud](/docs/ar/get-started/setup/cloud) قيد التشغيل
* بيئة التطوير المتكاملة (IDE) أو أداة التطوير المعتمدة على الوكلاء التي تفضّلها

<div id="enable-remote-mcp-server">
  ## تمكين خادم MCP البعيد لـ Cloud
</div>

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

اختر **Connect with MCP**:

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/1connectmcpmodal.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=744e5d063d27c1d69b4b09204c3627f8" alt="اختر MCP في نافذة Connect" size="md" width="2190" height="2082" data-path="images/use-cases/AI_ML/MCP/1connectmcpmodal.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/2enable_mcp.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=b3dcbb434349ffabcc8402552d82eb1a" alt="تمكين خادم MCP" size="md" width="1340" height="884" data-path="images/use-cases/AI_ML/MCP/2enable_mcp.webp" />

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

```bash theme={null}
https://mcp.clickhouse.cloud/mcp
```

<div id="setup-clickhouse-cloud-remote-mcp-server">
  ## إعداد Remote MCP للتطوير
</div>

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

<div id="claude-code">
  ### Claude Code
</div>

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

```bash theme={null}
claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp
```

ثم شغِّل Claude Code:

```bash theme={null}
claude
```

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

```bash theme={null}
/mcp
```

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

<div id="claude-web">
  ### واجهة الويب لـ Claude
</div>

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

<div id="cursor">
  ### Cursor
</div>

1. تصفّح خوادم MCP وثبّتها من [متجر Cursor](https://cursor.com/marketplace).
2. ابحث عن ClickHouse وانقر على "إضافة إلى Cursor" على أي خادم لتثبيته.
3. أكمل المصادقة باستخدام OAuth.

<div id="visual-studio-code">
  ### Visual Studio Code
</div>

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

```json theme={null}
{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
```

لمزيد من التفاصيل، راجع [وثائق Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

<div id="windsurf">
  ### Windsurf
</div>

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

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

لمزيد من التفاصيل، اطّلع على [وثائق Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp).

<div id="zed">
  ### Zed
</div>

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

```json theme={null}
{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
```

بعد ذلك، من المفترض أن يطلب منك Zed المصادقة عبر OAuth عند اتصاله بالخادم للمرة الأولى.
لمزيد من التفاصيل، راجع [وثائق Zed](https://zed.dev/docs/ai/mcp#as-custom-servers).

<div id="codex">
  ### Codex
</div>

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

```bash theme={null}
codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp
```

<div id="example-usage">
  ## مثال على الاستخدام
</div>

بمجرد الاتصال، يمكنك التفاعل مع ClickHouse Cloud عبر مطالبات باللغة الطبيعية.
فيما يلي بعض مسارات سير العمل الشائعة والأدوات التي سيستدعيها MCP client في الخلفية.
للاطلاع على قائمة كاملة بالأدوات المتاحة، راجع [مرجع الأدوات](/docs/ar/products/cloud/features/ai-ml/remote-mcp#available-tools).

<div id="exploring-data">
  ### استكشاف بياناتك
</div>

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

| الموجّه                                            | الأداة المستخدمة                             |
| -------------------------------------------------- | -------------------------------------------- |
| "ما المؤسسات التي يمكنني الوصول إليها؟"            | `get_organizations`                          |
| "ما قواعد البيانات المتاحة على خدمتي؟"             | `list_databases`                             |
| "اعرض لي الجداول في قاعدة البيانات `default`"      | `list_tables`                                |
| "اعرض جميع الجداول التي تبدأ أسماؤها بـ `events_`" | `list_tables` (باستخدام عامل التصفية `like`) |

<div id="running-queries">
  ### تشغيل الاستعلامات التحليلية
</div>

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

| الموجِّه                                                   | الأداة المستخدمة   |
| ---------------------------------------------------------- | ------------------ |
| "أرني أول 10 صفوف من جدول `hits`"                          | `run_select_query` |
| "ما متوسط مدة الجلسة حسب البلد خلال آخر 7 أيام؟"           | `run_select_query` |
| "كم عدد الصفوف في كل جدول ضمن قاعدة البيانات `analytics`؟" | `run_select_query` |

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

<div id="managing-services">
  ### إدارة الخدمات والبنية التحتية
</div>

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

| الموجّه                                     | الأداة المستخدم                    |
| ------------------------------------------- | ---------------------------------- |
| "اعرض جميع خدماتي"                          | `get_services_list`                |
| "ما حالة خدمة الإنتاج الخاصة بي؟"           | `get_service_details`              |
| "اعرض لي جدول النسخ الاحتياطية لهذه الخدمة" | `get_service_backup_configuration` |
| "اعرض أحدث النسخ الاحتياطية"                | `list_service_backups`             |
| "ما هي ClickPipes المُعدّة على هذه الخدمة؟" | `list_clickpipes`                  |

<div id="monitoring-costs">
  ### تكاليف المراقبة
</div>

| الموجّه                                          | الأداة المستخدم                                      |
| ------------------------------------------------ | ---------------------------------------------------- |
| "ما تكلفة مؤسستي خلال الأسبوع الماضي؟"           | `get_organization_cost`                              |
| "اعرض لي التكاليف اليومية من 1 مارس إلى 15 مارس" | `get_organization_cost` (مع `from_date` و `to_date`) |

<div id="related-content">
  ## محتوى ذو صلة
</div>

* [ClickHouse agent skills](https://github.com/ClickHouse/agent-skills)