baglan-mcp
v0.2.0
Published
Bağlan MCP sunucusu: Claude Code hesabındaki bilgisayarları uzaktan kullanır (ekran, fare, klavye, terminal, dosya).
Readme
baglan-mcp
Claude Code (ya da herhangi bir MCP istemcisi) Bağlan hesabındaki bilgisayarları uzaktan kullanır: ekran görüntüsü, fare, klavye, terminal komutu ve dosyalar. Trafik Bağlan sunucusundan geçer; bilgisayarlar farklı ağlarda ve NAT arkasında olsa da port açmak gerekmez.
Kurulum
Kullanılacak bilgisayarda Bağlan › Bu bilgisayar › Claude erişimi: Claude'un ne yapabileceğini aç (ekran/fare/klavye, terminal, dosyalar; hepsi varsayılan kapalı).
Aynı yerde Claude Code'a bağla → çıkan komutu Claude Code'un çalıştığı bilgisayarda çalıştır:
claude mcp add baglan --scope user --env BAGLAN_TOKEN=bga_… -- npx -y baglan-mcpAnahtarı düz metin yerine 1Password'de tutmak için (
opCLI):claude mcp add baglan --scope user -- sh -c 'BAGLAN_TOKEN="$(op read "op://Kasa/Öğe/credential")" exec npx -y baglan-mcp'
Anahtar sadece bir kez gösterilir; "Verilen erişimler" listesinden istendiği an kaldırılır ve bağlı ajan hemen düşer. Claude çalışırken o bilgisayarın ekranında bildirim görünür.
Araçlar
| Araç | Ne yapar | İzin |
|---|---|---|
| list_computers | Hesaptaki bilgisayarlar, açık mı, ne izin veriyor | — |
| computer_info | İşletim sistemi, kullanıcı, ekranlar | herhangi biri |
| screenshot | Ekran görüntüsü (JPEG); tıklama koordinatları bunun pikselleri | ekran |
| click, move_mouse, drag, scroll | Fare | ekran |
| type_text, press_key | Klavye (type_text düzenden bağımsız, Türkçe karakterler dahil) | ekran |
| run_command | Kabuk komutu (Mac: kullanıcının kabuğu, Windows: PowerShell) | terminal |
| list_directory, read_file, write_file | Dosyalar | dosyalar |
| download_file, upload_file | Claude'un bilgisayarı ↔ uzak bilgisayar, 3 MB'lık parçalarla | dosyalar |
Bağlı oturumlar (müşteri modu)
Bilgisayarlarından biri Bağlan ile başka bir bilgisayara (ör. bir müşterinin) bağlıyken
list_computers o bağlantıyı oturum:… hedefiyle gösterir. Ekran, fare, klavye, komut ve dosya
gönderme o bağlantının içinden, senin adınla çalışır: karşı tarafta ayar gerekmez, ekranında her
zamanki gibi "<adın> kontrol ediyor" görünür; çalıştırılan komutlar bildirim olarak düşer.
Komut çalıştırma için karşıda Bağlan 1.10.10 ya da yenisi gerekir.
Büyük dosyalar
1 MB'tan büyük yüklemeler ve tüm indirmeler, kurulabildiğinde bilgisayarla doğrudan bir WebRTC veri
kanalından gider (sunucuya uğramaz; node-datachannel). Kurulamazsa 3 MB'lık parçalarla sunucu
üzerinden gider.
Ortam değişkenleri
BAGLAN_TOKEN: uygulamadan alınan ajan anahtarı (bga_…), zorunlu.BAGLAN_SERVER: varsayılanbaglan.appo.com.tr; yerel deneme için127.0.0.1:8080.
Nasıl çalışır
agent-hello ile sunucuya girer, agent-call ile komutu bilgisayara yollar, agent-result ile
cevabı alır. Sunucu yalnızca hesabın kendi bilgisayarlarına ve onların izin verdiği komutlara
iletir; bilgisayar da ayrıca kontrol eder. Ayrıntı: server/src/agent.ts, app/lib/agent_host.dart.
Uçtan uca deneme: server/test/agent_e2e_server.ts ile yerel sunucu, uygulamayı
--dart-define=BAGLAN_SERVER=127.0.0.1:8096 ile aç, sonra node e2e.mjs 127.0.0.1:8096 <token> "<bilgisayar>" <klasör>.
