Localtonet MCP sunucusu
Bu sayfada 9 bölüm
- Ne olduğu ve ne olmadığı
- Bağlantı ayrıntıları
- Başlamadan önce
- MCP istemcinizi bağlayın
- Sunucuyu istemciye ekleyin
- Bağlantıyı kontrol edin
- Tünel oluşturun
- Araçlar
- Tüneller
- Tünel yapılandırması
- AuthToken'lar ve token grupları
- Sunucular ve SSO sağlayıcıları
- Proxy tünellerinde VPN erişimi
- Cihazlar
- Limitler
- Güvenlik
- Sorun giderme
- İlgili sayfalar
Localtonet MCP sunucusu, Model Context Protocol'ü destekleyen Claude veya Cursor gibi bir yapay zeka asistanının hesabınızı doğal dille yönetmesini sağlar: tünelleri listeleme, oluşturma, başlatma, durdurma ve yapılandırma; AuthToken'ları, token gruplarını, sunucuları ve SSO sağlayıcılarını yönetme.
Ne olduğu ve ne olmadığı #
- Bu sayfadaki MCP sunucusu, Localtonet tarafından
https://localtonet.com/mcpadresinde çalıştırılır. Araçları, REST API ile aynı şekilde Localtonet hesabınız üzerinde işlem yapar. - MCP Ağ Geçidi bir tünel türüdür. Kendi cihazınızda çalışan bir MCP sunucusuna herkese açık bir adres verir. Localtonet'i yönetmek için değil, kendi araçlarınızı yayımlamak için kullanın.
Bağlantı ayrıntıları #
| Ayar | Değer |
|---|---|
| Uç nokta | https://localtonet.com/mcp |
| Aktarım | Streamable HTTP |
| Kimlik doğrulama | API anahtarınız, Bearer token olarak: Authorization: Bearer <YOUR_API_KEY> |
| Sunucu bilgileri | localtonet.com/mcp-info (JSON) ve https://localtonet.com/.well-known/mcp-server-card adresindeki sunucu kartı |
Başlamadan önce #
- Uzak bir sunucuya Streamable HTTP üzerinden bağlanabilen ve özel bir
Authorizationbaşlığı gönderebilen bir MCP istemcisi. - API anahtarınız. Panel sayfasını açın ve API Anahtarı kartındaki Kopyala düğmesini kullanın. Bkz. Hesap ve güvenlik.
- Tünel işleri için: asistanın tünel oluşturabileceği bir AuthToken'a sahip olması amacıyla Localtonet istemcisinin bağlı olduğu bir cihaz.
MCP istemcinizi bağlayın #
-
Sunucuyu istemciye ekleyin #
Çoğu MCP istemcisi uzak bir sunucuyu bir URL ve başlıklar olarak alır. Olağan biçim şöyledir:
MCP istemci yapılandırması{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }Dosya adı ve tam anahtar adları istemciler arasında farklılık gösterir. Uzak MCP sunucularının nerede yapılandırıldığını istemcinizin belgelerinden öğrenin ve yukarıdaki URL ile başlığı kullanın.
-
Bağlantıyı kontrol edin #
İstemciyi yeniden yükleyin. Localtonet araçları araç listesinde görünmelidir. Önce zararsız bir şey sorun, örneğin:
İstemList my Localtonet tunnels and tell me which ones are running. -
Tünel oluşturun #
Ne istediğinizi anlatın. Örneğin:
İstemCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.Asistan, sunucunun öngördüğü iş akışını izler: cihazın AuthToken'ını bulur, bir sunucu seçer, uygun oluşturma aracını çağırır ve tüneli başlatır; çünkü yeni oluşturulan bir tünel çalışmıyor durumundadır.
Araçlar #
Aşağıdaki araç adları, istemcinizin gösterdiği adlardır. Başarısız olan bir araç, Error: ile başlayan bir ileti döndürür.
Tüneller #
| Amaç | Araçlar |
|---|---|
| İnceleme | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Oluşturma | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Çalıştırma | StartTunnel, StopTunnel, DeleteTunnel |
| Değiştirme | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Toplu işlem | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Tünel yapılandırması #
| Ayar | Araçlar |
|---|---|
| IP kısıtlamaları | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Erişim kontrolleri | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Başlıklar ve kimlik doğrulama | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Son kullanma ve limitler | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Sunucu ve port | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argümanlar ve not | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Rotasyonlu Proxy istemcileri ve token grupları | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Gelişmiş ayarlar | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
Ayarların ne yaptığı Ayarlar başvuru kılavuzu sayfasında açıklanır.
AuthToken'lar ve token grupları #
| Amaç | Araçlar |
|---|---|
| AuthToken'lar | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Uçak modu ve IP değiştirme | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Token grupları | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Sunucular ve SSO sağlayıcıları #
| Amaç | Araçlar |
|---|---|
| Sunucular | GetAvailableServers |
| SSO sağlayıcıları | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
Proxy tünellerinde VPN erişimi #
GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Bu araçlar bir proxy tünelindeki WireGuard ve OpenVPN cihazlarını yönetir. Her cihaz kendi yapılandırmasını alır ve tüm trafiği proxy üzerinden çıkar.
Cihazlar #
| Araç | Ne yapar |
|---|---|
ListDevices | Hesabınızla Cihazlarım altında eşleştirilmiş bilgisayarları, her birinin çevrimiçi olup olmadığıyla ve CPU, bellek ve disk kullanımıyla birlikte listeler. |
GetDeviceMetrics | Bir cihazın en son CPU, bellek, disk ve çalışma süresi değerlerini döndürür. |
RunDeviceCommand | Bir cihazda tek bir kabuk komutu çalıştırır ve çıktısını ile çıkış kodunu döndürür. Verdiğiniz zaman aşımına kadar bekler; bu 1 ile 120 saniye arasındadır, varsayılan 30'dur. |
RunDeviceCommand, API anahtarından fazlasını gerektirir: Cihazlarım altında o cihaz için oluşturduğunuz bir cihaz erişim anahtarı (ltd_ ile başlar) şarttır. Bkz. Cihaz Terminali. Bir çalıştırma, cihazın bağlantı geçmişinde zamanı ve IP adresiyle görünür; komut saklanmaz.
Limitler #
- MCP sunucusuna yapılan istekler, API anahtarınızın API istekleriyle birlikte hız sınırına tabidir.
429yanıtı şu anlama gelir: bekleyin, ardından tekrar deneyin. - Toplu araçlar en fazla 100 öğelik bir liste kabul eder.
Güvenlik #
Asistan, API anahtarınızla işlem yapar. Araçları, Localtonet tarafında bir onay adımı olmadan tünel oluşturabilir, durdurabilir ve silebilir, AuthToken'ları ve token gruplarını silebilir ve erişim kurallarını değiştirebilir.
- MCP istemcinizde, en azından
Delete,BulkDelete,StopveSetile başlayan araçlar için araç çağrılarında onayı açın. RunDeviceCommandiçin cihaz erişim anahtarını yalnızca o bilgisayarda bir terminal de vereceğiniz bir asistana verin. Komut, cihazın varsayılan kabuğu tarafından çalıştırılır.- İstemci yapılandırma dosyasını gizli bir bilgi olarak değerlendirin: API anahtarınızı içerir. Onu bir depoya göndermeyin (commit etmeyin).
- Anahtarın sızmış olabileceğini düşünüyorsanız panelde API Anahtarı kartındaki Değiştir düğmesini seçin. Bu işlem yeni bir anahtar oluşturur ve eskisini geçersiz kılar; ardından MCP istemcinizi güncelleyin.
- Bir ekip panelinde kopyalanan bir API anahtarıyla asistan, o ekipteki yalnızca sizin AuthToken'larınızı ve tünellerinizi listeler. Bkz. Ekip Yönetimi.
Sorun giderme #
İstemci 401 bildiriyor veya "API key is required. Provide Authorization: Bearer <apikey>"
İstekte geçerli bir Authorization başlığı yok. İstemcinin bu sunucu için özel başlıklar gönderdiğini, değerin Bearer, bir boşluk ve ardından anahtar olduğunu ve anahtarı kopyaladığınızdan beri panelde değiştirilmediğini kontrol edin.
Asistan, bir aracın "Error: …" döndürdüğünü söylüyor
Bu, Localtonet'in yanıtıdır, bir bağlantı sorunu değildir. Error: sonrasındaki metin neyin reddedildiğini söyler; örneğin eksik bir AuthToken veya bir plan limiti. Asistanın yeniden denemesine izin vermek yerine bu nedeni giderin.
Tünel oluşturuldu ama yanıt vermiyor
Asistandan onu başlatmasını isteyin. StartTunnel çağrılana kadar yeni bir tünel durmuş durumdadır ve cihazın Localtonet istemcisi bağlı olmalıdır.
İstemcimde araçlar eksik
Bazı istemciler araç sayısını sınırlar veya araçları tek tek etkinleştirmenizi ister. İhtiyacınız olan Localtonet araçlarını istemci ayarlarında etkinleştirin.