Как AI-агент работает с Layero

Layero рассчитан на то, что сайт публикует не человек за клавиатурой, а агент — Claude Code, Cursor, Codex или любой другой, умеющий запускать команды и подключать MCP. Всё, что агенту нужно знать, собрано в одном навыке: LayeroInfra/layero-agents, файл skills/layero/SKILL.md. Эта страница — его краткое изложение.

Три пути

У агента всегда одна из трёх ситуаций, и от неё зависит, что делать.

(a) Есть подключённый репозиторий

Проект привязан к репозиторию на GitHub, GitVerse, GitLab, GitFlic или SourceCraft. Тогда деплой — это git push:

• push в ветку → превью-окружение с собственным адресом;
• push в main (production-ветку) → продакшен.

Агент коммитит и пушит; ничего запускать не нужно. Репозиторий подключается в панели: «Создать проект» → «Импорт из репозитория». В CLI и MCP подключения репозитория пока нет. Подробнее — Подключение репозитория.

(b) Есть папка с кодом

Репозитория нет или подключать его не хочется. Тогда:

npx layero@latest deploy --json

CLI упакует папку, зальёт на платформу и соберёт на нашей стороне — Node и сборщик у агента не нужны. Первый запуск попросит открыть ссылку и подтвердить вход (device-flow); в CI вместо этого — переменная LAYERO_TOKEN. Готовая статика (папка с index.html) публикуется и без CLI — инструментом MCP publish_site.

Как CLI разговаривает с агентом — события, коды ошибок, что считать адресом сайта — на странице Деплой из AI-агентов.

(c) Есть сайт на Layero

Сайт уже опубликован, и задача — понять, что с ним. Это территория MCP: diagnose_deploy (или layero diagnose) для упавшей сборки, deploy_logs, rollback, домены (connect_domain, check_domain), переменные окружения (env_vars), аналитика (site_analytics), Data API (data_api_*). Полный список — Инструменты MCP.

Как выбрать путь

Вопрос	Да	Нет
У проекта есть подключённый репозиторий?	путь (a): git push	следующий вопрос
Есть папка с исходниками или готовой статикой?	путь (b): npx layero@latest deploy --json или publish_site	следующий вопрос
Сайт уже на Layero, нужно диагностировать или настроить?	путь (c): инструменты MCP	спросить человека, чего он хочет

Есть ли репозиторий, покажет site_status или my_projects: в ответе виден источник проекта.

Чего агент не делает никогда

• Не делает git init ради деплоя. Если репозитория нет — путь (b), а не создание репозитория «как у Vercel».
• Не ставит CLI глобально (npm i -g layero). В песочнице агента это часто падает; всегда npx layero@latest.
• Не собирает адрес сайта по шаблону. Адрес — только из события ready.url (CLI) или из ответа publish_site / site_status (MCP). Угаданный <slug>.layero.app может оказаться чужим или пустым.
• Не публикует без ведома человека то, что заменит живой сайт. Обычный deploy у CLI-проекта — не превью, он заменяет продакшен; инструменты MCP, которые меняют сайт, требуют подтверждения (см. Инструменты MCP).

Куда дальше

• Подключить агента — команды установки для каждого клиента, OAuth и LAYERO_TOKEN.
• Инструменты MCP — что умеет mcp.layero.ru.
• Навык layero — что внутри навыка и как он ставится.
• Деплой из AI-агентов — JSON-режим CLI.