Kbox ETS MCP

Kbox ETS MCP, ETS6'da o anda açık olan KNX projenizi bir yapay zekâ ajanının okumasına ve üzerinde çalışmasına izin veren bir ETS uygulamasıdır. ETS'in içinde çalışır; yani ajan projenin canlı hâlini görür — ekranda gördüğünüz topolojinin, cihazların, grup adreslerinin ve parametrelerin aynısını.

Bu kılavuz, uygulamayı kurmaktan Claude'a ilk sorunuzu sormaya kadar olan yolu anlatır.

Başlamadan önce

• ETS 6 kurulu ve bir proje açık olmalı. Proje açık olmadan sunucunun konuşacağı bir şey yoktur.
• Uzaktan bağlantı için bir Kbox hesabı. Bir kez giriş yapacaksınız.
• En kolay kurulum için Claude Desktop, ya da dilerseniz MCP destekli herhangi bir ajan (web'deki Claude, Codex, Gemini CLI).

1. ETS uygulamasını kurun

.etsapp dosyasını herhangi bir ETS uygulamasını kurduğunuz gibi kurun. ETS'i yeniden başlatmanız gerekmez — uygulama kurulduğu anda kullanılabilir.

2. Paneli açın

Uygulama kendiliğinden açılmaz ve kendine ait bir sekme eklemez. Araç çubuğundan açın: Panels → All Panels → Kbox → Kbox ETS MCP.

Bu kılavuzdaki her şey o panelde olup biter. Kbox ETS MCP'nin yanındaki yıldıza basarak sabitleyin; bir sonraki sefer tek tıkla erişilir.

Bağlanmadan önce uyarıyı okuyun

Panel bilinçli olarak bir uyarıyla açılır ve bu uyarı bir dakikanızı hak eder:

Bu sunucu, bağlanan bir yapay zekâ ajanına binanın tüm topolojisini, eksiksiz cihaz envanterini ve bus üzerindeki her cihazın yazılım durumunu verebilir. Bu veri genellikle bilgisayarınızdan çıkar ve bulutta çalışan bir dil modeli tarafından işlenir. Salt okuma erişimi bile bunların tamamını açar; yazma ve çevrimiçi kademeleri ajanın projeyi veya çalışan tesisatı değiştirmesine de izin verir.

Kısacası: en güvenli kademe bile projenizin içeriğini bir dil modeline gönderir. Kararınızı buna göre verin.

3. Claude'un ne yapabileceğini seçin

Üç kademe var; her biri kendinden öncekinin izin verdiği her şeyi de kapsar:

• Read only — projeyi, katalogu ve ana verileri okur. Hiçbir şey değişmez.
• Can edit the project — açık projeyi değiştirir. Her değişiklik bir ETS geri alma işaretiyle sarılır, yani ETS'ten geri alınabilir.
• Can talk to devices — bus üzerinden gerçek donanımla haberleşir: okuma, yazma, indirme ve yazılım güncellemesi. Geri alınamaz ve her seferinde tek tek onaylanır.

Kapatılamayan iki güvenlik önlemi vardır:

• Ajan kendi kademesini yükseltemez. Yazma veya çevrimiçi erişimi yalnızca ETS'in başındaki kişi açabilir.
• Yükseltilmiş izinler her ETS başlangıcında salt okumaya döner. Yazma veya çevrimiçi erişimi açmak yalnızca o oturum için verilmiş bir karardır.

Araç grupları

Which tools are on? altında grupların tamamını kapatabilirsiniz — Topology, Group addresses, Communication objects, Parameters, Buildings, Catalog, Undo history, Bus, Device management, Network management, Commissioning, Jobs, Export, Navigation. Kapattığınız bir grup ajana hiç sunulmaz.

4. Bağlanın

İki yol var. Birini seçin.

A seçeneği — Başka bir yerden (varsayılan)

Panel bu seçenekle açılır. Web'deki Claude için veya ajan ETS'in kurulu olduğu bilgisayarda çalışmıyorsa bunu kullanın. İki adımdır: önce bu bilgisayara izin verirsiniz, sonra projeyi Claude'a tanıtırsınız. Siz bu düğmelere basmadan hiçbir bağlantı kurulmaz.

1. adım — Bu bilgisayara izin verin

Panel, kodunuzu da taşıyan bir adres gösterir; örneğin https://id.kboxsolutions.com/device?user_code=XXXX-XXXX.

1. Copy'ye basın.
2. Adresi bir tarayıcıda açın — bu bilgisayarda ya da telefonunuzda.
3. Sayfanın gösterdiği kodun panelde yazan kodla aynı olduğunu doğrulayın.
4. Kbox hesabınızla giriş yapıp onaylayın.

Panel siz bunu yaparken bekler ve onayladığınızda kendiliğinden ilerler. Fikriniz değişirse Cancel'a basın. Revoke this computer's access verdiğiniz izni sonradan geri alır.

2. adım — Bu projeyi Claude'a tanıtın

Panelden Server adresini kopyalayın — https://mcp.etsmcp.kboxsolutions.com/mcp — ardından Claude tarafında tanımlayın.

Claude'u açıp Customize → Connectors'a gidin:

+ Add'e basın, bir ad verin ve sunucu adresini yapıştırın:

Claude nasıl giriş yapılacağını kendisi algılar. Detected olarak görünen varsayılanlar doğru olanlardır — Sign in now ve Use Claude's published identity. Request headers alanını boş bırakın; bu sunucu başlık istemez.

Add'e basın. Bağlayıcı listede görünür ama henüz bağlı değildir — Connect'e basın:

Claude'a yetki vermek için Kbox giriş sayfasına yönlendirilirsiniz:

Kılavuzdaki hesap alanı karartılmıştır; sizde kendi kullanıcı kimliğiniz ve e-posta adresiniz görünür. Sayfa, tam olarak neye izin verdiğinizi listeler:

• ETS projenizi okuma — topoloji, cihazlar, grup adresleri, parametreler ve ürün katalogu.
• ETS projenizi değiştirme — grup adresi, parametre, cihaz ve topoloji oluşturma ve düzenleme. Her değişiklik ETS'te geri alınabilir tek bir kayıttır.

Authorize'a basın; bağlanmış hâlde Claude'a dönersiniz.

Bu yetki bir tavandır, anahtar değil. Burada proje değişikliğine izin vermek onu açmaz. Ajan yalnızca hem bu yetkinin hem de ETS panelinde açılmış kademenin izin verdiği şeyi yapabilir — ve ETS tarafı her ETS yeniden başlatmasında salt okumaya döner.

B seçeneği — Bu bilgisayardaki Claude Desktop

Yalnızca ETS'in kurulu olduğu bilgisayarda çalışan bir ajan için. Claude Desktop sunucuyla doğrudan stdio üzerinden konuşur; terminal, düzenlenecek JSON dosyası ve elle kopyalanacak token yoktur.

1. On this computer'ı seçin.
2. Connect Claude Desktop'a basın.
3. Claude Desktop'ı yeniden başlatın.

Kurulumun tamamı bu — eşleştirme yok, sunucu adresi yok.

5. Claude'da araç izinlerini ayarlayın

Claude, sunucunun araçlarını salt okuma ve yazma/silme olarak gruplar ve her birinin ne zaman çalışabileceğine karar vermenizi sağlar: Always allow, Needs approval veya Blocked.

Makul bir başlangıç: salt okuma araçlarını Always allow'da bırakın, yazma/silme grubunu ise ajanın projenizle ne yaptığına güvenene kadar Needs approval'da tutun. Grup içindeki tek tek araçlar için ayrı karar verebilirsiniz.

Bu, ikinci ve bağımsız bir frendir. ETS kademesinin yerini almaz — kademenin zaten izin verdiği alanı daraltır.

6. Bir şey sorun

Bir sohbet açıp proje hakkında soru sorun. Örneğin:

• "Bu projede kaç cihaz var ve hangi hatlarda?"
• "1/2 altındaki tüm grup adreslerini listele ve her birine hangi cihazların bağlı olduğunu söyle."
• "Salondaki termostatın hangi haberleşme objeleri bağlanmamış?"
• "0/3/1 ile 0/3/8 arasında Mutfak Işık 1 … 8 adlarıyla grup adresleri oluştur."

Değişiklikler siz izlerken ETS'e düşer. Her biri ETS'in kendi geri alma listesinde tek bir kayıttır; yani ETS'te Ctrl+Z onu geri alır.

Gerçek donanıma dokunan her şey — bus okuma veya yazma, indirme, yazılım güncellemesi — ETS'te bir onay penceresi açar ve bir insanın cevabını bekler. Ajan sizin yerinize onaylayamaz.

7. Diğer ajanlar (Codex, Gemini CLI)

Panelde Advanced bölümünü açın. Yerel adres, erişim token'ı ve diğer araçlar için hazır yönergeleri gösterir.

• Endpoint — sunucunun dinlediği yerel adres, ör. http://127.0.0.1:62560/mcp.
• Access token — yalnızca Claude dışındaki araçların ihtiyacı olur. Show veya Copy'ye basın; Regenerate anında yenisini üretir.
• Export directory — dışa aktarılan dosyaların yazıldığı dizin.

Token her ETS başlangıcında değişir. Ajanınız bağlanmayı bırakırsa buraya dönüp yenisini kopyalayın. (Yukarıdaki ekran görüntüsünde token karartılmıştır — sizde gerçek bir değer görünür.)

Turn access off, ETS'i kapatmadan sunucuyu durdurur.

Bilinmesi gerekenler

• ETS'te bir proje açık olmalı. Proje açık değilse araçlar reddeder ve bunu söyler.
• İzin kademesi her ETS yeniden başlatmasında salt okumaya döner — bu bir hata değil, tasarım tercihidir.
• Proje değişiklikleri ETS'ten geri alınabilir. Bus işlemleri alınamaz; her birinin ayrı ayrı onaylanmasının sebebi de budur.
• Ajan ne ETS şifrenizi ne de Kbox şifrenizi görür. Giriş tarayıcınızda yapılır ve sunucuya yalnızca bir token ulaşır.

Sorun giderme

• Ajan proje açık olmadığını söylüyor — ETS'te bir proje açın, sonra tekrar deneyin.
• Ajan izni olmadığını söylüyor — ETS panelinde daha yüksek bir kademe açın. Bunun ETS yeniden başladığında sıfırlandığını unutmayın. Ayrıca aracın Claude'un bağlayıcı ayarlarında Blocked olmadığını kontrol edin.
• Claude dışı bir ajan bağlanmayı bıraktı — ETS yeniden başlamış, yani erişim token'ı değişmiş. Yenisini Advanced'den kopyalayın.
• Eşleştirme kodunun süresi doldu — Cancel'a basıp 1. adımı yeni bir kodla baştan başlatın.
• Bir araç grubu görünmüyor — panelde Which tools are on? altında kapatılmıştır.