Skip to content

Версии документации

MCP и совместное редактирование ​

Левая панель Binary GIN объединяет конвертер и подключения MCP. Несколько клиентов могут работать с одним открытым документом VS Code. Вы видите их правки, действия и рендеры и можете вмешаться, продолжая обычное редактирование.

Скачать и подключить ​

Адаптер MCP входит в VSIX начиная с 0.6.3. Отдельно скачивать MCP, устанавливать Python, запускать pip или собирать Zstd не требуется.

  1. Скачайте VSIX для своей платформы из релиза 0.6.3 и установите расширение.
  2. Откройте доверенную рабочую область и файл BGIN в VS Code.
  3. Откройте левую панель Binary GIN → MCP connections.
  4. Нажмите Copy MCP configuration и вставьте настройки в конфигурацию MCP вашего клиента. Если клиент использует другую оболочку настроек, перенесите значения command и args из скопированного JSON.
  5. Запустите подключение в клиенте. Его имя и действия появятся в панели VS Code.

Copy client command копирует команду для PowerShell под Windows или оболочки macOS/Linux. Она запускает встроенный bgin_backend с --mcp. Путь уже указывает на установленное расширение; искать исполняемый файл вручную не нужно. Каждому клиенту задайте своё имя в --client-name.

json
{
  "mcpServers": {
    "bgin": {
      "command": "<полный путь к встроенному bgin_backend>",
      "args": ["--mcp", "--mode", "connected", "--editor-bridge", "<файл подключения>", "--client-name", "My assistant"]
    }
  }
}

Не копируйте заполнители из примера: кнопка формирует реальные пути вашего окна. Файл подключения содержит локальный ключ; не включайте его в общедоступные архивы. После переустановки расширения или смены окна скопируйте настройки заново, если путь больше недоступен. Для WSL, SSH и контейнеров адаптер должен запускаться в той же среде, где работает расширение: удалённый путь нельзя запускать на локальном компьютере.

Для рендеров нужен Chrome или Microsoft Edge, установленный в среде адаптера. Браузерный драйвер уже включён в VSIX; браузер отдельно не загружается при первом подключении. Чтение и редактирование работают и без браузера. Если нужного браузера нет, рендер сообщит об этом.

При недоступном окне подключённый режим выдаёт ошибку, а не переходит к отдельной дисковой копии. Отдельный режим для файлов запускается явно с --mcp --mode standalone.

Что видят пользователь и модель ​

Клиент начинает с bgin_editor, затем читает документ через bgin_read. Правка передаёт полученную revision как base_revision и уникальный operation_id. После проверки данных ревизия сверяется повторно. Чужие правки, сделанные за это время, приводят к конфликту: клиент должен перечитать документ. Повтор запроса с тем же идентификатором не применяет уже выполненную правку дважды.

Ручные несохранённые изменения видны в общем документе. Даже временно неверный JSON остаётся текущим текстом: клиент не получает скрытую старую корректную копию. Правки входят в обычную историю Undo/Redo VS Code. Запись на диск требует отдельного сохранения; сохранение удерживает исходный формат BGIN.

Подписка на bgin://editor/state уведомляет об изменениях. Сервер отправляет уведомление, но момент появления события в контексте уже работающей модели определяется клиентом MCP. Проверка ревизии защищает от применения устаревшей правки.

Вмешаться в работу ​

Панель показывает клиентов, текущие операции и последние события. Вы можете:

  • Открыть затронутый документ и вручную исправить его.
  • Приостановить правки клиента и затем возобновить их.
  • Остановить ещё не применённую операцию.
  • Отключить сессию клиента.

Остановка не отменяет ранее выполненные изменения. Для них используйте Undo. Рендеры клиента появляются в галерее с автором; после изменения документа прежний результат помечается устаревшим. Настройки ресурсов общие с рабочей областью. Предпросмотр остаётся предпросмотром, а не запущенной игрой.