اتصالات الأدوات (MCP)

Microsoft Clarity MCP Server

microsoft/clarity-mcp-server

اسأل مساعدك عن بيانات زيارات موقعك وتسجيلات الجلسات الموجودة في Clarity.

طريقة التثبيت ↓

طريقة التثبيت

macOS / Linux · ملف إعدادات Claude Desktopإعدادات للصق

استخدم طرفية macOS أو Linux لهذه الأوامر.
ثبّت Node.js وnpm أولاً بالإصدار الذي يتطلبه المشروع.
يلزم حساب للخدمة؛ تحقق من الخطة والأذونات المتاحة.
احصل على مفتاح API المطلوب من الخدمة واحتفظ به في إعداداتك المحلية.
ادمجها في الإعدادات الحالية مع الحفاظ على الأدوات والإعدادات الأخرى.
استبدل القيم المؤقتة الموضحة أدناه قبل التنفيذ أو الحفظ.
احفظ الإعدادات ثم أعد تشغيل المساعد أو المحرر أو تحميله.

ملف إعدادات Claude Desktop

ملف الإعدادات ~/Library/Application Support/Claude/claude_desktop_config.json

استبدل هذه القيم: YOUR_CLARITY_API_TOKEN

{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=YOUR_CLARITY_API_TOKEN"
      ]
    }
  }
}

مصدر الأمر ↗

إعدادات MCP في Cursorإعدادات للصق

ثبّت Node.js وnpm أولاً بالإصدار الذي يتطلبه المشروع.
يلزم حساب للخدمة؛ تحقق من الخطة والأذونات المتاحة.
احصل على مفتاح API المطلوب من الخدمة واحتفظ به في إعداداتك المحلية.
ادمجها في الإعدادات الحالية مع الحفاظ على الأدوات والإعدادات الأخرى.
استبدل القيم المؤقتة الموضحة أدناه قبل التنفيذ أو الحفظ.
احفظ الإعدادات ثم أعد تشغيل المساعد أو المحرر أو تحميله.

إعدادات MCP في Cursor

ملف الإعدادات ~/.cursor/mcp.json

استبدل هذه القيم: YOUR_CLARITY_API_TOKEN

{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=YOUR_CLARITY_API_TOKEN"
      ]
    }
  }
}

مصدر الأمر ↗

دليل التثبيت الرسمي ↗

المتطلبات والتكاليف والخطوات التفصيلية

ابدأ الاستخدام

ما تحتاج إليه

استخدم إصدار دعم طويل الأجل حديثاً من Node.js وnpm وعميلاً يدعم MCP.
تحتاج إلى حساب Clarity ومشروع يجمع بالفعل بيانات الموقع المراد فحصه.
أنشئ رمز API للمشروع من Settings → Data Export في Clarity، واستبدل YOUR_CLARITY_API_TOKEN داخل إعدادات العميل المحلية فقط.

القيود والتكاليف

تخضع البيانات المتاحة والنطاقات الزمنية وحدود الطلبات لخدمة Clarity وصلاحيات المشروع.
قد تتضمن تسجيلات الجلسات نشاطاً حساساً على الموقع؛ شاركها مع مساعدين وأشخاص مخولين فقط.
لا يحل الموصل محل التحليل ولا يثبت سبب مغادرة المستخدم. كما لا يضبط تتبع الموقع أو إعدادات الموافقة.

وفق الوثائق العامة؛ لم يُثبّت كل مشروع ويُختبر هنا.

مقدمة

يربط Microsoft Clarity MCP Server مساعداً يدعم MCP بمشروع Clarity الذي تستخدمه بالفعل. اسأل عن الزيارات والأجهزة وسلوك المستخدمين، ثم ابحث عن تسجيلات جلسات ذات صلة لفحص صفحة مربكة أو خطوة معطلة. الأداة تستعلم عن التحليلات الموجودة؛ تثبيتها لا يضيف تتبع Clarity إلى الموقع ولا ينشئ بيانات زيارات.

طرق الاستخدام

الاستعلام عن تحليلات Clarity بأسئلة بلغة عادية.
العثور على تسجيلات الجلسات باستخدام عوامل التصفية والترتيب المدعومة.
البحث في وثائق Clarity من داخل المساعد.

المشروع ووثائقه الرسمية

عرض الكود المصدري ↗موقع المشروع ↗دليل الإعداد والاستخدام ↗

إضافات لمهام مشابهة

قارن الإضافات التي تؤدي مهام متشابهة وتحقّق من متطلبات إعداد كل منها.

MCP Reference Servers — أمثلة MCP المرجعية الرسمية، ومنها خادم Filesystem للعمل داخل المجلدات التي تسمح بها صراحة.
Apify MCP Server — دع المساعد يجد أدوات بيانات الويب ويشغلها ويقرأ النتائج.
MarkItDown MCP — حوّل PDF وWord والجداول إلى نص يمكن لـ AI معالجته.