انتقل إلى المحتوى
Localtonet Localtonet لوحة التحكم

نشر أدوات MCP عبر نفق بوابة MCP

سطح المكتب v7.8+ الجوال v10.1+

مساعدة بشأن هذه الصفحة
في هذه الصفحة 8 أقسام
  1. ما هو
  2. قبل أن تبدأ
  3. إنشاء البوابة
  4. افتح صفحة بوابة MCP
  5. املأ النموذج
  6. شغّل النفق
  7. أنواع الرابط
  8. توكن البوابة
  9. ربط عميل MCP
  10. افتح لوحة تحكم البوابة
  11. سجّل خوادم MCP لديك
  12. أنشئ توكن عميل
  13. وجّه عميل MCP إلى البوابة
  14. الإعدادات
  15. استكشاف الأخطاء وإصلاحها
  16. صفحات ذات صلة

يربط نفق بوابة MCP عملاء MCP ومساعدي الذكاء الاصطناعي بالأدوات التي تعمل على جهازك عبر بوابة عامة. يشغّل عميل Localtonet البوابة نيابةً عنك، ويمنحها النفق عنوان HTTPS عامًّا.

ما هو #

يتيح Model Context Protocol (MCP) لمساعد ذكاء اصطناعي استدعاء الأدوات. وتقف بوابة MCP أمام خوادم MCP التي تشغّلها وتعرض كل أدواتها عبر نقطة وصول واحدة.

عند تشغيل نفق بوابة MCP، يبدأ عميل Localtonet بوابة على جهازك وينشرها Localtonet على عنوان النفق. لا تُدخل عنوان IP محليًّا ولا منفذًا. وللبوابة:

  • لوحة تحكم ويب على https://<ADDRESS>/dashboard تسجّل فيها خوادم MCP وتنشئ توكنات العملاء؛
  • ونقطة وصول MCP على https://<ADDRESS>/mcp التي يتصل بها عملاء MCP لديك.

ليست هي نفسها خادم MCP الخاص بـ Localtonet. تتناول هذه الصفحة نشر أدواتك الخاصة. ولتتيح لمساعد ذكاء اصطناعي إدارة حسابك في Localtonet (الأنفاق والتوكنات وغيرها)، راجع خادم MCP.

قبل أن تبدأ #

  • عميل Localtonet يعمل على الجهاز ومتصل باستخدام AuthToken. راجع البدء السريع.
  • العميل حديث بما يكفي. الحد الأدنى لإصدارات تطبيق Localtonet المطلوبة لاستخدام هذه الميزة: Desktop v7.8 وMobile v10.1.

إنشاء البوابة #

  1. افتح صفحة بوابة MCP #

    افتح أنفاقي › بوابة MCP ووسّع إنشاء نفق بوابة MCP.

  2. املأ النموذج #

    الحقلما تدخله
    نوع الرابطنطاق فرعي عشوائي أو نطاق فرعي مخصص أو نطاق مخصص. راجع الجدول أدناه.
    توكن الجهازتوكن الجهاز الذي يشغّل أدواتك.
    منطقة الخادمالخادم الذي يتصل به عملاء MCP لديك.
    النطاق الفرعييظهر مع نطاق فرعي مخصص: الاسم الذي تريده.
    النطاقنطاق العنوان.

    اختر إنشاء النفق.

  3. شغّل النفق #

    تظهر البوابة ضمن أنفاقك. اختر تشغيل. يعرض عمود الرابط العنوان العام.

أنواع الرابط #

نوع الرابطالعنوان الذي تحصل عليهملاحظات
نطاق فرعي عشوائياسم مولَّد تحت النطاق الذي تختاره.مناسب للتجربة الأولى.
نطاق فرعي مخصصالنطاق الفرعي الذي تدخله تحت النطاق الذي تختاره.يتطلب رصيدًا.
نطاق مخصصأحد نطاقاتك الخاصة.يتطلب رصيدًا. تعرض قائمة النطاق نطاقاتك؛ وإن كانت فارغة فأنشئ نطاقًا من مدير DNS أولًا. راجع النطاقات المخصصة.

توكن البوابة #

يحصل كل نفق بوابة MCP على توكن بوابة خاص به عند إنشائه. وهو توكن المسؤول للبوابة: فلا تقبل لوحة تحكم البوابة وواجهة API الخاصة بإدارتها التغييرات إلا به.

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

أبقِ توكن البوابة سريًّا. فهو يمنح تحكمًا كاملًا في البوابة: خوادمها وأدواتها وتوكنات عملائها. لا تضعه في عميل MCP؛ إذ تستخدم العملاء توكناتها الخاصة.

ربط عميل MCP #

  1. افتح لوحة تحكم البوابة #

    والنفق قيد التشغيل، افتح https://<ADDRESS>/dashboard في متصفح. الصق توكن البوابة في حقل Admin token أسفل القائمة الجانبية.

  2. سجّل خوادم MCP لديك #

    افتح Servers واختر Add Server. يمكن أن يكون الخادم خادم MCP يُوصل إليه عبر رابط (Streamable HTTP أو SSE)، أو أمرًا محليًّا (stdio)، أو خدمة OpenAPI. يسرد Catalog خوادم MCP الجاهزة التي يمكنك تثبيتها، ويعرض Tools الأدوات التي جمعتها البوابة من كل الخوادم.

  3. أنشئ توكن عميل #

    افتح Clients واختر New Client. أدخل Name ثم اختر Create Client. تعرض البوابة Client Token مرة واحدة: انسخه الآن، فلن يُعرض مجددًا. وفي قائمة العملاء يبيّن Allowed Servers وAllowed Groups الخوادم ومجموعات الأدوات التي يمكن للعميل استخدامها.

  4. وجّه عميل MCP إلى البوابة #

    في عميل MCP أو مساعد الذكاء الاصطناعي لديك، أضف خادم MCP بعيدًا بهاتين القيمتين:

    إعدادات عميل MCP
    URL:     https://<ADDRESS>/mcp
    Header:  Authorization: Bearer <CLIENT_TOKEN>

    يعتمد مكان إدخالها على العميل؛ اتبع توثيقه الخاص بخوادم MCP البعيدة (HTTP).

