التكاملات: مساعدو AI

يمكن استخدام Agent DVR مباشرة من مساعدو AI مثل Claude و ChatGPT و Cursor و VS Code Copilot. اطرح أسئلة باللغة الطبيعية - "ما هي التنبيهات التي تلقيتها أمس الليل؟"، "أريني ما حدث على كاميرا الممر الجانبي هذا الصباح"، "عطّل الكاميرات في المرآب" - والمساعد يجيب من كاميراتك المباشرة والتسجيلات وسجل التنبيهات، بما في ذلك الصور.

يتم ذلك من خلال Model Context Protocol (MCP)، المعيار المفتوح الذي تستخدمه المساعدات للاتصال بالأدوات الخارجية. يوفر Agent DVR خادم MCP في مكانين، وتتصل بمساعدك بأيهما يناسبك:

• مدمج في Agent DVR (نقطة نهاية محلية): يتم توفيره بواسطة خادمك الخاص على شبكتك المحلية. لا حاجة إلى حساب أو اشتراك. للمساعدات التي تعمل على نفس الكمبيوتر أو شبكة محلية.
• من خلال iSpyConnect.com (نقطة نهاية سحابية): تصل إلى خوادمك عبر نفس الوصول عن بعد الذي تستخدمه بوابة الويب وتطبيقات الجوال، من أي مكان، بدون إعادة توجيه المنفذ. يتطلب اشتراك iSpyConnect. هذا هو الخيار المراد استخدامه لـ claude.ai و ChatGPT والهواتف الذكية.

يعرض كلاهما نفس مجموعة الأدوات. يتطلب Agent DVR 8.0.3 أو إصدار أحدث.

يقدم كل خادم Agent DVR خدمة MCP على /mcp في خادم الويب المحلي، لذا إذا فتحت واجهة Agent DVR على http://localhost:8090 فإن نقطة النهاية هي http://localhost:8090/mcp (استخدم عنوان الخادم والمنفذ من جهاز آخر على الشبكة المحلية، على سبيل المثال http://192.168.1.10:8090/mcp). يكون مفعلاً بشكل افتراضي ويمكن إيقافه من خلال AI Assistant (MCP) Endpoint في إعدادات الخادم - خادم محلي.

يتبع الوصول نفس القواعد تماماً مثل بقية API المحلي: من شبكتك الخاصة لا يلزم تسجيل دخول، إلا إذا تم تفعيل حماية API، وفي هذه الحالة يجب على المساعد إرسال اسم المستخدم وكلمة مرور المستخدم الإداري (تسمح لك معظم عملاء MCP بإضافة رأس التفويض). تتطلب الاتصالات من خارج شبكتك بالإضافة إلى ذلك ترخيصاً، مماثلاً لوصول المنفذ المعاد توجيهه إلى واجهة المستخدم.

Claude Code

claude mcp add --transport http agentdvr http://localhost:8090/mcp

Cursor

أضف إلى .cursor/mcp.json (أو عبر الإعدادات - MCP):

{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }

VS Code (Copilot)

أضف إلى .vscode/mcp.json:

{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }

Claude Desktop

لا يمكن لتطبيق Claude Desktop استدعاء خادم على جهازك الخاص مباشرة، لذا يستخدم امتدادًا صغيرًا يقوم بذلك نيابة عنك. نزّل AgentDVR.mcpb، ثم في Claude Desktop افتح الإعدادات - الامتدادات واسحب الملف على الصفحة. يتم التثبيت مع تفعيله ويتصل بـ http://localhost:8090/mcp؛ انقر على تكوين فقط إذا كان الخادم على جهاز آخر أو إذا كان لديه حماية API مفعلة. يطلب Claude إذنًا في المرة الأولى لكل أداة يتم استخدامها - اختر "السماح دائمًا" لإيقاف المطالبات.

مساعدات أخرى

أي عميل يدعم MCP عبر HTTP ("Streamable HTTP") يمكنه استخدام نفس URL. ابحث عن "خوادم MCP" أو "الموصلات" أو "الأدوات" في إعدادات المساعد.

لا يمكن لتطبيق Claude الويب والتطبيقات الجوالة، و ChatGPT، الوصول إلى خادم على شبكتك الخاصة على الإطلاق؛ فهي تستخدم نقطة نهاية سحابية.

من خلال اشتراك iSpyConnect، يمكن الوصول إلى خوادمك أيضاً على:

https://www.ispyconnect.com/mcp

أضف عنوان URL هذا كموصل مخصص أو خادم MCP في مساعدك (على سبيل المثال الإعدادات - الموصلات في claude.ai وتطبيقات Claude، أو ما يعادله في ChatGPT و Cursor). يفتح المساعد صفحة تسجيل دخول iSpyConnect؛ قم بتسجيل الدخول واختر ما إذا كنت تريد السماح بالتحكم بالإضافة إلى المشاهدة، و انقر على السماح. لا حاجة لتكوين أي شيء آخر: جميع خوادم Agent DVR المتصلة بحسابك مع تفعيل الوصول عن بُعد متاح، وسيطلب المساعد منك تحديد الخادم المقصود إذا كان لديك أكثر من واحد.

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

يجب أن يكون خادمك قيد التشغيل ومتصلاً بـ iSpyConnect (أيقونة القفل في واجهة المستخدم المحلية تظهر حالة الاتصال عن بُعد). حظر الوصول الخارجي في إعدادات الخادم يحظر نقطة النهاية هذه أيضاً.

يرى المساعدون مجموعة صغيرة من الأدوات المصممة لأغراض محددة بدلاً من واجهة برمجة التطبيقات الأولية، لذلك تبقى الإجابات سريعة وغير مكلفة:

