Что даёт MCP
MCP — протокол, через который ИИ-клиент получает инструменты Verstt. Вы описываете задачу обычным языком, а агент читает структуру курса, меняет объекты и проверяет результат. Например, может добавить вопрос, изменить триггер или показать снимок слайда.
Verstt предоставляет локальный stdio-сервер: ИИ-клиент запускает установленное приложение с аргументом --mcp. Для подключения нужны команда и аргументы, а не адрес сайта verstt.com. MCP-сервер, зависимости и среда запуска входят в приложение; устанавливать Node.js, скачивать исходники и поднимать сервер на VPS не требуется.
Нужен клиент, умеющий запускать локальные MCP-серверы: например, Claude Desktop, Claude Code или локальный клиент Codex. Клиент должен работать в той же среде и под той же учётной записью ОС, что и Verstt, чтобы обращаться к открытому курсу. У ИИ-сервиса собственные условия доступа и оплаты; поддержка MCP в приложении не включает подписку на модель.
1. Подготовьте Verstt
- Установите актуальную версию Verstt для своей ОС и запустите её.
- Для первого опыта откройте новый пустой курс или копию редактируемого примера.
- Откройте Файл → Настройки приложения….
- Скопируйте поле «Конфигурация MCP-клиента». В нём находятся команда запуска именно вашей установленной копии и её аргументы.
- Чтобы агент работал с открытым курсом, включите «Разрешить ИИ-агентам править открытый курс (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 нужно заменить.
{
"mcpServers": {
"verstt": {
"command": "/Applications/Verstt.app/Contents/MacOS/Verstt",
"args": [
"--mcp"
]
}
}
}{
"mcpServers": {
"verstt": {
"command": "C:\\Users\\YourName\\AppData\\Local\\Programs\\Verstt\\Verstt.exe",
"args": [
"--mcp"
]
}
}
}{
"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 оставьте после разделителя --.
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, добавьте локальный сервер командой ниже. Путь снова должен соответствовать вашей ОС и установке.
codex mcp add verstt -- "/Applications/Verstt.app/Contents/MacOS/Verstt" --mcp
codex mcp listАльтернатива — запись в конфигурации Codex ~/.codex/config.toml. Это TOML, поэтому JSON с ключом mcpServers сюда не вставляют. Не добавляйте второй блок verstt, если он уже существует.
[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.Как получать хороший результат
- Дайте контекст: для кого курс, чему он должен научить, сколько времени есть у слушателя и какие материалы являются источником фактов.
- Ограничьте правку: назовите слайды, желаемое действие и то, что нужно сохранить — ответы, баллы, триггеры, стиль.
- Работайте небольшими шагами: структура → 2–3 слайда → проверка → следующая часть. Так проще заметить неверное решение и отменить его.
- Просите показать результат: снимки помогают увидеть наложения, обрезанный текст и состояние слоя. Затем проверьте интерактив в предпросмотре.
- Сохраните и проверьте публикацию: баллы, завершение и возобновление нужно проверить в вашей 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.
Официальная справка
- Локальные серверы MCP и формат конфигурации
- Claude Desktop: локальные серверы и журналы
- Claude Code: команды MCP
- Codex: локальные stdio-серверы
Пути, режимы @app, резервные копии и примеры возможностей сверены с конфигурацией и встроенной справкой Verstt. Названия разделов сторонних клиентов могут меняться с обновлениями.