MCP Ağ Geçidi tüneliyle MCP araçlarını yayınlama
Desktop v7.8+ Mobile v10.1+
Bu sayfada 8 bölüm
- Ne olduğu
- Başlamadan önce
- Ağ geçidini oluşturun
- MCP Ağ Geçidi sayfasını açın
- Formu doldurun
- Tüneli başlatın
- URL türleri
- Ağ Geçidi Token'ı
- Bir MCP istemcisini bağlama
- Ağ geçidi panelini açın
- MCP sunucularınızı kaydedin
- İstemci token'ı oluşturun
- MCP istemcisini ağ geçidine yönlendirin
- Ayarlar
- Sorun giderme
- İlgili sayfalar
Bir MCP Ağ Geçidi tüneli, MCP istemcilerini ve yapay zekâ asistanlarını cihazınızda çalışan araçlara herkese açık bir ağ geçidi üzerinden bağlar. Ağ geçidini sizin için Localtonet istemcisi çalıştırır, tünel ise ona herkese açık bir HTTPS adresi verir.
Ne olduğu #
Model Context Protocol (MCP), bir yapay zekâ asistanının araçları çağırmasını sağlar. Bir MCP ağ geçidi, çalıştırdığınız MCP sunucularının önünde durur ve tüm araçlarını tek bir uç nokta üzerinden sunar.
Bir MCP Ağ Geçidi tünelini başlattığınızda Localtonet istemcisi cihazınızda bir ağ geçidi başlatır ve Localtonet onu tünelin adresinde yayınlar. Yerel IP veya port girmezsiniz. Ağ geçidinde şunlar bulunur:
- MCP sunucularını kaydettiğiniz ve istemci token'ları oluşturduğunuz,
https://<ADDRESS>/dashboardadresindeki bir web paneli; - MCP istemcilerinizin bağlandığı,
https://<ADDRESS>/mcpadresindeki MCP uç noktası.
Localtonet MCP sunucusuyla aynı şey değildir. Bu sayfa kendi araçlarınızı yayınlamakla ilgilidir. Bir yapay zekâ asistanının Localtonet hesabınızı (tüneller, token'lar vb.) yönetmesini sağlamak için MCP sunucusu sayfasına bakın.
Başlamadan önce #
- Localtonet istemcisi cihazda çalışıyor ve bir AuthToken ile bağlı. Bkz. Hızlı başlangıç.
- İstemci yeterince yeni. Bu özelliği kullanmak için gereken en düşük Localtonet Uygulaması sürümleri:
Desktop v7.8,Mobile v10.1.
Ağ geçidini oluşturun #
-
MCP Ağ Geçidi sayfasını açın #
Tünellerim › MCP Ağ Geçidi sayfasını açın ve MCP Ağ Geçidi Tüneli Oluştur bölümünü genişletin.
-
Formu doldurun #
Alan Ne girilmeli URL türü Rastgele alt alan adı, Özel alt alan adı veya Özel alan adı. Aşağıdaki tabloya bakın. Cihaz token'ı Araçlarınızı çalıştıran cihazın token'ı. Sunucu bölgesi MCP istemcilerinizin bağlandığı sunucu. Alt alan adı Özel alt alan adı için gösterilir: istediğiniz ad. Alan adı Adresin alan adı. Tünel oluştur düğmesini seçin.
-
Tüneli başlatın #
Ağ geçidi Tünelleriniz altında görünür. Başlat düğmesini seçin. URL sütunu herkese açık adresi gösterir.
URL türleri #
| URL türü | Aldığınız adres | Notlar |
|---|---|---|
| Rastgele alt alan adı | Seçtiğiniz alan adı altında oluşturulan bir ad. | İlk deneme için iyidir. |
| Özel alt alan adı | Seçtiğiniz Alan adı altında girdiğiniz Alt alan adı. | Bakiye gerekir. |
| Özel alan adı | Kendi alan adlarınızdan biri. | Bakiye gerekir. Alan adı listesi alan adlarınızı gösterir; boşsa önce DNS Yöneticisi'nden bir alan adı oluşturun. Bkz. Özel alan adları. |
Ağ Geçidi Token'ı #
Her MCP Ağ Geçidi tüneli oluşturulduğunda kendi Ağ Geçidi Token'ını alır. Bu, ağ geçidinin yönetici token'ıdır: ağ geçidi paneli ve yönetim API'si değişiklikleri yalnızca onunla kabul eder.
- Tünelin Ayarlar simgesini seçin.
- Ağ Geçidi Token'ı yanındaki Yönet düğmesini seçin. Ağ geçidi token'ı penceresi token'ı ortası gizli olarak gösterir.
- Token'ın yanındaki kopyala düğmesini seçin. Her zaman token'ın tamamını kopyalar. Yanındaki göster düğmesi token'ı ekranda gösterir.
Ağ Geçidi Token'ını gizli tutun. Ağ geçidinin sunucuları, araçları ve istemci token'ları üzerinde tam denetim sağlar. Onu bir MCP istemcisine girmeyin; istemciler kendi token'larını kullanır.
Bir MCP istemcisini bağlama #
-
Ağ geçidi panelini açın #
Tünel başlatılmışken bir tarayıcıda
https://<ADDRESS>/dashboardadresini açın. Ağ Geçidi Token'ını yan menünün altındaki Admin token alanına yapıştırın. -
MCP sunucularınızı kaydedin #
Servers bölümünü açın ve Add Server düğmesini seçin. Bir sunucu, URL ile erişilen bir MCP sunucusu (Streamable HTTP veya SSE), yerel bir komut (stdio) veya bir OpenAPI hizmeti olabilir. Catalog kurabileceğiniz hazır MCP sunucularını listeler, Tools ise ağ geçidinin tüm sunuculardan topladığı araçları gösterir.
-
İstemci token'ı oluşturun #
Clients bölümünü açın ve New Client düğmesini seçin. Bir Name girin ve Create Client düğmesini seçin. Ağ geçidi Client Token değerini yalnızca bir kez gösterir: şimdi kopyalayın, bir daha gösterilmeyecek. İstemci listesinde Allowed Servers ve Allowed Groups, bir istemcinin hangi sunucuları ve araç gruplarını kullanabileceğini gösterir.
-
MCP istemcisini ağ geçidine yönlendirin #
MCP istemcinizde veya yapay zekâ asistanınızda şu iki değerle uzak bir MCP sunucusu ekleyin:
MCP istemci ayarlarıURL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>Bunları nereye gireceğiniz istemciye bağlıdır; uzak (HTTP) MCP sunucuları için istemcinin kendi belgelerini izleyin.
Panelin Audit Log bölümü son ağ geçidi isteklerini gösterir, Settings ise yedekleme ve geri yükleme ile ağ geçidi yapılandırmasını içerir.
Ağ geçidi sunucularını, gruplarını, istemcilerini ve denetim günlüğünü cihazınızda, Localtonet istemcisinin çalışma dizinindeki mcp-data-<TUNNEL_ID> adlı bir klasörde saklar (Android'de uygulamanın kendi depolama alanında). <TUNNEL_ID>, ID sütunundaki sayıdır; bu nedenle her MCP Ağ Geçidi tünelinin kendi klasörü vardır.
Ayarlar #
Tünel ayarları penceresini açmak için tünelin Ayarlar simgesini seçin.
| Ayar | Ne yapar | Daha fazla |
|---|---|---|
| Yük Dengeleme | Trafiği cihazlara dağıtın veya bir hedef kullanılamadığında yedek kullanın. | Yük dengeleme |
| Yalnızca HTTPS mi? | Herkese açık tünel uç noktası için yalnızca HTTPS kullanın. | Ayarlar başvuru kılavuzu |
| Basic Auth? | Bu tünele erişmek için kullanıcı adı ve parola iste. | Erişim kontrolü |
| HTTP/3 Aktif mi? | İstemcilerin herkese açık uç noktaya HTTP/3 kullanarak bağlanmasına izin ver. | Ayarlar başvuru kılavuzu |
| Eski Bağlantı Yöntemi? | Tünel normal bağlantı yöntemiyle bağlanamıyorsa bunu deneyin. | Ayarlar başvuru kılavuzu |
| Ağ Geçidi Token'ı | Bu MCP Ağ Geçidi için erişim token'ını yönetin. | Yukarıya bakın |
| HTTP Zaman Aşımı | Sunucunun, isteği iptal etmeden önce yerel uygulamanızdan yanıt için ne kadar bekleyeceği; 1 ile 600 saniye arasında. Sunucu varsayılanını kullanmak için boş bırakın. | Ayarlar başvuru kılavuzu |
| Tünel Notu | Bu tüneli tanımanıza veya belgelemenize yardımcı olacak özel bir not kaydedin. | Ayarlar başvuru kılavuzu |
| IP Kısıtlaması | Bu tünele hangi istemci IP adreslerinin erişebileceğini denetleyin. | Erişim kontrolü |
| Bitiş Tarihi, Hız Limitleri, Bant Genişliği Limiti, Bant Genişliği Kullanımı | Bitiş tarihi, yükleme ve indirme hız limitleri, bir veri aktarım limiti ve kaydedilen kullanımı sıfırlamak için Temizle. | Limitler ve son kullanma |
| Giden Port | Localtonet uygulamasının sunucu bağlantısı için sabit bir giden port seçin. | Portlar |
| Bant Genişliği Trafiği, İstek Günlüğü, Etkinlik Günlüğü, Tünel Sağlığı | Zaman içindeki trafik, kaydedilen istekler, başlatma, durdurma ve ayar değişiklikleri ile son sağlık denetimi sonuçları. | Günlükler ve inceleme |
Tünel listesinde Webhook'lar sütunu, başlatılmış bir tünel için istek denetleyicisini açan bir İstek ve yanıt günlüklerini görüntüle düğmesi içerir. Bkz. Günlükler ve inceleme.
Sorun giderme #
Ağ geçidi başlamıyor veya adres yanıt vermiyor
Cihazdaki Localtonet uygulamasının sürümünü kontrol edin: MCP Ağ Geçidi için en az Desktop v7.8 veya Mobile v10.1 gerekir. Ardından tünelin başlatıldığını ve Bağlantı sütununda cihazın bağlı göründüğünü kontrol edin.
Ağ geçidi paneli verilerini yüklemiyor
Panelin yönetim istekleri yönetici token'ını gerektirir. Admin token alanı boş veya yanlış. Ağ Geçidi Token'ını tünelin Ayarlar bölümünden yeniden kopyalayın ve alana yapıştırın.
MCP istemcisi reddediliyor
MCP uç noktası, Authorization: Bearer başlığında bir istemci token'ı gerektirir. Ağ geçidi panelinde Clients altında bir tane oluşturun ve burada Ağ Geçidi Token'ını değil onu kullanın.
"Lütfen önce tünelinizi başlatın."
İstek denetleyicisi yalnızca tünel başlatılmışken kullanılabilir.
"DNS Yöneticisi'nden bir Alan Adı oluşturmalısınız!" veya "UYARI! Hiç Alan Adınız yok!"
Özel alan adı için kendi alan adlarınızdan biri gerekir. Onu DNS Yöneticisi'nde ekleyin veya başka bir URL türü seçin.
"Bu özelliği kullanmak için bakiye satın almanız gerekir."
Özel alt alan adı ve Özel alan adı için Bakiye gerekir. Rastgele alt alan adı kullanın veya Bakiye ekleyin. Bkz. Planlar ve Bakiye.