Bridge

SXL Studio Bridge — небольшая программа, которая запускается на вашем компьютере и связывает работающий плагин SXL Studio с внешними инструментами: Cursor, Claude Desktop и другими MCP-клиентами, а также скриптами. Через неё AI-агент может читать и менять токены, переменные, стили, композиции и данные в открытом файле Figma. Та же программа обслуживает Local Workspace и Local Storage.

#Требования

Bridge слушает только локальный адрес 127.0.0.1: к нему нельзя подключиться с другого компьютера.

#Установка и запуск

npm install -g @sxl-studio/bridge

sxl-bridge

Bridge занимает один порт, по умолчанию 37830. На нём работают подключение плагина, MCP-адрес http://127.0.0.1:37830/mcp и HTTP-запросы http://127.0.0.1:37830/api/.... Если порт занят, задайте другой через переменную окружения:

BRIDGE_PORT=39999 sxl-bridge

Тот же порт потом нужно указать в плагине и в настройках MCP-клиента.

Проверка, что программа запущена:

sxl-bridge health

#Подключение плагина: Remote Connect

1. Запустите Bridge и откройте плагин в файле Figma в режиме Design.
2. В подвале плагина нажмите кнопку Remote Connect. Плагин свернётся в компактную строку с состоянием подключения.
3. Разверните строку кнопкой со стрелками, чтобы открыть окно подключения: здесь поле Port, поле Token для защищённого режима и переключатель Allow destructive commands.
4. Состояние Connected — Waiting for commands означает, что агент может отправлять команды.

Компактная строка Remote Connect в подвале плагина: состояние подключения, Disconnect и кнопка разворота.

Окно Remote Connect: порт, токен, идентификаторы сессии и клиента, переключатель Allow destructive commands.

Пока подключение активно, вкладки плагина скрыты. Нажмите Disconnect, чтобы вернуться к обычному интерфейсу. Плагин запоминает порт между сессиями.

#Опасные команды

Удаление слоёв, переменных и коллекций, сброс идентификаторов синхронизации и hard pull заблокированы по умолчанию. Чтобы разрешить их, включите Allow destructive commands в окне Remote Connect. Разрешение действует до отключения. Даже с включённым переключателем агент обязан явно подтверждать каждую опасную команду.

Перед export_variables можно проверить экспорт через preview_export_variables. Sort упорядочивает стили и их папки без смены ID; переставлять существующие коллекции, моды и переменные публичный API Figma не позволяет. Эти MCP-инструменты игнорируют старую настройку allowDestructiveReorder. Удаление осиротевших объектов остаётся отдельным опасным действием. См. Экспорт переменных и стилей.

#Защищённый режим

Если Bridge запущен с переменной BRIDGE_AUTH_TOKEN, все подключения должны предъявить тот же токен: введите его в поле Token окна Remote Connect, в форму подключения Local Storage и в настройки MCP-клиента.

BRIDGE_AUTH_TOKEN=my-secret sxl-bridge

#Подключение AI-инструмента

Bridge работает по протоколу MCP. Для Cursor добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "sxl-studio": {
      "url": "http://127.0.0.1:37830/mcp"
    }
  }
}

Другие MCP-клиенты подключаются к тому же адресу. Запускайте Bridge до открытия чата с агентом, иначе инструменты не появятся в списке. Первое, что стоит попросить агента: вызвать get_operator_runbook, он описывает, с чего начинать, и get_plugin_status, он показывает, видит ли Bridge плагин.

#Что может агент

Полный список отдаёт сам Bridge: инструмент list_tools или адрес http://127.0.0.1:37830/api/tools.

Инструменты предпросмотра и аудита ничего не меняют. Инструменты записи принимают dryRun: true для проверки без изменений. Большие ответы Bridge сокращает до сводки, полный вариант можно запросить отдельно.

#Bridge и режимы Figma

#Local Workspace

Bridge читает и записывает файлы токенов и данных в папке на диске для режима Local Workspace и хранит большие файлы Local Storage для Git-подключений. Для этого не нужен Remote Connect: достаточно запущенного Bridge и включённого профиля в настройках синхронизации. Порт и токен задаются на вкладке Local Workspace окна Synchronization settings. Подробнее: Local Workspace и Local Storage.

#Если что-то не работает

#Связанные страницы

• Local Workspace
• Local Storage
• Композиции
• Генерация кода