خادم MCP لـ ClickStack

يتضمن ClickStack خادم Model Context Protocol (MCP) مدمجًا يتيح لمساعدات الذكاء الاصطناعي التفاعل مع بيانات observability الخاصة بك. وبمجرد الاتصال، يمكن لمساعد ذكاء اصطناعي إجراء استعلامات على السجلات والتتبعات والمقاييس؛ وإدارة لوحات المعلومات والتنبيهات؛ واستكشاف مصادر البيانات؛ والعمل مع عمليات البحث المحفوظة — وكل ذلك باللغة الطبيعية.

يتيح لك ذلك استخدام أدوات مثل Claude Code وCursor أو أي عميل متوافق مع MCP للتحقيق في الحوادث، وإنشاء لوحات معلومات، وإدارة إعداد observability لديك من دون مغادرة بيئة التطوير.

خادم MCP متاح في أنواع نشر ClickStack التالية:

يتصل ClickStack on ClickHouse Cloud عبر نقطة نهاية MCP الخاصة بـ Cloud على https://mcp.clickhouse.cloud/clickstack، ويستخدم OAuth 2.0 للمصادقة. لا يدعم هذا الـ endpoint المصادقة باستخدام مفتاح API.

• خدمة ClickHouse Cloud قيد التشغيل مع تفعيل ClickStack
• تفعيل MCP على الخدمة — افتح Cloud Console، وانقر على Connect، ثم اختر Connect with MCP، وفعِّله باستخدام زر التبديل

https://mcp.clickhouse.cloud/clickstack

تتم المصادقة باستخدام OAuth 2.0. عندما يتصل عميل MCP الخاص بك لأول مرة، تُفتح نافذة متصفح لتسجيل الدخول باستخدام بيانات اعتماد ClickHouse Cloud الخاصة بك. ولا يلزم استخدام مفتاح API.

يتولى كل عميل تنفيذ تدفق OAuth تلقائيًا عند أول اتصال.

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

{
  "mcpServers": {
    "clickstack": {
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

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

{
  "mcp": {
    "clickstack": {
      "type": "remote",
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: https://mcp.clickhouse.cloud/clickstack

من دون ترويسة x-service-id، تُوجَّه الطلبات افتراضيًا إلى أول خدمة ClickStack تم توفيرها واستخدامها ضمن حسابك. ولاستهداف خدمة أخرى، مرّر x-service-id: <YOUR_SERVICE_ID> كترويسة في إعدادات عميل MCP.

تستخدم عمليات النشر مفتوحة المصدر وBYOC نقطة النهاية MCP المضمنة في مثيل ClickStack لديك، مع المصادقة باستخدام Bearer token.

• مثيل ClickStack قيد التشغيل (راجع النشر للاطّلاع على خيارات الإعداد)
• مفتاح الوصول الشخصي إلى API — يمكنك العثور على مفتاحك في HyperDX ضمن إعدادات الفريق → مفاتيح API → مفتاح الوصول الشخصي إلى API

يتوفر خادم MCP على المسار /api/mcp ضمن عنوان URL للواجهة الأمامية في ClickStack. على سبيل المثال، في النشر المحلي الافتراضي، يكون عنوان URL هو http://localhost:8080/api/mcp. استبدل localhost:8080 بالمضيف والمنفذ الخاصَّين بالمثيل لديك إذا كنت قد غيّرت الإعدادات الافتراضية.

يستخدم خادم MCP بروتوكول النقل Streamable HTTP مع مصادقة Bearer token.

استبدل <YOUR_CLICKSTACK_URL> بعنوان URL الخاص بالمثيل لديك (على سبيل المثال: http://localhost:8080) واستبدل <YOUR_API_KEY> بمفتاح مفتاح الوصول الشخصي إلى API الخاص بك.

claude mcp add --transport http hyperdx <YOUR_CLICKSTACK_URL>/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "mcp": {
    "hyperdx": {
      "type": "remote",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: <YOUR_CLICKSTACK_URL>/api/mcp
    headers:
      Authorization: "Bearer <YOUR_API_KEY>"

بمجرد الاتصال، سيتمكن مساعد الذكاء الاصطناعي الخاص بك من الوصول إلى مجموعة من الأدوات التي تغطي المجالات الأساسية في ClickStack. وتشمل ما يلي:

• الاستعلام عن البيانات — ابحث في السجلات والتتبعات والمقاييس واجرِ تجميعًا لها باستخدام منشئ الاستعلامات في ClickStack، أو صياغة البحث، أو Raw SQL.
• مصادر البيانات — اعرض مصادر البيانات المتاحة، واتصالات قواعد البيانات، وبُنى الأعمدة، ومفاتيح السمات.
• لوحات المعلومات — أنشئ لوحات المعلومات وحدّثها واحذفها وافحصها، بما في ذلك عناصرها.
• التنبيهات — أنشئ التنبيهات وحدّثها وافحصها، بما في ذلك سجل تقييمها.
• عمليات البحث المحفوظة — أنشئ تعريفات عمليات البحث المحفوظة القابلة لإعادة الاستخدام وحدّثها وافحصها.
• Webhooks — اعرض وجهات webhook المتاحة لإشعارات التنبيه.
• الفرق — اعرض الفرق التي ينتمي إليها المستخدم الحالي وحدد الفريق النشط.

قد تتوسع مجموعة الأدوات هذه بمرور الوقت. وسيكتشف عميل MCP الأدوات المتاحة تلقائيًا عند اتصاله.

ينطبق هذا على عمليات النشر مفتوحة المصدر وBYOC فقط. بالنسبة إلى ClickStack on ClickHouse Cloud، راجع استهداف خدمة محددة.

افتراضيًا، تعمل طلبات MCP ضمن سياق فريقك الرئيسي. إذا كنت تنتمي إلى عدة فرق، فمرّر الترويسة x-hdx-team مضبوطة على معرّف الفريق إلى جانب ترويسة Authorization. إذا لم تُمرَّر الترويسة، فسيُستخدم فريقك الرئيسي. وإذا حددت فريقًا لا تنتمي إليه، فسيُرفض الطلب بخطأ 401.

استخدم أداة عرض الفرق من عميل MCP لمعرفة الفرق التي تملك صلاحية الوصول إليها وأيّها هو النشط حاليًا.