ИИ + РЕДАКТОР КУРСОВ

Как подключить ИИ к Verstt через MCP

ИИ может собирать слайды, редактировать текст и интерактивы, настраивать вопросы и готовить экспорт. Ниже — настройка локального подключения и 10 готовых запросов для работы с курсами.

Verstt ·

Что даёт MCP

MCP — протокол, через который ИИ-клиент получает инструменты Verstt. Вы описываете задачу обычным языком, а агент читает структуру курса, меняет объекты и проверяет результат. Например, может добавить вопрос, изменить триггер или показать снимок слайда.

Verstt предоставляет локальный stdio-сервер: ИИ-клиент запускает установленное приложение с аргументом --mcp. Для подключения нужны команда и аргументы, а не адрес сайта verstt.com. MCP-сервер, зависимости и среда запуска входят в приложение; устанавливать Node.js, скачивать исходники и поднимать сервер на VPS не требуется.

Нужен клиент, умеющий запускать локальные MCP-серверы: например, Claude Desktop, Claude Code или локальный клиент Codex. Клиент должен работать в той же среде и под той же учётной записью ОС, что и Verstt, чтобы обращаться к открытому курсу. У ИИ-сервиса собственные условия доступа и оплаты; поддержка MCP в приложении не включает подписку на модель.

1. Подготовьте Verstt

  1. Установите актуальную версию Verstt для своей ОС и запустите её.
  2. Для первого опыта откройте новый пустой курс или копию редактируемого примера.
  3. Откройте Файл → Настройки приложения….
  4. Скопируйте поле «Конфигурация MCP-клиента». В нём находятся команда запуска именно вашей установленной копии и её аргументы.
  5. Чтобы агент работал с открытым курсом, включите «Разрешить ИИ-агентам править открытый курс (MCP)». Для режима правки закрытых файлов этот переключатель не нужен.
Начните с копии.

В открытом курсе изменения агента становятся видны сразу. Каждую MCP-правку можно отменить через Ctrl/Cmd + Z; сохраняйте исходник обычным способом в редакторе.

2. Подключите ИИ-клиент

Выберите один способ ниже. Если сервер verstt уже есть в настройках, обновите его запись. Сохраните остальные серверы и настройки клиента.

Claude Desktop: конфигурация JSON

Откройте файл claude_desktop_config.json. В интерфейсе с разделом Developer это Settings → Developer → Edit Config. Пути файла для разных ОС перечислены в официальной инструкции MCP. Добавьте объект verstt в существующий mcpServers, затем полностью перезапустите клиент.

Ниже — примеры структуры. Используйте путь из настроек своего Verstt; пример с YourName или yourname нужно заменить.

macOS · JSON
{
  "mcpServers": {
    "verstt": {
      "command": "/Applications/Verstt.app/Contents/MacOS/Verstt",
      "args": [
        "--mcp"
      ]
    }
  }
}
Windows · пример JSON
{
  "mcpServers": {
    "verstt": {
      "command": "C:\\Users\\YourName\\AppData\\Local\\Programs\\Verstt\\Verstt.exe",
      "args": [
        "--mcp"
      ]
    }
  }
}
Linux AppImage · пример JSON
{
  "mcpServers": {
    "verstt": {
      "command": "/home/yourname/Applications/Verstt-1.18.0-x86_64.AppImage",
      "args": [
        "--mcp"
      ]
    }
  }
}

В JSON обратные слеши Windows записываются как \\. На Linux укажите постоянный абсолютный путь к исполняемому AppImage: если конфигурация содержит временную папку /tmp/.mount_…, замените команду на путь к самому AppImage. Не перемещайте этот файл после настройки. Если он не запускается, разрешите выполнение в свойствах файла.

После перезапуска проверьте статус локального сервера в настройках Claude Desktop. В новом интерфейсе этот список находится в разделе расширений; расположение зависит от версии. Подробности и журналы описаны в справке Claude Desktop.

Claude Code: команда запуска

В терминале в рабочей папке добавьте сервер. Это пример для macOS; на Windows или Linux замените путь командой из конфигурации Verstt. Аргумент --mcp оставьте после разделителя --.

Терминал · пример macOS
claude mcp add --transport stdio verstt -- "/Applications/Verstt.app/Contents/MacOS/Verstt" --mcp
claude mcp get verstt

В Claude Code команда /mcp показывает доступные серверы. Если клиент предлагает подтвердить доверие или доступ к инструментам, проверьте, что запускается ваша установленная копия Verstt. Официальная инструкция Claude Code.

Codex: CLI или config.toml

Если установлен Codex CLI, добавьте локальный сервер командой ниже. Путь снова должен соответствовать вашей ОС и установке.

Терминал · пример macOS
codex mcp add verstt -- "/Applications/Verstt.app/Contents/MacOS/Verstt" --mcp
codex mcp list

Альтернатива — запись в конфигурации Codex ~/.codex/config.toml. Это TOML, поэтому JSON с ключом mcpServers сюда не вставляют. Не добавляйте второй блок verstt, если он уже существует.

