Birta

Подключите Cursor

Cursor правит сайт на вашем компьютере и оттуда же публикует. Одна ссылка добавляет Birta в Cursor; ставить заранее ничего не нужно.

  1. 1. Добавьте Birta в Cursor одним нажатием

    Откройте эту ссылку и подтвердите установку, которую предложит Cursor. Запись birta он создаст сам — адрес вводить нигде не нужно.

    Нужен Node.js 20 или новее. Пакет скачивается при первом запуске — устанавливать и обновлять вручную ничего не нужно.

  2. 2. Ссылка не открыла Cursor? Добавьте вручную

    В Cursor откройте Settings → Cursor Settings → Tools & MCP и нажмите New MCP Server. Cursor откроет файл mcp.json — добавьте в него запись birta, чтобы получилось так, и сохраните:

    {
  "mcpServers": {
    "birta": {
      "command": "npx",
      "args": [
        "-y",
        "@birta/cli",
        "mcp"
      ]
    }
  }
}

    Предпочитаете править файл вручную? Он находится в ~/.cursor/mcp.json (доступен в каждом проекте) или в .cursor/mcp.json в папке отдельного проекта. Вставьте туда тот же JSON.

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

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

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

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

    npx -y @birta/cli login

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

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

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

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

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

  5. 5. Включите и проверьте

    Откройте Tools & MCP и убедитесь, что сервер birta включён (при необходимости включите переключатель). Затем попросите Cursor показать список ваших проектов в Birta — если он их видит, подключение готово.