Yerel Kontrol API'si ve MCP

Bu hizmeti ne zaman seçmeli?

SSApp bilgisayarındaki yazılımın onaylı uygulama ve kaynak kontrollerine ihtiyacı olduğunda Yerel Kontrol API'sini kullanın. Uyumlu bir yapay zekâ istemcisinin bu kontrolleri araç olarak alması gerektiğinde paketlenmiş MCP bağdaştırıcısını kullanın.

Bu, şundan ayrıdır: Dosya > Yerel sunucuyu etkinleştir; bu, Social Stream sayfaları için bir WebSocket aktarıcısı başlatır. Şuna bakın: Yerel sunucular ve hizmetlerin açıklaması hangi hizmete ihtiyacınız olduğundan emin değilseniz.

1. Normal masaüstü uygulamasını indirin

Güncel Social Stream Ninja sürümünü şuradan yükleyin: Windows, macOS veya Linux indirmeleri. MCP desteği indirilen uygulamaya dahildir. Kaynak deposuna, Node'a, Python'a veya ayrı bir MCP paketine ihtiyacınız yoktur.

2. Yerel yapay zekâ kontrolünü etkinleştirin

1. Açın: Dosya > Yerel Yapay Zekâ / Otomasyon.
2. Şunu etkinleştirin: Yerel Kontrol API'si ve uygulamanın yeniden başlamasına izin verin.
3. Aynı menüye dönüp şunu seçin: MCP kurulumunu kopyala.
4. Kopyalanan JSON'u yapay zekâ aracının kullandığı MCP ayarlarına yapıştırın, ardından aracı yeniden başlatın.

Kopyalanan kurulum, yüklü yürütülebilir dosyanın tam yolunu, bağlantı noktasını ve platforma özgü bağımsız değişkenleri içerir. Yapay zekâ istemcisi şu bağımsız değişkenle başlattığında indirilen Social Stream Ninja yürütülebilir dosyası kendi hafif MCP bağdaştırıcısını başlatır: --ssapp-mcp.

3. Keşfi MCP yapsın

Bağlandıktan sonra MCP istemcisi otomatik olarak Social Stream Ninja'dan araçlarını ister. Bağdaştırıcı, çalışan uygulamanın canlı yeteneklerini okur ve LLM'ye desteklenen araç şemalarını, uygulama/API sürümlerini ve kullanım talimatlarını verir. Ajan önce capabilities, sonra status çağırmalı ve uygulamanın döndürdüğü sabit kaynak kimliklerini kullanmalıdır.

Normal MCP kullanımı için web sitesi kazıma veya beceri yükleme gerekmez. Kullanıcı, bağlı ajandan doğrudan Social Stream Ninja'yı incelemesini veya kontrol etmesini isteyebilir.

Kullanılabilir yerel kontroller

• Kaynakları listeleyin, inceleyin, ekleyin, güncelleyin ve kaldırın.
• Tek bir kaynağı veya filtrelenmiş bir grubu başlatın, durdurun ya da yeniden yükleyin.
• Kaynak görünürlüğünü, sessiz durumunu ve bağlantı modunu değiştirin.
• Yetenek keşfinin döndürdüğü desteklenen genel ayarları okuyun ve güncelleyin.
• Uygulama, oturum, kaynak, işlem, yakalama ve yerel medya durumunu okuyun.
• Sınırlandırılmış yakalanan kaynak etkinliklerini ve kaldığı yerden sürdürülebilen işlem veya durum etkinliklerini takip edin.
• Desteklenen kaynak sayfalarını ve SSApp'e ait pencereleri yakalayın ve güvenli biçimde inceleyin.
• Onaylı sayfa, pencere ve iletişim kutusu etkileşimlerini doğrulamayla gerçekleştirin.
• Açık onayla uygulamayı yeniden yükleyin veya düzgün biçimde kapatın.

Çalışan uygulamanın yetenekleri esas alınır. Eski sürümler daha az kontrol sunabilir.

Yerel betikler için doğrudan HTTP erişimi

Aynı bilgisayardaki betikler MCP olmadan yerel döngü API'sini kullanabilir. Yalnızca şurada dinler: 127.0.0.1 ve belirteç gerektirmez.

GET http://127.0.0.1:17777/api/v1/capabilities
GET http://127.0.0.1:17777/api/v1/status
GET http://127.0.0.1:17777/api/v1/events
POST http://127.0.0.1:17777/api/v1/command

Her uygulama sürümünde aynı kontrollerin olduğunu varsaymak yerine bildirilen yetenekleri kullanın. Kopyalayıp yapıştırabileceğiniz curl kaynak ekleyen, listeleyen, başlatan, inceleyen ve durduran örnekler için şuna bakın: sunucu HTTP API'si anlatımı.

Ubuntu VPS üzerinde yerel yapay zekâ

API, arayüzsüz SSApp örneğiyle aynı Linux sunucusunda çalışan bir yapay zekâ aracına da hizmet verebilir. Yerel döngüye bağlı tutun ve MCP komutu olarak indirilen AppImage'ı kullanın.

Takip Social Stream Ninja'yı başsız modda çalıştırın Xvfb, kalıcı profiller, başlangıç komutları, systemd ve ayrı uzaktan kontrol yolu için. Ayrıca şunu içerir: Linux AppImage MCP yapılandırması VPS'de çalışan bir istemciye yapıştırabilirsiniz.

İsteğe bağlı ajan becerisi

Yüklenebilir becerileri destekleyen ajanlar şunu yapabilir: Control Social Stream becerisinin tamamını indirebilir. Ayrıca şunu yapabilirsiniz: talimatlarını çevrimiçi okuyabilirsiniz, şu ayarla: API başvuru kaynağı ve sürüm günlüğü. Beceri, iş akışı rehberliği ekler ancak MCP bağlantısı için gerekli değildir.

Makine tarafından okunabilir keşif bağlantıları ayrıca şurada listelenir: llms.txt.

Yalnızca yerel

Bu arayüz, SSApp ile aynı bilgisayarda çalışan yapay zekâ ve otomasyon içindir. Bulut uzaktan kontrol API'si olarak dışa açmayın veya tünellemeyin. Uzak kullanıcılar ve Stream Deck, Social Stream'in mevcut WebRTC veya WebSocket bağlantısını kullanmalıdır. Yerel API; keyfî JavaScript çalıştırma, çerezler, giriş sırları, sınırsız ayarlar veya ham dosya sistemi erişimi sağlamaz.

Tüm uç noktalar, komut şemaları, sürüm keşfi ve güvenlik sınırları için şuna bakın: teknik otomasyon başvuru kaynağı.