Codex · пример TOML для macOS
[mcp_servers.verstt]
command = "/Applications/Verstt.app/Contents/MacOS/Verstt"
args = ["--mcp"]

Перезапустите локальный клиент или начните новый сеанс, чтобы он перечитал конфигурацию. В терминальном Codex список MCP-инструментов доступен через /mcp. Настройка stdio описана в официальной документации Codex. Для остальных клиентов перенесите поля command и args в их настройки локального MCP.

3. Проверьте связь

Откройте курс в Verstt, включите разрешение на работу с ним и отправьте первый запрос из библиотеки ниже. Агент должен назвать открытый курс и его структуру, ничего не меняя. В списке инструментов могут присутствовать app_status, course_overview, slide_add и другие инструменты Verstt; префикс имени зависит от клиента.

Перед первой правкой попросите прочитать verstt_guide — встроенную справку о структуре курса. Если инструменты есть, а app_status сообщает, что приложение недоступно, сам MCP-сервер уже подключён: проверяйте запуск редактора, переключатель и среду выполнения.

Два режима работы

РежимКак указать курсГде видны и сохраняются правки
Открытый курс@app, в том числе для ещё не сохранённого курса.Изменения попадают в редактор, доступны отмена и обычное сохранение.
Закрытый файлАбсолютный путь к .verstt.Сервер пишет прямо в файл; редактор не должен держать его открытым для параллельной правки.

Создание нового файла и создание в редакторе — разные действия. Чтобы работать в окне, сначала создайте пустой курс в Verstt и попросите заполнить @app. Инструмент course_create создаёт отдельный файл и требует путь; значение @app ему не подходит.

Для закрытого файла сначала завершите работу с ним в редакторе. Перед первой правкой существующего файла в сеансе MCP сервер создаёт рядом копию course.verstt.bak. Это резервная копия сеанса, а не история всех версий. После изменений откройте файл заново в Verstt.

В версии Mac App Store сохраняются ограничения песочницы. Для неё удобнее открыть документ через Verstt и использовать @app. Работа с произвольными путями и папками экспорта зависит от доступа, разрешённого ОС. Если несохранённый курс экспортируется через MCP, агенту нужно явно указать путь выходного файла.

10 примеров запросов

Копируйте запрос целиком и заменяйте тему, номера, названия и пути своими. В примерах с @app подразумевается включённый доступ к открытому курсу. Первым считается слайд 1; агент должен сопоставить ваш номер со структурой курса, а не передавать его в инструменты без проверки.

01. Проверить связь без изменений

Пример запроса
Подключись к MCP-серверу Verstt. Сначала прочитай verstt_guide, затем вызови app_status. Назови открытый курс и покажи краткую структуру через @app. Пока ничего не меняй.

02. Создать курс в открытом редакторе

Пример запроса
Работай с новым пустым курсом @app, который я открыл в Verstt. Создай вводный курс «Первый день в команде» для новых сотрудников: 5 слайдов 1280×720 — цель, рабочая ситуация с выбором, объяснение решения, вопрос с одним правильным ответом и итоги. Используй только сведения из приложенного текста. Недостающие факты сначала уточни. Сначала предложи структуру, после моего согласия собери курс. В конце проверь ссылки и покажи снимки слайдов.

03. Создать отдельный файл

Пример запроса
Создай новый курс в файле /Users/YOUR_NAME/Documents/Courses/onboarding.verstt — это пример пути, перед запуском я заменю его своим абсолютным путём. Не перезаписывай существующий файл. Тема: вводное обучение волонтёров. Сделай 4 слайда на русском: цель, ситуация, вопрос и итоги. Используй приложенные материалы; для отсутствующих иллюстраций оставь подписанные места. Сохрани исходник, выполни проверку и покажи снимки.

04. Привести оформление к одному стилю

Пример запроса
В курсе @app приведи слайды 2–4 к единому стилю: фон #F7F6F2, основной текст #292732, акцент #7357E8, поля не меньше 64 px. Сохрани смысл, ответы, баллы, триггеры и ветвления. Сначала перечисли план правок. После изменений покажи снимки этих слайдов и исправь наложения и обрезанный текст.

05. Отредактировать текст точечно

Пример запроса
В @app на слайде с названием «Порядок действий» сократи объяснение примерно до 60 слов, сохрани все шаги и важные условия. Не меняй другие слайды, оформление, ответы и логику. Покажи исходный и новый текст; примени только согласованную версию.

06. Добавить вопрос и проходной балл

Пример запроса
В @app после слайда 3 добавь вопрос из шаблона с одним правильным ответом: «Куда обратиться за помощью?» Варианты: «В общий чат поддержки», «Передать пароль коллеге», «Пропустить проблему». Правильный — первый. Дай 10 баллов, одну попытку и объясняющую обратную связь для каждого результата. Добавь или настрой слайд итогов с проходным порогом 80%, включи этот вопрос в расчёт. Проверь верный и неверный сценарии.

07. Сделать всплывающую подсказку

