مستخدمو مساعدات الذكاء الاصطناعي
اطلب من Claude فحص ملف حضور بحثًا عن التأخير والبصمات الناقصة والغياب المحتمل دون فتح جدول بيانات.
خادم MCP وواجهة برمجية عامة لمساعدات الذكاء الاصطناعي والمطوّرين
تقدّم وثيقة خادم MCP عامًا وبعيدًا على https://www.watheeqahr.com/api/v1/mcp ليستخدم مساعدو الذكاء الاصطناعي محلل ملفات الحضور المجاني مباشرة. فيه ثلاث أدوات للقراءة فقط: analyze_attendance_file وlist_supported_attendance_formats وget_product_facts، ولا يحتاج حسابًا ولا مفتاح API. التحليل نفسه متاح كنقطة JSON موصوفة بوثيقة OpenAPI 3.1 على https://www.watheeqahr.com/api/v1/public/openapi.json.
المميزات
| الميزة | الوصف |
|---|---|
| عنوان خادم MCP | https://www.watheeqahr.com/api/v1/mcp. نقل Streamable HTTP، إصدار البروتوكول 2025-06-18، بلا حالة، وردود JSON. يرجع GET رمز 405 لأنه لا يوجد بث أحداث. |
| الإضافة في Claude | في Claude افتح الإعدادات ثم الموصّلات (Connectors) واختر إضافة موصّل مخصّص والصق عنوان خادم MCP. لا يلزم تسجيل دخول. وتقبل العناوين نفسها بقية عملاء MCP التي تدعم خوادم Streamable HTTP البعيدة. |
| الأداة analyze_attendance_file | أرسل ملف الجهاز بصيغة filename مع content_base64، أو كنص csv_text. اختياريًا: country وshift_start وshift_end وweekend_days وholidays وschedule_mode. تعيد عدد الموظفين وأيام الحضور لكل موظف وتقدير أيام الغياب وأيام التأخير والبصمات الناقصة والأعمدة التي اكتُشفت. وإذا تعذّرت قراءة الملف تعيد الأداة سبب رفض المحلل كنتيجة خطأ. |
| الأداة list_supported_attendance_formats | تعيد أشكال عناوين التصدير التي اختُبر المحلل عليها، مثل ZKTeco BioTime وHikvision وDahua SmartPSS وAnviz وSuprema BioStar 2 وFingerTec وMatrix COSEC وeSSL. |
| الأداة get_product_facts | تعيد الدول المدعومة وما تفعله وثيقة وما لا تفعله وأسعار الباقات بالدرهم والروابط الأساسية. |
| الحدود | 5 ميغابايت للملف. يسمح المحلل المجاني بثلاثة ملفات مختلفة كل 30 يومًا لكل عنوان شبكة، وهو الحد نفسه في أداة الويب، ويعيد الطلب المرفوض السبب. كما تُحدّد الطلبات لكل عنوان. أيام الغياب تقديرات للمراجعة وليست غيابًا مؤكدًا. |
| الخصوصية | تُعالج الملفات في الذاكرة ولا يُخزَّن الملف الأصلي، كما في محلل الويب. يُحفظ ملخص النتيجة مع اسم الملف وعنوان شبكة مُجزَّأ خلف رابط لا يمكن تخمينه ويتوقف بعد 7 أيام. وتُحفظ أحداث الاستخدام لتحليل الخدمة ومنع إساءة الاستخدام. لا ترسل ملفات لا يحق لك مشاركتها. راجع صفحة الخصوصية للنص الكامل. |
| واجهة JSON وOpenAPI | تقبل POST https://www.watheeqahr.com/api/v1/public/attendance/analyze-json الحقول نفسها وتعيد الملخص نفسه. وثيقة OpenAPI 3.1 على https://www.watheeqahr.com/api/v1/public/openapi.json. |
من يستخدم هذا؟
المطوّرون الذين يبنون وكلاء
استدعِ أدوات MCP أو نقطة JSON من وكيلك للتحقق من ملف الجهاز قبل وصوله إلى الرواتب.
المحاسبون ومستشارو الموارد البشرية
تحقق من أن ملف جهاز العميل قابل للقراءة ومن الأعمدة المكتشفة قبل بدء العمل.
الأسئلة الشائعة
ما عنوان خادم MCP الخاص بوثيقة؟
https://www.watheeqahr.com/api/v1/mcp. استخدمه موصّلًا مخصّصًا في Claude أو عنوان خادم بعيد في أي عميل MCP يدعم Streamable HTTP.
هل أحتاج حسابًا أو مفتاح API؟
لا. الأدوات مجانية وعامة. الحد المجاني للمحلل ثلاثة ملفات مختلفة كل 30 يومًا لكل عنوان شبكة، وحجم الملف حتى 5 ميغابايت.
هل تستطيع الأدوات تغيير أو حذف أي شيء؟
لا. الأدوات الثلاث للقراءة فقط ومغلقة العالم: تحلل الملف الذي ترسله أو تعيد حقائق عن المنتج.
ماذا يحدث للملف الذي أرسله؟
يُعالج في الذاكرة ولا يُخزَّن الملف الأصلي، كما في محلل الويب. ويُحفظ ملخص النتيجة 7 أيام خلف رابط لا يمكن تخمينه.
أين توثيق الواجهة البرمجية؟
وثيقة OpenAPI 3.1 على https://www.watheeqahr.com/api/v1/public/openapi.json وتصف نقطة JSON للمحلل ونقطة MCP.
صفحات ذات صلة
ابدأ بملف الحضور الفعلي
ارفع ملف Excel أو CSV وراجع النتيجة مجانًا — دون إنشاء حساب.
حلّل ملف الحضور مجانًا إنشاء حساب مجاني