خادم Localtonet MCP
في هذه الصفحة 9 أقسام
يتيح خادم Localtonet MCP لمساعد ذكاء اصطناعي يدعم Model Context Protocol، مثل Claude أو Cursor، إدارة حسابك بلغة طبيعية: عرض الأنفاق وإنشاءها وتشغيلها وإيقافها وضبطها، وإدارة AuthTokens ومجموعات التوكنات والخوادم ومزوّدي SSO.
ما هو وما ليس هو #
- يديره Localtonet خادم MCP الموصوف في هذه الصفحة على
https://localtonet.com/mcp. وتعمل أدواته على حساب Localtonet الخاص بك، كما يفعل REST API. - أما بوابة MCP فهي نوع نفق. تمنح خادم MCP الذي يعمل على جهازك أنت عنوانًا عامًا. استخدمها لنشر أدواتك الخاصة، لا لإدارة Localtonet.
تفاصيل الاتصال #
| الإعداد | القيمة |
|---|---|
| نقطة الوصول (Endpoint) | https://localtonet.com/mcp |
| وسيلة النقل (Transport) | Streamable HTTP |
| المصادقة | مفتاح API كتوكن Bearer: Authorization: Bearer <YOUR_API_KEY> |
| معلومات الخادم | localtonet.com/mcp-info (JSON) وبطاقة الخادم على https://localtonet.com/.well-known/mcp-server-card |
قبل أن تبدأ #
- عميل MCP يستطيع الاتصال بخادم بعيد عبر Streamable HTTP وإرسال ترويسة
Authorizationمخصصة. - مفتاح API الخاص بك. افتح لوحة التحكم واستخدم نسخ في بطاقة مفتاح API. راجع الحساب والأمان.
- للعمل على الأنفاق: جهاز عليه عميل Localtonet متصل، كي يجد المساعد AuthToken ينشئ عليه الأنفاق.
اربط عميل MCP #
-
أضف الخادم إلى العميل #
تقبل معظم عملاء MCP خادمًا بعيدًا على هيئة رابط مع ترويسات. الشكل المعتاد هو:
إعداد عميل MCP{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }يختلف اسم الملف وأسماء المفاتيح بالضبط من عميل إلى آخر. راجع وثائق عميلك لمعرفة أين تُضبط خوادم MCP البعيدة، واستخدم الرابط والترويسة المذكورين أعلاه.
-
تحقق من الاتصال #
أعد تحميل العميل. يجب أن تظهر أدوات Localtonet في قائمة أدواته. اسأل أولًا شيئًا غير ضار، مثل:
الطلبList my Localtonet tunnels and tell me which ones are running. -
أنشئ نفقًا #
صِف ما تريده. مثلًا:
الطلبCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.يتبع المساعد سير العمل الذي يحدده الخادم: يبحث عن AuthToken الجهاز، ويختار خادمًا، ويستدعي أداة الإنشاء المناسبة، ثم يشغّل النفق، لأن النفق المنشأ حديثًا لا يكون قيد التشغيل.
الأدوات #
أسماء الأدوات أدناه هي الأسماء التي يعرضها عميلك. وتعيد الأداة التي تفشل رسالة تبدأ بـ Error:.
الأنفاق #
| الغرض | الأدوات |
|---|---|
| الاستعراض | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| الإنشاء | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| التشغيل | StartTunnel, StopTunnel, DeleteTunnel |
| التغيير | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| العمليات الجماعية | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
إعدادات النفق #
| الإعداد | الأدوات |
|---|---|
| قيود IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| ضوابط الوصول | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| الترويسات والمصادقة | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| الانتهاء والحدود | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| الخادم والمنفذ | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| الوسائط والملاحظة | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| عملاء البروكسي الدوّار ومجموعات التوكنات | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| إعدادات متقدمة | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
وظيفة كل إعداد موصوفة في مرجع الإعدادات.
AuthTokens ومجموعات التوكنات #
| الغرض | الأدوات |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| وضع الطيران وتغيير IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| مجموعات التوكنات | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
الخوادم ومزوّدو SSO #
| الغرض | الأدوات |
|---|---|
| الخوادم | GetAvailableServers |
| مزوّدو SSO | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
الوصول عبر VPN على أنفاق البروكسي #
GetVpnAccessDevices وCreateVpnAccessDevice وGetVpnAccessDeviceConfig وGetVpnAccessDeviceCredentials وRegenerateVpnAccessDevice وDeleteVpnAccessDevice. تدير هذه الأدوات أجهزة WireGuard وOpenVPN على نفق بروكسي. يحصل كل جهاز على إعداداته الخاصة، وتخرج حركته كاملةً عبر البروكسي.
الأجهزة #
| الأداة | ما يفعله |
|---|---|
ListDevices | يسرد الحواسيب المقترنة بحسابك في أجهزتي، مع بيان ما إذا كان كل منها متصلًا واستخدامه للمعالج والذاكرة والقرص. |
GetDeviceMetrics | يعيد أحدث أرقام المعالج والذاكرة والقرص ومدة التشغيل لجهاز واحد. |
RunDeviceCommand | يشغّل أمر صدفة (shell) واحدًا على جهاز ويعيد خرجه ورمز الخروج. ينتظر حتى المهلة التي تحددها، من 1 إلى 120 ثانية، و30 افتراضيًا. |
تحتاج RunDeviceCommand إلى أكثر من مفتاح API: فهي تتطلب مفتاح وصول للجهاز (يبدأ بـ ltd_) تنشئه لذلك الجهاز في أجهزتي. راجع طرفية الأجهزة. يظهر التشغيل في سجل اتصالات الجهاز بوقته وعنوان IP، ولا يُخزَّن الأمر.
الحدود #
- تخضع الطلبات إلى خادم MCP لتحديد المعدل، مع طلبات API الخاصة بمفتاح API لديك. والرد
429يعني: انتظر ثم حاول مرة أخرى. - تقبل الأدوات الجماعية قائمة تضم حتى 100 عنصر.
الأمان #
يتصرف المساعد بمفتاح API الخاص بك. تستطيع أدواته إنشاء الأنفاق وإيقافها وحذفها، وحذف AuthTokens ومجموعات التوكنات، وتغيير قواعد الوصول، دون خطوة تأكيد من جانب Localtonet.
- فعّل التأكيد على استدعاءات الأدوات في عميل MCP، على الأقل للأدوات التي تبدأ بـ
DeleteوBulkDeleteوStopوSet. - لا تعطِ مفتاح وصول الجهاز الخاص بـ
RunDeviceCommandإلا لمساعد كنت ستمنحه أيضًا طرفية على ذلك الحاسوب. يُشغَّل الأمر بالصدفة الافتراضية للجهاز. - تعامل مع ملف إعداد العميل كسر: فهو يحتوي على مفتاح API الخاص بك. لا ترفعه إلى مستودع.
- إذا كان المفتاح ربما تسرّب، فاختر تغيير في بطاقة مفتاح API بلوحة التحكم. يُنشئ هذا مفتاحًا جديدًا ويُبطل القديم؛ ثم حدّث عميل MCP.
- مع مفتاح API منسوخ من لوحة تحكم فريق، يسرد المساعد AuthTokens وأنفاقك أنت فقط في ذلك الفريق. راجع إدارة الفريق.
استكشاف الأخطاء وإصلاحها #
يبلّغ العميل عن 401، أو «API key is required. Provide Authorization: Bearer <apikey>»
الطلب لا يحمل ترويسة Authorization صالحة. تحقق من أن العميل يرسل ترويسات مخصصة لهذا الخادم، وأن القيمة هي Bearer ثم مسافة ثم المفتاح، وأن المفتاح لم يتغير في لوحة التحكم منذ نسخته.
يقول المساعد إن أداة أعادت «Error: …»
هذا ردّ Localtonet، لا مشكلة في الاتصال. يبيّن النص بعد Error: ما الذي رُفض، مثل AuthToken مفقود أو حد في الخطة. عالج هذا السبب بدلًا من ترك المساعد يعيد المحاولة.
أُنشئ النفق لكنه لا يستجيب
اطلب من المساعد تشغيله. النفق الجديد متوقف إلى أن تُستدعى StartTunnel، ويجب أن يكون عميل Localtonet على الجهاز متصلًا.
الأدوات مفقودة في عميلي
تحدّ بعض العملاء من عدد الأدوات أو تطلب منك تفعيلها واحدة واحدة. فعّل أدوات Localtonet التي تحتاجها في إعدادات العميل.