Пример запроса
В @app на слайде 2 добавь кнопку «Подробнее». По клику она должна показывать слой с текстом «Здесь можно задать уточняющий вопрос» и кнопкой «Закрыть». Закрытие скрывает только этот слой. Сохрани текущую навигацию. Проверь ссылки триггеров и покажи снимок с открытой подсказкой.

08. Добавить изображение из файла

Пример запроса
В @app на слайд «Знакомство» добавь изображение из локального файла /Users/YOUR_NAME/Documents/CourseAssets/team.png. Я заменю этот пример пути своим. Сохрани пропорции, не обрезай важные детали и не перекрывай заголовок. Не меняй остальные объекты. Если файл недоступен, сообщи об этом вместо подстановки случайной картинки. Покажи результат.

09. Проверить курс перед публикацией

Пример запроса
Проверь @app через course_validate: ссылки на слайды, слои, объекты и переменные, повторяющиеся идентификаторы и выход объектов за границы. Отдельно посмотри снимки всех слайдов, слои обратной связи и состояния кнопок. Составь список проблем. Исправляй только понятные технические ошибки, а неоднозначные решения сначала обсуди со мной. После правок повтори проверку.

10. Подготовить HTML и SCORM

Пример запроса
Прочитай актуальное состояние @app и выполни проверку. Если остались ошибки — сначала объясни их и остановись. Если ошибок нет, экспортируй HTML и SCORM 1.2 в выбранную мной папку; перед записью уточни абсолютные пути и не перезаписывай существующие файлы. В конце укажи получившиеся файлы и напомни, какие результаты нужно проверить в целевой LMS.

Как получать хороший результат

  1. Дайте контекст: для кого курс, чему он должен научить, сколько времени есть у слушателя и какие материалы являются источником фактов.
  2. Ограничьте правку: назовите слайды, желаемое действие и то, что нужно сохранить — ответы, баллы, триггеры, стиль.
  3. Работайте небольшими шагами: структура → 2–3 слайда → проверка → следующая часть. Так проще заметить неверное решение и отменить его.
  4. Просите показать результат: снимки помогают увидеть наложения, обрезанный текст и состояние слоя. Затем проверьте интерактив в предпросмотре.
  5. Сохраните и проверьте публикацию: баллы, завершение и возобновление нужно проверить в вашей LMS.

Для иллюстраций, аудио и видео можно указать локальный путь. MCP встраивает доступный файл, но сам по себе не создаёт изображения и не озвучивает текст: для генерации медиа у ИИ-клиента должны быть отдельные инструменты.

Если подключение не работает

В клиенте нет инструментов Verstt
Проверьте транспорт stdio, фактический путь, аргумент --mcp, синтаксис JSON/TOML и перезапуск клиента. Не указывайте verstt.com как адрес MCP. Посмотрите журнал запуска сервера в клиенте.
Сервер подключён, но @app недоступен
Запустите редактор, откройте курс и включите разрешение в настройках. Клиент и Verstt должны работать под одним пользователем в одной среде. Клиент в WSL, контейнере или на удалённой машине не следует считать подключённым к открытому окну на основной ОС.
Файл не найден или доступ запрещён
Используйте абсолютный путь и проверьте его в ОС. На Windows учитывайте экранирование JSON, на Linux — права выполнения AppImage, в MAS — ограничения песочницы. В интерфейсе клиента разрешайте только необходимые действия, а при запрете укажите доступную папку.
После обновления Linux сломалась команда запуска
Проверьте, не изменилось ли имя AppImage. Укажите постоянный путь к новому файлу и перечитайте конфигурацию клиента; временная папка .mount_… для постоянной настройки не подходит.
Сообщение о конфликте или занятости
Не запускайте повторяющиеся правки одновременно. Попросите агента заново прочитать курс: он мог измениться или вы могли переключить документ. Не заставляйте агента записывать устаревшую копию поверх текущей.
Курс изменён, но результат не тот
Отмените правку в открытом редакторе или восстановите свою копию файла. Для обращения в сообщество укажите ОС, версии приложения и клиента, режим работы и обезличенный текст ошибки.

Возможности и ограничения

Агент работает с данными курса и снимками, отрисованными плеером, а не видит окно редактора как человек. Снимок проверяет внешний вид, но не доказывает корректность всех кликов, доступность для каждого слушателя или отчётность LMS.

Инструмент quiz_set_answers предназначен для вопросов из встроенных шаблонов с одним или несколькими правильными ответами. Ранжирование, сопоставление, другие шаблоны и импортированные вопросы требуют работы с их объектами и проверки логики. Проверка структуры не оценивает достоверность учебного материала.

Соединение с MCP локальное, но обработка моделью зависит от ИИ-клиента: ему могут передаваться текст курса, медиа и снимки. Выбирайте материалы и настройки сервиса в соответствии со своими требованиями к данным. Подробнее о данных Verstt.

Официальная справка

Пути, режимы @app, резервные копии и примеры возможностей сверены с конфигурацией и встроенной справкой Verstt. Названия разделов сторонних клиентов могут меняться с обновлениями.