قم بتوصيل مساعد الذكاء الاصطناعي

استخدم عميل MCP الذي يدعم Streamable HTTP وإما OAuth المسجل مسبقًا مع PKCE أو رمز حامل مميز. يختلف دعم العملاء؛ التسجيل التلقائي للعميل غير متوفر.

عنوان URL لخادم MCP

https://api.remotegymp.com/mcp

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

تواصل مع OAuth

1. في الإعدادات، قم بإنشاء بيانات اعتماد مع تمكين MCP والأذونات التي يحتاجها المساعد فقط. سجل عنوان URL الدقيق لرد الاتصال الذي قدمه عميلك. استخدم اسم مستخدم بيانات الاعتماد كمعرف عميل OAuth. لا يستخدم هذا التدفق سر العميل.
2. يجب أن تستخدم عمليات الاسترجاعات HTTPS أو HTTP على عنوان استرجاع صريح. يجب أن يتطابق عنوان URL الكامل، بما في ذلك المنفذ. لتغييرها، قم بإنشاء بيانات اعتماد جديدة وإلغاء القديمة.
3. اتصل من عميلك، وقم بتسجيل الدخول باعتبارك المالك الذي أنشأ بيانات الاعتماد وراجع شاشة الموافقة. يجب على العميل استخدام S256 PKCE وعنوان URL لمورد MCP. يمكن أن تؤدي الموافقة إلى تضييق نطاق أذونات بيانات الاعتماد؛ لا يمكن إضافة أذونات.

نقاط نهاية Cloud OAuth

التفويض

https://app.remotegymp.com/integration/oauth/authorize

تبادل الرمز

https://app.remotegymp.com/integration/oauth/token

البيانات الوصفية لخادم التفويض

https://app.remotegymp.com/.well-known/oauth-authorization-server

البيانات الوصفية للموارد المحمية

https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

يستخدم OAuth أسماء حقول الرمز المميز القياسية ورموز التحديث الدوارة. يجب على العميل التعامل مع التحديث تلقائيًا. تستمر رموز الوصول لمدة 30 دقيقة على الأكثر. تنتهي صلاحية الاتصالات بعد سبعة أيام دون تحديث أو بعد 30 يومًا إجمالاً. تؤدي إعادة استخدام رمز التحديث القديم إلى إبطال الاتصال؛ أعد الاتصال بدلاً من إعادة تشغيله.

تواصل مع حامل الرمز المميز

إذا كان العميل الخاص بك يدعم رمزًا مميزًا لحامل تم تكوينه، فقم بتبادل بيانات اعتماد تمكين MCP عند نقطة نهاية الرمز المميز مع جمهور MCP، ثم ضع الرمز المميز الذي تم إرجاعه في إعداد الرمز المميز للحامل الآمن الخاص بالعميل. تنتهي صلاحيته بعد 30 دقيقة. لا تضع رمزًا مميزًا في عنوان URL الخاص بالخادم. استخدم OAuth للعملاء الذين يحتاجون إلى التحديث التلقائي.

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

المصادقة →

التحقق من الوصول قبل القيام بالعمل

اطلب من العميل سرد الأدوات المتاحة لديه وقراءة الإمكانيات أولاً. ابدأ بطلب للقراءة فقط، مثل قائمة الأجهزة. قد تعكس الأداة الغائبة الأذونات أو النطاق أو التوفر. تمكين MCP وحده لا يمنح التحكم عن بعد.

tools/list · get_capabilities

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

قطع الاتصال أو إلغاء الوصول

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