• العرض: قائمة بالخوادم والأجهزة (مع الموقع والحالة)، ملخص النشاط (التسجيلات والتنبيهات لكل كاميرا في الساعة، مع ما تم اكتشافه)، قائمة التسجيلات في نافذة زمنية، عرض نافذة كاملة في لمحة سريعة كشبكة من الإطارات، عرض كاميرا على مدار يوم كخط زمني من الإطارات، أخذ عينات من الإطارات من تسجيل واحد، التقاط لقطة مباشرة من كاميرا، قراءة سجل التنبيهات، والحصول على رابط لفتح تسجيل في واجهة الويب.
• التحكم: تفعيل وإيقاف تفعيل الخادم، وتطبيق الملفات الشخصية، وتفعيل أو إيقاف تفعيل الأجهزة، وتغيير أنماط التسجيل، وتشغيل أو إيقاف التنبيهات والكاشفات، وتحريك كاميرات PTZ إلى الإعدادات المسبقة، والتغييرات الحالية الأخرى من واجهة برمجة التطبيقات.
• كل شيء آخر: فهرس إضافي من أوامر القراءة والتحكم التي يمكن للمساعد استدعاؤها عند عدم ملاءمة أي أداة مخصصة (إحصائيات النظام وحالة الجهاز الكاملة وإعدادات PTZ المسبقة وما إلى ذلك).

لا يمكن للمساعد حذف التسجيلات أو الصور أو تغيير التكوين للجهاز أو الخادم أو إضافة أو إزالة الأجهزة أو إعادة تشغيل الخادم: لا يتم تقديم هذه الأوامر عن قصد، بغض النظر عن نقطة النهاية المستخدمة. على نقطة النهاية السحابية، يكون العرض والتحكم أذونات منفصلة تمنحها على صفحة تسجيل الدخول، والاستخدام مقيد بمعدل لحماية الوسيط.

أمثلة المطالبات

• "هل ذهب أحد إلى باب المدخل في آخر 24 ساعة؟ أظهر لي."
• "ما الطيور التي زارت المغذي هذا الصباح؟"
• "ما مدى انشغال الممر اليوم، ومتى؟"
• "أظهر لي الحديقة الخلفية على مدار اليوم. متى بدأ هطول المطر؟"
• "ما التنبيهات التي تلقيتها أمس، وهل كان أي منها أشخاصاً؟"
• "من في باب المدخل الآن؟"
• "أي كاميرات غير متصلة؟"
• "نحن على وشك الخروج - قم بتفعيل كل شيء باستخدام ملف الملف الشخصي للغياب."
• "عطّل جميع الكاميرات في موقع المنزل."
• "أرسل لي رابطاً إلى مقطع الفيديو الخاص بموظف الشحن."

سير العمل الجاهزة

يوفر الخادم أيضاً قوالب المطالبة التي تعرضها المساعدات التي تدعم المطالبة (Claude Desktop و Claude Code و Cursor وغيرها) كأوامر شرطة مائلة أو في القائمة. كل واحدة تقوم بتشغيل سير عمل متعدد الخطوات وتقارير النتيجة:

• morning_briefing - ما رأته الكاميرات منذ المساء الماضي: النشاط والتنبيهات والأشخاص البارزين والمركبات والحيوانات وصحة الكاميرا.
• door_report - من جاء إلى كاميرا باب، مع الأوقات، ما فعله كل زائر ورابط لكل مقطع.
• wildlife_report - ما الحيوانات والطيور التي التقطتها كاميرا، محددة بأقرب ما يسمح به الفيديو.
• camera_health - كل خادم وكاميرا يتم فحصها للتحقق من غير المتصل والمعطل والأخطاء والكاميرات التي لم تسجل نشاطاً.
• day_in_review - كاميرا على مدار يوم كامل كخط زمني من الإطارات، مع سرد لكيفية تغير المشهد.

• المساعد غير قادر على الاتصال بنقطة النهاية المحلية: تحقق من عنوان URL في متصفح الويب - يجب أن يرد http://localhost:8090/mcp (رسالة خطأ مقبولة؛ "الاتصال مرفوض" ليس كذلك). تأكد من أن المنفذ يطابق "إعدادات الخادم" - "خادم محلي" وأن نقطة النهاية مفعلة هناك.
• 401 غير مصرح: حماية API مفعلة، لذا يجب على المساعد إرسال بيانات اعتماد مستخدم إداري، أو أنك تتصل من خارج شبكتك.
• 403 محظور: الاتصال من خارج شبكتك بدون ترخيص. استخدم نقطة نهاية سحابية بدلاً من ذلك.
• 404 غير موجود: نقطة النهاية مطفأة في "إعدادات الخادم"، أو أن الخادم أقدم من الإصدار 8.0.3.
• نقطة النهاية السحابية تقول أن الخادم غير متصل: الخادم غير متصل بـ iSpyConnect. تحقق من رمز القفل في واجهة المستخدم المحلية وأن "حظر الوصول الخارجي" مطفأ.
• مشاهدة ما يقوم به المساعد: اضبط "تسجيل الأحداث" على وضع التصحيح في إعدادات الخادم وافتح السجلات من قائمة الخادم. في نقطة النهاية المحلية، يتم تسجيل كل طلب واستدعاء أداة برمز بادئة "MCP"، بما في ذلك المعطيات والمدة التي استغرقتها. من خلال نقطة نهاية السحابة، تعمل الأدوات على iSpyConnect.com ولا يرى الخادم سوى الأوامر الفردية التي ترسلها، والمسجلة برمز بادئة "RelayApi".