يعرض Audit Log في لوحة التحكم طلبات البوابة الأخيرة، ويضم Settings إعدادات البوابة مع النسخ الاحتياطي والاستعادة.

تخزّن البوابة خوادمها ومجموعاتها وعملاءها وسجل التدقيق على جهازك، في مجلد باسم mcp-data-<TUNNEL_ID> داخل مجلد عمل عميل Localtonet (وعلى Android داخل التخزين الخاص بالتطبيق). و<TUNNEL_ID> هو الرقم في عمود المعرّف، لذا يكون لكل نفق بوابة MCP مجلده الخاص.

الإعدادات #

اختر أيقونة الإعدادات الخاصة بالنفق لفتح إعدادات النفق.

الإعدادما يفعلهالمزيد
موازنة الحملوزّع حركة المرور على الأجهزة أو استخدم نسخة احتياطية عندما يتعذر هدف.موازنة الحمل
HTTPS فقط؟استخدم HTTPS فقط لنقطة الوصول العامة للنفق.مرجع الإعدادات
المصادقة الأساسية؟اشترط اسم مستخدم وكلمة مرور للوصول إلى هذا النفق.التحكم في الوصول
تفعيل HTTP/3؟اسمح للعملاء بالاتصال بنقطة الوصول العامة باستخدام HTTP/3.مرجع الإعدادات
الاتصال القديم؟جرّب هذا إذا تعذّر اتصال النفق بالطريقة المعتادة.مرجع الإعدادات
توكن البوابةإدارة توكن الوصول لبوابة MCP هذه.انظر أعلاه
مهلة HTTPالمدة التي ينتظر فيها الخادم استجابة من تطبيقك المحلي قبل إلغاء الطلب، من 1 إلى 600 ثانية. اتركه فارغًا لاستخدام القيمة الافتراضية للخادم.مرجع الإعدادات
ملاحظة النفقاحفظ ملاحظة خاصة تساعدك على تمييز هذا النفق أو توثيقه.مرجع الإعدادات
قيود IPتحكّم في عناوين IP للعملاء التي يمكنها الوصول إلى هذا النفق.التحكم في الوصول
تاريخ الانتهاء، حدود السرعة، حد النطاق الترددي، استخدام النطاق التردديتاريخ الانتهاء، وحدود سرعة الرفع والتنزيل، وحد لنقل البيانات، ومسح لإعادة تعيين الاستخدام المسجّل.الحدود وانتهاء الصلاحية
المنفذ الصادراختر منفذًا صادرًا ثابتًا لاتصال تطبيق Localtonet بالخادم.المنافذ
حركة النطاق الترددي، سجل الطلبات، سجل النشاط، صحة النفقحركة المرور عبر الزمن، والطلبات المسجّلة، وعمليات التشغيل والإيقاف وتغييرات الإعدادات، ونتائج فحوص الصحة الأخيرة.السجلات والفحص

في قائمة الأنفاق، يحتوي عمود Webhooks على زر عرض سجلات الطلبات والاستجابات يفتح مفتّش الطلبات للنفق الذي يعمل. راجع السجلات والفحص.

استكشاف الأخطاء وإصلاحها #

لا تبدأ البوابة أو لا يستجيب العنوان

تحقق من إصدار تطبيق Localtonet على الجهاز: تحتاج بوابة MCP إلى Desktop v7.8 أو Mobile v10.1 على الأقل. ثم تحقق من أن النفق قيد التشغيل وأن عمود الاتصال يعرض الجهاز متصلًا.

لا تحمّل لوحة تحكم البوابة بياناتها

تحتاج طلبات الإدارة في لوحة التحكم إلى توكن المسؤول. حقل Admin token فارغ أو خاطئ. انسخ توكن البوابة مجددًا من الإعدادات الخاصة بالنفق والصقه في الحقل.

يُرفض عميل MCP

تحتاج نقطة وصول MCP إلى توكن عميل في الترويسة Authorization: Bearer. أنشئ واحدًا ضمن Clients في لوحة تحكم البوابة واستخدمه هنا، لا توكن البوابة.

«يرجى تشغيل النفق أولًا.»

مفتّش الطلبات متاح فقط أثناء تشغيل النفق.

«يجب إنشاء نطاق من مدير DNS!» أو «تحذير! ليس لديك أي نطاق!»

يتطلب نطاق مخصص أحد نطاقاتك الخاصة. أضفه في مدير DNS، أو اختر نوع رابط آخر.

«تحتاج إلى شراء رصيد لاستخدام هذه الميزة.»

يتطلب نطاق فرعي مخصص ونطاق مخصص رصيدًا. استخدم نطاق فرعي عشوائي أو أضف رصيدًا. راجع الخطط والرصيد.

الدعم