İçeriğe geç
Localtonet Localtonet Panel

Localtonet MCP sunucusu

Bu sayfa için yardım al
Bu sayfada 9 bölüm
  1. Ne olduğu ve ne olmadığı
  2. Bağlantı ayrıntıları
  3. Başlamadan önce
  4. MCP istemcinizi bağlayın
  5. Sunucuyu istemciye ekleyin
  6. Bağlantıyı kontrol edin
  7. Tünel oluşturun
  8. Araçlar
  9. Tüneller
  10. Tünel yapılandırması
  11. AuthToken'lar ve token grupları
  12. Sunucular ve SSO sağlayıcıları
  13. Proxy tünellerinde VPN erişimi
  14. Cihazlar
  15. Limitler
  16. Güvenlik
  17. Sorun giderme
  18. İ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/mcp adresinde ç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ı #

AyarDeğer
Uç noktahttps://localtonet.com/mcp
AktarımStreamable HTTP
Kimlik doğrulamaAPI anahtarınız, Bearer token olarak: Authorization: Bearer <YOUR_API_KEY>
Sunucu bilgilerilocaltonet.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 Authorization baş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 #

  1. 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.

  2. 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:

    İstem
    List my Localtonet tunnels and tell me which ones are running.
  3. Tünel oluşturun #

    Ne istediğinizi anlatın. Örneğin:

    İstem
    Create 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
İncelemeGetTunnels, GetTunnel, GetTunnelRequestLogs
OluşturmaCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
ÇalıştırmaStartTunnel, StopTunnel, DeleteTunnel
DeğiştirmeUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
Toplu işlemBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Tünel yapılandırması #

AyarAraçlar
IP kısıtlamalarıGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Erişim kontrolleriGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Başlıklar ve kimlik doğrulamaGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Son kullanma ve limitlerGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Sunucu ve portGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argümanlar ve notGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Rotasyonlu Proxy istemcileri ve token gruplarıGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Gelişmiş ayarlarGetAdvancedTunnelSettings, 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'larGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Uçak modu ve IP değiştirmeGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Token gruplarıGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Sunucular ve SSO sağlayıcıları #

AmaçAraçlar
SunucularGetAvailableServers
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
ListDevicesHesabı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.
GetDeviceMetricsBir cihazın en son CPU, bellek, disk ve çalışma süresi değerlerini döndürür.
RunDeviceCommandBir 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. 429 yanı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, Stop ve Set ile başlayan araçlar için araç çağrılarında onayı açın.
  • RunDeviceCommand iç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.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek