Birta

Подключите Codex

Codex (командный инструмент OpenAI) работает с файлами на вашем компьютере и публикует сайт оттуда. Birta добавляется одной командой, ничего устанавливать заранее не нужно.

  1. 1. Добавьте Birta в Codex

    Выполните это в терминале:

    codex mcp add birta -- npx -y @birta/cli mcp

    Если ваша версия Codex не принимает команду в таком виде, добавьте сервер в файл настроек. Откройте ~/.codex/config.toml и добавьте:

    [mcp_servers.birta]
command = "npx"
args = ["-y", "@birta/cli", "mcp"]

    Нужен Node.js 20 или новее. npx -y @birta/cli mcp сам скачает пакет при первом запуске — устанавливать и обновлять вручную ничего не нужно.

  2. 2. Попросите что-нибудь сделать и подтвердите доступ

    Отдельного входа заранее нет. Попросите Codex сделать вам сайт или показать ваши проекты в Birta. Первый запрос вернёт не результат, а ссылку и короткий код: откройте ссылку, войдите по одноразовому коду из письма или через аккаунт Google и подтвердите доступ.

    Потом попросите Codex снова — отклонённый запрос выполнится, как только доступ подтверждён. Дальше эта установка остаётся авторизованной: ключи копировать и вставлять обратно не нужно.

    Хотите разобраться с доступом заранее? Эта команда покажет ту же ссылку и дождётся подтверждения:

    npx -y @birta/cli login

  3. 3. Как это работает

    Вам не нужно перечислять файлы для Codex. Он называет две папки на вашем компьютере — сам проект и, если сайт собирается, собранный сайт — и передаёт их как есть. Они уходят в черновик сайта: пока он работает, на адрес сайта ничего не попадает, там открывается последняя опубликованная версия, а до первой публикации — вообще ничего.

    Codex публикует черновик сам, как только считает работу законченной, — разрешения давать не нужно. В ответ приходят два адреса: адрес вашего сайта — то, что видят посетители, — и собственный адрес этой версии, где вы отмечаете правки прямо на странице.

    Скажите Codex, что поправить, или оставьте замечания на странице версии и сообщите об этом — он поправит файлы у вас на компьютере, снова передаст папки и опубликует следующую версию. Если проверка не прошла, не публикуется ничего: вам сразу называют всё, что мешает, а черновик остаётся прежним.

    Хотите посмотреть до публикации? Скажите об этом — попросите у Codex сначала черновик, он даст его собственный адрес и дождётся вашего слова. Адрес черновика не меняется от круга к кругу, поэтому вы просто обновляете уже открытую страницу.

  4. 4. Проверьте, что всё работает

    Попросите Codex показать список ваших проектов в Birta. Если он их видит — подключение готово, и можно просить его опубликовать или обновить сайт.