Локальний API керування та MCP

Коли вибирати цей сервіс

Використовуйте локальний API керування, коли програмі на комп’ютері SSApp потрібне схвалене керування застосунком і джерелами. Використовуйте вбудований адаптер MCP, коли сумісний клієнт ШІ має отримати ці елементи керування як інструменти.

Це окремо від File > Enable Local Server, що запускає ретранслятор WebSocket для сторінок Social Stream. Див. Пояснення локальних серверів і сервісів якщо не впевнені, який сервіс вам потрібен.

1. Завантажте звичайний настільний застосунок

Установіть поточний випуск Social Stream Ninja з завантажень для Windows, macOS або Linux. Підтримка MCP входить до завантаженого застосунку. Вам не потрібні репозиторій вихідного коду, Node, Python або окремий пакет MCP.

2. Увімкніть локальне керування ШІ

Відкрити File > Local AI / Automation.
Увімкнути Локальний API керування та дозвольте застосунку перезапуститися.
Поверніться до того самого меню й виберіть Copy MCP Setup.
Вставте скопійований JSON у налаштування MCP інструмента ШІ, а потім перезапустіть цей інструмент.

Скопійовані налаштування містять точний шлях до встановленого виконуваного файлу, порт і аргументи для вашої платформи. Завантажений виконуваний файл Social Stream Ninja запускає власний легкий адаптер MCP, коли клієнт ШІ запускає його з --ssapp-mcp.

3. Дозвольте MCP виявити можливості

Після підключення клієнт MCP автоматично запитує інструменти Social Stream Ninja. Адаптер зчитує актуальні можливості запущеного застосунку й надає LLM схеми підтримуваних інструментів, версії застосунку/API та робочі інструкції. Агент має спочатку викликати capabilities, потім status і використовувати стабільні ID джерел, які повертає застосунок.

Для звичайного використання MCP не потрібні зчитування сайтів або встановлення навичок. Користувач може просто попросити підключеного агента перевірити Social Stream Ninja або керувати ним.

Доступні локальні елементи керування

Перелік, перевірка, додавання, оновлення та видалення джерел.
Запуск, зупинка або перезавантаження одного джерела чи відфільтрованої групи.
Зміна видимості джерела, стану звуку та режиму підключення.
Читання та оновлення підтримуваних глобальних налаштувань, повернутих під час виявлення можливостей.
Читання стану застосунку, сесії, джерела, процесу, захоплення та локальних медіа.
Відстеження обмежених потоків захоплених подій джерел і потоків подій операцій чи стану з можливістю поновлення.
Захоплення та безпечний перегляд підтримуваних сторінок джерел і вікон SSApp.
Виконання схвалених взаємодій зі сторінками, вікнами та діалогами з підтвердженням.
Перезавантаження або коректне завершення застосунку з явним підтвердженням.

Можливості запущеного застосунку є визначальними. Старіші версії можуть надавати менше елементів керування.

Прямий HTTP-доступ для локальних скриптів

Скрипти на тому самому комп’ютері можуть використовувати API зворотної петлі без MCP. Він прослуховує лише 127.0.0.1 і не потребує токена.

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

Використовуйте оголошені можливості, не припускаючи, що всі версії застосунку мають однакове керування. Готові до копіювання curl приклади додавання, переліку, запуску, перевірки та зупинки джерела наведено в покроковому посібнику з HTTP API сервера.

Локальний ШІ на Ubuntu VPS

API також може обслуговувати інструмент ШІ, що працює на тому самому сервері Linux, що й екземпляр SSApp без графічного інтерфейсу. Залишайте прив’язку до адреси зворотної петлі та використовуйте завантажений AppImage як команду MCP.

Підписка Запуск Social Stream Ninja без інтерфейсу , де описані Xvfb, постійні профілі, команди запуску, systemd та окремий шлях дистанційного керування. Він також містить Конфігурація MCP для Linux AppImage , яку можна вставити в клієнт, що працює на VPS.

Необов’язкова навичка агента

Агенти, які підтримують установлювані навички, можуть завантажити повну навичку Control Social Stream. Також можна прочитати її інструкції онлайн, з довідник API і журнал версій. Навичка додає інструкції щодо робочих процесів, але не потрібна для підключення MCP.

Машиночитані посилання для виявлення можливостей також наведено в llms.txt.

Лише локально

Цей інтерфейс призначений для ШІ та автоматизації на тому самому комп’ютері, що й SSApp. Не відкривайте й не тунелюйте його як хмарний API дистанційного керування. Віддалені користувачі та Stream Deck мають використовувати наявне підключення Social Stream через WebRTC або WebSocket. Локальний API не надає довільного виконання JavaScript, cookie, секретів входу, необмежених налаштувань або прямого доступу до файлової системи.

Повний список кінцевих точок, схем команд, визначення версії та меж безпеки наведено в технічному довіднику з автоматизації.

API локального керування та MCP