> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# استخدام خادم ClickHouse MCP مع Claude Desktop

> يوضح هذا الدليل كيفية إعداد Claude Desktop مع خادم ClickHouse MCP.

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

> يوضح هذا الدليل كيفية إعداد Claude Desktop مع ClickHouse MCP server باستخدام uv
> وتوصيله بمجموعات بيانات ClickHouse التجريبية.

<Frame>
  <iframe src="https://www.youtube.com/embed/y9biAm_Fkqw?si=9PP3-1Y1fvX8xy7q" title="مشغّل فيديو YouTube" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Steps>
  <Step>
    ## تثبيت uv

    ستحتاج إلى تثبيت [uv](https://docs.astral.sh/uv/) لاتباع التعليمات الواردة في هذا الدليل.
    إذا كنت لا ترغب في استخدام uv، فستحتاج إلى تحديث إعدادات ClickHouse MCP server لاستخدام مدير حزم بديل.
  </Step>

  <Step>
    ## تنزيل Claude Desktop

    ستحتاج أيضًا إلى تثبيت تطبيق Claude Desktop، ويمكنك تنزيله من [موقع Claude Desktop](https://claude.ai/desktop).
  </Step>

  <Step>
    ## إعداد ClickHouse MCP server

    بمجرد تثبيت Claude Desktop، يحين وقت إعداد [ClickHouse MCP server](https://github.com/ClickHouse/mcp-clickhouse).
    يمكننا القيام بذلك عبر [ملف إعداد Claude Desktop](https://claude.ai/docs/configuration).

    للعثور على هذا الملف، انتقل أولًا إلى صفحة الإعدادات (`Cmd+,` على جهاز Mac)، ثم انقر على علامة التبويب `Developer` في القائمة اليسرى.
    بعد ذلك ستظهر لك الشاشة التالية، حيث ستحتاج إلى النقر على الزر `Edit config`:

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/aVaB4U557by41sEW/images/use-cases/AI_ML/MCP/claude-desktop-config.png?fit=max&auto=format&n=aVaB4U557by41sEW&q=85&s=7bf6703ecdd60939c9a2f3848d9b2bc9" alt="إعداد Claude Desktop" size="md" width="831" height="512" data-path="images/use-cases/AI_ML/MCP/claude-desktop-config.png" />

    سينقلك هذا إلى دليل يحتوي على ملف الإعداد (`claude_desktop_config.json`).
    وعند فتح هذا الملف لأول مرة، فمن المرجح أن يحتوي على المحتوى التالي:

    ```json theme={null}
    {
      "mcpServers": {}
    }
    ```

    يستخدم قاموس `mcpServers` اسم خادم MCP كمفتاح، وقاموسًا لخيارات الإعداد كقيمة.
    على سبيل المثال، سيبدو إعداد ClickHouse MCP server المتصل بـ ClickHouse Playground كما يلي:

    ```json theme={null}
    {
      "mcpServers": {
        "mcp-clickhouse": {
          "command": "uv",
          "args": [
            "run",
            "--with",
            "mcp-clickhouse",
            "--python",
            "3.10",
            "mcp-clickhouse"
          ],
          "env": {
            "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
            "CLICKHOUSE_PORT": "8443",
            "CLICKHOUSE_USER": "demo",
            "CLICKHOUSE_PASSWORD": "",
            "CLICKHOUSE_SECURE": "true",
            "CLICKHOUSE_VERIFY": "true",
            "CLICKHOUSE_CONNECT_TIMEOUT": "30",
            "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
          }
        }
      }
    }
    ```

    بمجرد تحديث الإعداد، ستحتاج إلى إعادة تشغيل Claude Desktop حتى تصبح التغييرات سارية.

    <Warning>
      بحسب الطريقة التي ثبّتَّ بها `uv`، قد يظهر لك الخطأ التالي عند إعادة تشغيل Claude Desktop:

      ```text theme={null}
      MCP mcp-clickhouse: spawn uv ENOENT
      ```

      إذا حدث ذلك، فستحتاج إلى تحديث `command` ليحتوي على المسار الكامل إلى `uv`. على سبيل المثال، إذا كنت قد ثبّتَّه عبر Cargo، فسيكون `/Users/<username>/.cargo/bin/uv`
    </Warning>
  </Step>

  <Step>
    ## استخدام ClickHouse MCP server

    بعد إعادة تشغيل Claude Desktop، يمكنك العثور على ClickHouse MCP server بالنقر على أيقونة `Search and tools`:

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/aVaB4U557by41sEW/images/use-cases/AI_ML/MCP/find-mcp-servers.gif?s=df22df5bf1d74990bf61a4aa6409d5fc" alt="العثور على خوادم MCP" size="md" width="868" height="788" data-path="images/use-cases/AI_ML/MCP/find-mcp-servers.gif" />

    <br />

    يمكنك بعد ذلك اختيار ما إذا كنت تريد تعطيل كل الأدوات أو بعضها.

    الآن أصبحنا جاهزين لطرح بعض الأسئلة على Claude، ما سيؤدي إلى استخدامه ClickHouse MCP server.
    على سبيل المثال، يمكننا أن نسأله: `What's the most interesting dataset in the SQL playground?`.

    سيطلب Claude منا تأكيد استخدام كل أداة في خادم MCP عند استدعائها لأول مرة:

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/aVaB4U557by41sEW/images/use-cases/AI_ML/MCP/mcp-permission.png?fit=max&auto=format&n=aVaB4U557by41sEW&q=85&s=d2146083256d980d51e8b4f1596b2ba6" alt="منح إذن لاستخدام أداة list_databases" size="md" width="536" height="411" data-path="images/use-cases/AI_ML/MCP/mcp-permission.png" />

    فيما يلي يمكنك رؤية جزء من محادثة يتضمن بعض استدعاءات الأدوات إلى ClickHouse MCP server:

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/aVaB4U557by41sEW/images/use-cases/AI_ML/MCP/claude-conversation.png?fit=max&auto=format&n=aVaB4U557by41sEW&q=85&s=b6590aea4880d69d185a0dd303dee2de" alt="محادثة Claude" size="md" width="1857" height="1684" data-path="images/use-cases/AI_ML/MCP/claude-conversation.png" />
  </Step>
</Steps>