Как опубликовать сайт через OpenAI Codex (без GitHub)

Соберите сайт, добавьте Birta в Codex CLI, авторизуйте удалённое MCP-подключение и попросите Codex опубликовать готовые файлы. Вы получите стабильный публичный URL без пуша репозитория в GitHub и без загрузки ZIP-архива в чужую панель.

1. Step 1СборкаСоздайте index.html
2. Step 2ПодключениеВойдите в MCP Birta
3. Step 3ПубликацияОпубликуйте и проверьте URL

Что делает Codex — и что всё ещё должен сделать хостинг

OpenAI Codex — это ИИ-кодинг-агент. Он умеет анализировать кодовую базу, редактировать файлы, выполнять команды, проверять сборку и работать с репозиторием GitHub. OpenAI предоставляет Codex в ChatGPT, десктопном приложении, расширении для IDE и в терминале. Эти интерфейсы помогают в разработке, но не делают каждый сгенерированный сайт или приложение совместимым с одним и тем же процессом хостинга.

Лендинг, портфолио, сайт документации или клиентский прототип обычно хорошо подходят для статического хостинга. Веб-приложению со своей аутентификацией, базой данных, серверными API-маршрутами, фоновыми задачами или приватными API-ключами нужен хостинг приложений. Если граница неясна, перед публикацией сверьтесь с тестом «статический сайт против приложения».

Попросите Codex классифицировать текущее рабочее пространство до внесения изменений:

Проанализируй этот проект, ничего в нём не меняя. Определи, может ли он работать полностью как статический сайт после production-сборки. Проверь фреймворк, скрипты пакета, серверные маршруты, аутентификацию, код работы с базой данных, фоновые задачи, приватные переменные окружения и локальные бинарные ассеты. Заверши ответ либо фразой «Готов к статической публикации через Birta», либо конкретным списком блокеров.

Шаг 1. Соберите сайт Codex

Birta размещает production-вывод, а не сервер разработки. Запустите сборку и посмотрите, в какой каталог она пишет результат — dist, build, out, как принято во фреймворке. В корне этого каталога должна быть стартовая страница index.html, а рядом — все подключаемые файлы CSS и JavaScript. Относительные пути к ассетам должны продолжать работать с публичного URL. Имя каталога для Birta ничего не значит: пути публикуемых файлов считаются от корня сайта.

Команду сборки не нужно угадывать. Попросите Codex изучить текущий фреймворк и скрипты, сохранить существующую архитектуру и запустить настоящую production-сборку:

Подготовь эту кодовую базу к статической публикации через Birta. Перед изменениями изучи скрипты пакета и конфигурацию фреймворка. Запусти правильную production-сборку, скажи, в какой каталог она пишет результат, и убедись, что в корне этого каталога есть index.html. Проверь внутренние ссылки и пути к ассетам с точки зрения публичного URL. Пока не публикуй. Сообщи, какую команду ты запустил, что лежит в каталоге сборки и все блокеры.

Рабочего превью на localhost недостаточно. Production-вывод должен существовать и не должен зависеть от локального процесса после завершения сборки.

Шаг 2. Подключите Birta к Codex CLI

Добавьте Birta как MCP-сервер по протоколу Streamable HTTP. Это даёт ИИ-агенту узкий набор инструментов для работы с проектами, публикацией, версиями и откатом:

codex mcp add birta --url https://birta.manaraga.ai/mcp

Затем запустите авторизацию через браузер:

codex mcp login birta

Войдите с помощью одноразового кода, отправленного на вашу почту, и разрешите доступ. Codex хранит OAuth-авторизацию отдельно — в репозиторий не нужно вставлять никакой API-ключ. Проверьте интеграцию командой codex mcp list или откройте Codex и выполните /mcp. Должен появиться сервер birta.

Если команда в вашей установленной версии не принимает URL, настройте тот же сервер в ~/.codex/config.toml:

[mcp_servers.birta]
url = "https://birta.manaraga.ai/mcp"

Официальная документация OpenAI по Codex MCP описывает удалённые серверы, OAuth, config.toml и общую конфигурацию, которую используют CLI, десктопное приложение и расширение для IDE. Краткий справочник по командам — руководство Birta по подключению Codex.

Шаг 3. Опубликуйте сайт Codex на публичный URL

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

Через подключённые инструменты Birta выведи список моих проектов. Если местом назначения может быть больше одного проекта, попроси меня выбрать. Убедись, что в корне каталога сборки есть index.html и что все отправляемые файлы — текстовые. Опубликуй все собранные текстовые файлы в выбранный проект с описанием «Первая публикация сайта Codex», считая пути от корня сайта: index.html в корне, вложенные файлы по тем же относительным путям, что и в каталоге сборки, без его имени в начале. Верни публичный URL, номер версии, preview-URL и все предупреждения ровно так, как их сообщает Birta.

Birta проверяет пакет перед изменением публичного сайта. Отсутствующая точка входа или некорректная нагрузка отклоняются, а текущая версия остаётся рабочей. Успешная публикация возвращает URL, превью и записанную версию.

Проверяйте рабочий сайт, а не только локальное превью

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

1. Сделайте жёсткое обновление главной страницы на десктопе и мобильном.
2. Откройте каждый маршрут и нажмите на навигацию, кнопки и формы.
3. Проверьте CSS, JavaScript, изображения и шрифты на ответы 404.
4. Изучите консоль браузера и панель сети на ошибки.
5. Поищите в собранных файлах секреты и приватные API-ключи.
6. Убедитесь, что публичный URL относится к нужному проекту Birta.

Если локальный бинарный ассет отсутствует, дайте ему публичный источник или используйте другой поддерживаемый способ загрузки. Повторная текстовая публикация не перенесёт бинарный файл.

Birta, Sites в Codex или full-stack-платформа?

В поисковой выдаче сценарии публикации выглядят похоже, но требуют разной инфраструктуры. Используйте этот сценарий Birta, когда у Codex уже есть готовая статическая директория и вам нужен прямой, версионируемый путь к сайту, которым можно поделиться. Он обходится без подключения репозитория, панели настроек сборки и передачи ZIP.

Если ваш аккаунт OpenAI или рабочее пространство компании уже предоставляют Sites в Codex либо плагин Vercel или Netlify, это может быть кратчайшим путём к рабочему превью. Используйте хостинг приложений, когда проект — это сервис на Node.js или ему нужны аутентификация, база данных, серверные API, постоянные данные или секретные переменные окружения. Не пытайтесь втиснуть full-stack-приложение в статический хостинг ради упрощения экрана публикации.

Итерации в Codex, затем обновление или откат

Продолжайте работать в той же кодовой базе или worktree. После каждого заметного изменения просмотрите diff, пересоберите сайт и опубликуйте собранные файлы в тот же проект с понятным описанием. Так каждая итерация превращается в понятную версию, а не в безымянную перезапись.

Просмотри текущие изменения, пересобери статический сайт и проверь, что в корне каталога сборки есть index.html. Проверь собранный вывод на неожиданные файлы и приватные значения. Опубликуй собранные файлы, считая пути от корня сайта, в тот же проект Birta с описанием «Обновление: [кратко опиши заметное изменение]». Верни публичный URL, новый номер версии, preview-URL и предупреждения. Затем выведи список последних версий и определи, какая из них рабочая.

Если новая версия оказалась неправильной, сначала попросите Codex вывести список доступных версий. Выберите заведомо рабочую версию и откатитесь. Более поздняя версия останется в истории, а локальный репозиторий не изменится.

Выведи список версий моего проекта Birta и отметь рабочую. Ничего не меняй, пока не покажешь мне варианты. После того как я выберу версию, откатись на неё и верни номер восстановленной версии и публичный URL.

Частые проблемы при публикации из Codex

Birta отсутствует в /mcp

Выполните codex mcp list. Добавляйте сервер заново только если его нет. Если он есть, но авторизация не прошла, выполните codex mcp login birta и завершите процесс в браузере.

В публикации нет главной страницы

В корне опубликованного сайта нет index.html. Проверьте директорию вывода фреймворка, пересоберите проект из корня и опубликуйте его файлы с путями от этого каталога — без его имени в начале.

Сборка ожидает сервер

После сборки всё ещё нужны маршрут, API, база данных или переменная окружения времени выполнения. Выберите хостинг приложений — удаление сообщения об ошибке не делает архитектуру статической.

Пропали изображения или шрифты

Сначала проверьте пути в URL и регистр имён файлов. Если это локальные бинарные файлы PNG, JPEG, WebP, PDF, WOFF или WOFF2, они не могут пройти через текущий инструмент публикации MCP, работающий только с текстом.

Codex выбрал не тот проект

Остановитесь до публикации. Попросите Codex вывести проекты с их именами и адресами, а затем укажите точное место назначения в промпте. Никогда не выводите цель из похожего имени проекта.

Часто задаваемые вопросы