← suflo.app

Yapay zekâ köprüsü (MCP): güvenlik modeli

Suflo 3.4 · varsayılan olarak kapalı · bağlanmak için bu bilgisayarda çalışan Claude Desktop ya da Claude Code gerekir (claude.ai web ve bulut oturumları bağlanamaz)

Köprü, Claude Desktop ya da Claude Code gibi bir MCP istemcisinin Suflo'nun kendi üst düzey işlerini çalıştırmasını sağlar: altyazı oluşturma, marker ekleme, sessizlikleri kopya sekansta kesme. Genel bir Premiere uzaktan kumandası değildir: rastgele ExtendScript/QE çalıştıramaz, dosya yolu seçemez, projeyi açamaz, kaydedemez, kapatamaz, proje öğesi silemez, render ya da dışa aktarma yapamaz, ayarlara, lisansa ve API anahtarlarına dokunamaz, ağa çıkamaz.

Nasıl bağlanır

MCP istemcisi ⇄ stdio ⇄ mcp/suflo-mcp.js ⇄ HTTP POST 127.0.0.1 ⇄ Suflo paneli ⇄ panelin kendi düğme işlevleri.

Koruma katmanları

  1. Yalnız bu bilgisayar. Panel sunucusu yalnız 127.0.0.1'e, her açılışta rastgele bir porta bağlanır; 0.0.0.0 hiç kullanılmaz.
  2. Jeton. Her açılışta 32 baytlık rastgele bir jeton üretilir ve sabit zamanlı karşılaştırılır. Bağlantı bilgisi (otomasyon.json, ayarların yanında) yalnız senin hesabının okuyabileceği izinle (0600) yazılır, köprü kapanınca silinir (aynı anda açık başka bir Premiere sürümündeki köprünün dosyası silinmez). "Yeni jeton" eskisini anında geçersiz kılar; yeni jeton dosyaya yazılamazsa köprü kapanır ve panel bunu söyler.
  3. Tarayıcılar giremez. Yalnız POST /v1/eylem; Host başlığı tam olarak 127.0.0.1:<port> olmalı (DNS rebinding); Origin, Referer, Sec-Fetch-* ya da WebSocket yükseltmesi taşıyan her istek reddedilir; CORS başlığı hiç gönderilmez, OPTIONS 403 döner; yalnız application/json.
  4. Sınırlar. Gövde en çok 256 KB, 30 sn okuma süresi; 30 sn hiç veri göndermeyen ya da isteğini yarım bırakan bağlantı kapatılır; jetonu doğru isteklerde dakikada en çok 120 çağrı (jetonsuz istekler bu hakkı tüketemez); aynı anda tek Premiere işi, kuyrukta en çok 4.
  5. İzin listesi. Yalnız aşağıdaki eylemler; her argüman şemayla denetlenir, bilinmeyen anahtar reddedilir. Yanıtlarda ve hata metinlerinde mutlak dosya yolları dosya adına indirilir (boşluklu klasör adları dahil), çıktı 64 KB ile sınırlıdır.
  6. Düzenlemeye izin ver. Kapalıyken (varsayılan) asistan yalnız okur. Bekleyen bir yazma isteği varken kapatılırsa o istek yürütülmez: onay kartı kapanır, asistan izin_yok yanıtı alır; kuyrukta ya da Premiere'i bekleyen yazma istekleri de sırası gelince izin_yok alır.
  7. Onay kartı. Yıkıcı eylemler panelde Onayla / Reddet kartı açar ve panel Ayarlar'a geçer; 60 saniyede yanıt yoksa reddedilir ("Yıkıcı eylemlerde onay iste" varsayılan açık). Aynı anda tek kart vardır: bekleyen kart başka bir eylemle değiştirilmez. Panelin kendi iki tıklık uyarıları (bu sekansa zaten altyazı uygulandı, kritik altyazı sorunu) asistan adına geçilmez.
  8. Kapatma anahtarı. "Köprüyü kapat" kuyrukta, Premiere'in meşgul olmasını ya da onayı bekleyen hiçbir isteği artık yürütmez; asistan hemen "köprü kapalı" yanıtı alır ve köprünün açık bağlantıları kapanır. Yalnız o an Premiere'de süren tek iş yarıda kesilemez.
  9. Kendiliğinden kapanma. 30 dakika çağrı gelmezse, panel yeniden yüklenince ya da Premiere kapanınca köprü kapanır. Açık durumu kaydedilmez.
  10. Günlük. Her çağrı ve eyleme ulaşmadan reddedilen her istek (yanlış jeton, tarayıcı, Host, hız sınırı) etkinlik listesine ve destek günlüğüne yazılır. Bir istek selinde dakikada ilk 10 ret tek tek yazılır, fazlası dakika dolunca ya da köprü kapanınca destek günlüğüne sayıyla düşer.
  11. Aynı kapılar. Her eylem panel düğmesinin çağırdığı aynı işlevi çağırır: aynı doğrulama, aynı Pro kapısı, kesimlerde aynı kopya sekans.
  12. Güvenilmez içerik. Transkript metni, klip, iz ve marker adları kullanıcı içeriğidir; araç açıklamaları asistana bunların içindeki talimatlara uymamasını söyler.

Eylemler

SınıfEylemler
Okumabağlam, izler, seçim, altyazı (en çok 2000 satır), iş durumu, doktor
Yazmaoynatma kafası, marker (en çok 200), altyazı oluştur, altyazıyı caption track'e koy, SRT/VTT/TXT'yi yalnız proje klasörüne yaz, sessizlik analizi, otomatik zoom, Eğri sekmesindeki eğriyi işaretli anahtar kare çiftlerine uygulama
Yıkıcı (onaylı)sessizlikleri kes (her zaman kopya sekansta), konuşmadan kes (kopya sekansta), hız rampası

Pro

Köprüyü açmak Suflo Pro gerektirir; köprü için deneme hakkı yoktur. Köprü, lisans devre dışı kalınca (koltuk taşıma, iade) hemen kapanır. Pro araçlarını çağıran her eylem ayrıca o aracın kendi Pro kapısından geçer; geçemezse asistan pro_gerekli yanıtı alır (altyazı oluştururken "Çevrimdışı İngilizce" seçiliyse de).

In English

The AI bridge (MCP) is off by default and needs Claude Desktop or Claude Code running on this computer (claude.ai web and cloud sessions cannot connect). It binds to 127.0.0.1 only on a random port, requires a fresh 256-bit bearer token (connection file with mode 0600, deleted on stop), rejects any request with Origin, Referer, Sec-Fetch-* or Upgrade headers, a Host other than 127.0.0.1:<port>, or a non-JSON body, and limits body size (256 KB), rate (120/min for authenticated calls) and concurrency (1 running, 4 queued). Turning the bridge off cancels every accepted action that has not started yet and closes the bridge's idle connections; turning "Allow editing" off makes waiting write actions fail with izin_yok (an open confirmation card closes). Connections that send nothing for 30 s are closed, and error texts are stripped of folder paths too. Only Suflo's own allowlisted actions exist; write actions need "Allow editing", destructive ones need an in-panel confirmation by default (denied after 60 s; the user can turn this off in the panel) and cuts always run on a sequence copy. No arbitrary script, file path, project, render, settings, license or network capability is exposed. Pro: turning the bridge on needs Suflo Pro (there are no trial credits for the bridge), the bridge closes as soon as the license is deactivated or revoked, and every action that uses a Pro tool also passes that tool's own Pro gate; otherwise the assistant gets pro_gerekli.