Версии документации
MCP и совместное редактирование
Левая панель Binary GIN объединяет конвертер и подключения MCP. Несколько клиентов могут работать с одним открытым документом VS Code. Вы видите их правки, действия и рендеры и можете вмешаться, продолжая обычное редактирование.
Скачать и подключить
Адаптер MCP входит в VSIX начиная с 0.6.3. Отдельно скачивать MCP, устанавливать Python, запускать pip или собирать Zstd не требуется.
- Скачайте VSIX для своей платформы из релиза 0.6.3 и установите расширение.
- Откройте доверенную рабочую область и файл BGIN в VS Code.
- Откройте левую панель Binary GIN → MCP connections.
- Нажмите Copy MCP configuration и вставьте настройки в конфигурацию MCP вашего клиента. Если клиент использует другую оболочку настроек, перенесите значения
commandиargsиз скопированного JSON. - Запустите подключение в клиенте. Его имя и действия появятся в панели VS Code.
Copy client command копирует команду для PowerShell под Windows или оболочки macOS/Linux. Она запускает встроенный bgin_backend с --mcp. Путь уже указывает на установленное расширение; искать исполняемый файл вручную не нужно. Каждому клиенту задайте своё имя в --client-name.
{
"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. Рендеры клиента появляются в галерее с автором; после изменения документа прежний результат помечается устаревшим. Настройки ресурсов общие с рабочей областью. Предпросмотр остаётся предпросмотром, а не запущенной игрой.