خادم MCP
دع وكيل ذكاء اصطناعي يقرأ تحليلاتك: سبع أدوات عبر Model Context Protocol، كلها للقراءة فقط، بمفتاح API تملكه بالفعل.
1. ما يستطيع الوكيل فعله
وجّه عميل Model Context Protocol لنقطة النهاية ليسأل مثل «أي صفحة تنتج أكثر نقر غاضب هذا الشهر» أو «أرني ثلاث جلسات من ألمانيا أطول من دقيقتين» — ثم يعطيك رابط تشغيل الجلسة.
| الأداة | الإجابة |
|---|---|
mp_projects | المشاريع التي يحق للمفتاح قراءتها |
mp_overview | الجلسات والأشخاص ومشاهدات الصفحات والمدة وإشارات الإحباط |
mp_sessions | جلسات حديثة بروابط تسجيل، مفلترة بالبلد أو الجهاز أو المدة |
mp_session | جلسة واحدة: صفحات مرتبة وأحداث ومصدر وجهاز |
mp_pages | صفحات بالمشاهدات مع الزوار الفريدين |
mp_frustration | نقرات غاضبة وغير مستجيبة وأخطاء JavaScript مجمّعة بالصفحة |
mp_goals | أهدافك وعدد تحقق كل منها |
لكل جلسة يبلغها الوكيل رابط يفتحه إنسان. الوكيل الملخّص مفيد؛ والذي يعرض الثواني العشرين التي بنى عليها ملخصه قابل للتحقق.
2. الاتصال
تقبل نقطة النهاية POST على /mcp وتستخدم Streamable HTTP، إصدار البروتوكول 2026-07-28.
المصادقة بمفتاح MousePlayer API قراءة عادي — نفسه الذي تنشئه في الإعدادات، مفاتيح API، وتقبله REST API. لا بيانات اعتماد ثانية. إلغاء المفتاح يلغي وصول الوكيل في اللحظة نفسها.
ثم فعّل المشروع
يفتح مفتاح API مساحة عملك كاملة. هذا المسار يتعمد خلاف ذلك: لكل مشروع مفتاح في صفحة التكاملات معطل افتراضيًا. لا يظهر المشروع غير المفعّل في mp_projects ولا يُقرأ حتى لو خمّن الوكيل معرّفه.
ليست بيروقراطية. مفتاح برنامج النشر في موضع تتحكم به؛ والمفتاح في إعداد وكيل يغذي سياق نموذج، وهو حفظ أقل انضباطًا. السماح بمشروع كل مرة هو الضبط المناسب.
3. للقراءة فقط ولماذا سيبقى كذلك
لا تكتب أي من الأدوات السبع شيئًا. لا حذف أو تصدير أو تغيير إعداد خلف هذه النقطة — ليس لضيق الوقت، بل لأن أداة يستطيع الوكيل استدعاءها يستطيع استدعاءها بالخطأ.
ما لا تعيده
لا تسجيلات نفسها أو لقطات DOM أو عناوين IP. يحصل الوكيل على ما يراه الشخص في الواجهة ورابط مشاهدة البقية.
حدود المعدل والنطاق
ستون طلبًا في الدقيقة لكل مفتاح كـ REST API. الفترة حتى 365 يومًا والنتائج حتى 200 صف؛ الرد المبتور يذكر ذلك، فالمبتور بصمت يبدو كاملًا تمامًا.
4. لبناة العميل
ثلاث طرق: server/discover، tools/list، tools/call. لا جلسات أو تدفق GET أو Last-Event-ID — هذه لإصدارات حتى 2025-11-25 وليست جزءًا من هذا. يعيد GET أو DELETE الحالة 405.
يحمل كل POST MCP-Protocol-Version، Mcp-Method ولـ tools/call، Mcp-Name، ويجب أن تطابق الجسم. عدم التطابق يعيد 400 مع خطأ JSON-RPC -32020؛ والإصدار غير المدعوم يعيد 400 مع -32022 وقائمة الإصدارات المدعومة ليختار العميل ويعيد المحاولة.
نوعا خطأ عمدًا
الطلب المشوه أو الأداة المجهولة خطأ JSON-RPC. «المشروع غير مسموح» أو «الجلسة غير موجودة» نتيجة عادية مع isError: true — يستطيع النموذج التعافي من الثانية بطلب mp_projects والمحاولة مجددًا، لا من الأولى.
تحمل النتائج structuredContent والبيانات نفسها متسلسلة في كتلة نصية لتبقى مفيدة للعملاء الأقدم.
كل العلامات التجارية المذكورة ملك لأصحابها. لا تربط MousePlayer علاقة تجارية بهؤلاء المزودين.