Помощь · Агент (MCP)

Настройка MCP-сервера Mokbi.

Коротко. Добавь сервер в своего агента, один раз войди из терминала, а затем попроси /mokbi:screenshots. Агент снимет приложение на каждом языке на твоей машине и подготовит набор в твоём проекте Mokbi. Ты применишь его в редакторе одним кликом.

Что нужно

Node 20 или новее на машине, где работает агент. Проверь командой node --version.
Агент с поддержкой MCP. Claude Code, Cursor, Codex и Windsurf работают; подойдёт всё, что говорит на Model Context Protocol.
SDK Platform-Tools из Android Studio и эмулятор с Android 13 или новее (API 33+). Ниже этой версии языка для отдельного приложения не существует, и устройство пришлось бы перезапускать на каждый язык. Задай ANDROID_HOME, если инструменты не в PATH.
Аккаунт Mokbi с проектом, который нужно наполнить. Всё готовится внутри проекта, поэтому сначала создай его, если его ещё нет.
Съёмки на iOS пока нет. Для неё нужен macOS, и она появится отдельно; сегодня сторона съёмки — Android.

1. Проверь машину

Запусти npx -y @mokbi/mcp doctor. Он покажет версию Node, где ищет adb и эмулятор, и вошёл ли ты в аккаунт. Всё, что помечено ✗, чини в первую очередь — инструменты съёмки не обойдут отсутствующий SDK.

2. Добавь сервер в своего агента

В Claude Code хватит одной команды:

claude mcp add mokbi -- npx -y @mokbi/mcp

В Cursor, Codex, Windsurf и других хостах добавь в конфигурацию MCP сервер с командой npx и аргументами ["-y","@mokbi/mcp"]. После этого перезапусти хост, чтобы он подхватил сервер.

3. Войди один раз

Запусти npx -y @mokbi/mcp login. Браузер откроет Mokbi, ты подтвердишь запрос, и токен вернётся на 127.0.0.1 — он никогда не передаётся в URL. На экране подтверждения указан номер порта; перед подтверждением сверь его с тем, что вывел терминал.

На этой машине нет браузера? Запусти npx -y @mokbi/mcp login --paste и создай токен сам в Mokbi → меню → Агент (MCP) → «Доступ для агента» → «Новый токен». Токен показывается один раз, поэтому копируй его сразу.

Токен хранится в ~/.mokbi/config.json с правами 0600. Это не твоя сессия: отзыв токена не затрагивает аккаунт. Для CI переменная окружения MOKBI_TOKEN имеет приоритет над файлом.

4. Первый раунд

Попроси агента запустить сценарий со скриншотами. Сервер приносит три слэш-команды, и в Claude Code они появляются именно так:

/mokbi:screenshots — прочитать репозиторий, предложить, какие экраны снимать, пройти один язык для твоей проверки, а после твоего согласия — все языки и подготовить набор.
/mokbi:localize — написать тексты для магазинов в пределах лимитов символов каждого из них.
/mokbi:check — сообщить, что уже подготовлено и чего ещё не хватает по каждому языку и магазину.

Можно и просто описать, чего ты хочешь: сервер сам объясняет агенту, как должен идти сценарий. Пусть первый раунд охватит один язык. Тогда неверное касание стоит одного раунда, а не двадцати.

5. Примени то, что подготовил агент

Открой проект в редакторе. Доставка ждёт в разделе «От твоего агента» — кнопка с роботом на панели, та же панель, что меню → Агент (MCP) → «Доступ для агента», и кнопка «От твоего агента» в меню «Скриншоты». Счётчик на кнопке показывает, сколько ждёт.

«Применить» размещает скриншоты по плану, показанному над кнопкой: какой скриншот в какую панель и для какого языка. Одно Ctrl+Z убирает весь набор.
«Применить и оформить» появляется, когда агент прислал короткий бриф о приложении. Это запускает тот же раунд AI Designer, что и оранжевая кнопка в редакторе, по той же цене 2 кредитов, на подготовленных скриншотах.
«Принять всё» появляется, когда пачкой ждут тексты для магазинов или переводы подписей. Это применяет их за один шаг, а одна отмена убирает всё.
«Отклонить» удаляет доставку, которая тебе не нужна. Агент всегда может отправить снова.

Ничего не применяется автоматически, и это сделано намеренно. Редактор — единственный, кто пишет твой проект: открытая вкладка сохраняет весь документ целиком. Если бы доставка попадала прямо в дизайн, вкладка редактора, открытая где-то ещё, могла бы молча её перезаписать.

Если что-то пошло не так

«adb not found». SDK Platform-Tools не установлены или их нет в PATH. Установи их через SDK Manager в Android Studio или задай ANDROID_HOME на папку SDK.
Эмулятор 'offline' сразу после запуска. Свежий эмулятор продолжает загружаться и после того, как сообщил о готовности. Сервер ждёт три сигнала загрузки и повторяет попытку; дай ему минуту, прежде чем прерывать.
«Язык не переключился». После установки мы считываем то, что сообщает устройство. Если не совпало, скорее всего приложение не содержит этот язык или уже было запущено на другом. Повтори раунд для этого языка.
Два языка выглядят одинаково. Это проверка делает свою работу: экраны одинаковые, значит приложение на этот язык не переведено. Выпускай язык тогда, когда приложение к нему готово.
Вход через браузер не завершается. Используй npx -y @mokbi/mcp login --paste и вставь токен, созданный в редакторе.
В редакторе ничего не ждёт. Проверь, что открыт тот же проект, куда отправлял агент, и что токен ещё действителен: npx -y @mokbi/mcp doctor.
Раунд встаёт на экране, до которого приложение никогда не доходит. Драйвер съёмки сообщает, на какой экран он смотрел, вместе с картинкой. Верни это агенту и поправь сценарий; сервер не тестирует приложение за тебя.

Что токен может, а что нет

Он готовит, но не публикует. Публикация в App Store и Google Play остаётся в Mokbi, по твоему клику.
Он не может тратить деньги. Раунд оформления оплачивается из твоей же сессии редактора в момент нажатия кнопки, никогда — агентом.
Это не твоя сессия. Отзови его в меню → Агент (MCP) → «Доступ для агента», и аккаунт останется нетронутым. У каждого токена видно, когда его использовали в последний раз.
Код остаётся у тебя. Половина, отвечающая за съёмку, полностью работает на твоей машине; в проект уходят только готовые изображения и тексты.

Открыть редактор → Что делает MCP-сервер