Localtonet MCP सर्वर
इस पेज पर 9 सेक्शन
Localtonet MCP सर्वर Model Context Protocol सपोर्ट करने वाले AI असिस्टेंट, जैसे Claude या Cursor, को आपका खाता सामान्य भाषा में मैनेज करने देता है: टनल की सूची देखना, बनाना, शुरू करना, रोकना और कॉन्फ़िगर करना, और AuthToken, टोकन ग्रुप, सर्वर और SSO प्रोवाइडर मैनेज करना।
यह क्या है, और क्या नहीं है #
- इस पेज का MCP सर्वर Localtonet द्वारा
https://localtonet.com/mcpपर चलाया जाता है। इसके टूल आपके Localtonet खाते पर वैसे ही काम करते हैं जैसे REST API करता है। - MCP गेटवे एक टनल प्रकार है। यह आपके अपने डिवाइस पर चल रहे MCP सर्वर को सार्वजनिक एड्रेस देता है। इसका इस्तेमाल अपने टूल प्रकाशित करने के लिए करें, Localtonet को मैनेज करने के लिए नहीं।
कनेक्शन विवरण #
| सेटिंग | मान |
|---|---|
| एंडपॉइंट | https://localtonet.com/mcp |
| ट्रांसपोर्ट | 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 क्लाइंट रिमोट सर्वर को URL और हेडर के रूप में लेते हैं। आम रूप यह है:
MCP क्लाइंट कॉन्फ़िगरेशन{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }फ़ाइल का नाम और कुंजियों के सटीक नाम क्लाइंट के हिसाब से अलग होते हैं। अपने क्लाइंट का दस्तावेज़ देखें कि रिमोट MCP सर्वर कहाँ कॉन्फ़िगर होते हैं, और ऊपर का URL और हेडर इस्तेमाल करें।
-
कनेक्शन जाँचें #
क्लाइंट को रीलोड करें। 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 ढूँढता है, एक सर्वर चुनता है, सही create टूल को कॉल करता है, और टनल शुरू करता है, क्योंकि नया बनाया गया टनल चालू नहीं होता।
टूल #
नीचे दिए गए टूल के नाम वही हैं जो आपका क्लाइंट दिखाता है। जो टूल नाकाम होता है, वह 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 |
सेटिंग्स क्या करती हैं, इसका वर्णन सेटिंग्स रेफ़रेंस में है।
AuthToken और टोकन ग्रुप #
| उद्देश्य | टूल |
|---|---|
| AuthToken | 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 | आपके खाते से जोड़े गए कंप्यूटरों की सूची देता है, जो मेरे डिवाइस में दिखते हैं, साथ में यह कि हर एक ऑनलाइन है या नहीं और उसका CPU, मेमोरी और डिस्क उपयोग। |
GetDeviceMetrics | एक डिवाइस के CPU, मेमोरी, डिस्क और अपटाइम के ताज़ा आँकड़े लौटाता है। |
RunDeviceCommand | डिवाइस पर एक शेल कमांड चलाता है और उसका आउटपुट व एग्ज़िट कोड लौटाता है। यह आपके दिए टाइमआउट तक इंतज़ार करता है, 1 से 120 सेकंड, डिफ़ॉल्ट 30। |
RunDeviceCommand को API कुंजी के अलावा भी कुछ चाहिए: इसके लिए डिवाइस एक्सेस कुंजी (जो ltd_ से शुरू होती है) ज़रूरी है, जिसे आप उस डिवाइस के लिए मेरे डिवाइस में बनाते हैं। देखें डिवाइस टर्मिनल। हर रन डिवाइस की कनेक्शन हिस्ट्री में उसके समय और IP एड्रेस के साथ दिखता है; कमांड सेव नहीं की जाती।
सीमाएँ #
- MCP सर्वर को भेजे गए अनुरोधों पर, आपकी API कुंजी के API अनुरोधों के साथ मिलाकर, रेट लिमिट लगती है।
429जवाब का मतलब है: रुकें, फिर दोबारा कोशिश करें। - बल्क टूल 100 आइटम तक की सूची लेते हैं।
सुरक्षा #
असिस्टेंट आपकी API कुंजी से काम करता है। उसके टूल टनल बना, रोक और हटा सकते हैं, AuthToken और टोकन ग्रुप हटा सकते हैं, और एक्सेस नियम बदल सकते हैं, और Localtonet की ओर से कोई पुष्टि का चरण नहीं होता।
- अपने MCP क्लाइंट में टूल कॉल के लिए पुष्टि चालू करें, कम से कम उन टूल के लिए जो
Delete,BulkDelete,StopऔरSetसे शुरू होते हैं। RunDeviceCommandकी डिवाइस एक्सेस कुंजी सिर्फ़ ऐसे असिस्टेंट को दें जिसे आप उस कंप्यूटर का टर्मिनल भी देंगे। कमांड डिवाइस के डिफ़ॉल्ट शेल से चलाई जाती है।- क्लाइंट कॉन्फ़िगरेशन फ़ाइल को गुप्त रखें: उसमें आपकी API कुंजी होती है। उसे किसी रिपॉज़िटरी में कमिट न करें।
- अगर कुंजी लीक हो गई हो सकती है, तो डैशबोर्ड के API कुंजी कार्ड में बदलें चुनें। इससे नई कुंजी बनती है और पुरानी अमान्य हो जाती है; फिर अपना MCP क्लाइंट अपडेट करें।
- टीम डैशबोर्ड में कॉपी की गई API कुंजी के साथ असिस्टेंट उस टीम में सिर्फ़ आपके AuthToken और टनल की सूची देता है। देखें टीम मैनेजमेंट।
समस्या निवारण #
क्लाइंट 401 बताता है, या "API key is required. Provide Authorization: Bearer <apikey>"
अनुरोध में मान्य Authorization हेडर नहीं है। जाँचें कि क्लाइंट इस सर्वर के लिए कस्टम हेडर भेजता है, मान Bearer, एक स्पेस, फिर कुंजी है, और कॉपी करने के बाद डैशबोर्ड में कुंजी बदली नहीं गई है।
असिस्टेंट कहता है कि किसी टूल ने "Error: …" लौटाया
यह Localtonet का जवाब है, कनेक्शन की समस्या नहीं। Error: के बाद का टेक्स्ट बताता है कि किस चीज़ से इनकार हुआ, जैसे AuthToken का न होना या प्लान की सीमा। असिस्टेंट को दोबारा कोशिश करने देने के बजाय उस वजह को ठीक करें।
टनल बन गया लेकिन जवाब नहीं देता
असिस्टेंट से उसे शुरू करने को कहें। नया टनल StartTunnel कॉल होने तक रुका रहता है, और डिवाइस का Localtonet क्लाइंट कनेक्टेड होना चाहिए।
मेरे क्लाइंट में टूल नहीं दिख रहे
कुछ क्लाइंट टूल की संख्या सीमित करते हैं या उन्हें एक-एक करके चालू करने को कहते हैं। क्लाइंट की सेटिंग में अपने काम के Localtonet टूल चालू करें।