Cursor Cloud Agent setup: как пользоваться

Cursor Cloud Agent setup — это настройка development environment для агентов в cloud: клон репо, зависимости, secrets, startup-команды и сеть. Без среды агент пишет код, но не закрывает цикл «собрал → проверил → отдал PR». Канон: Cloud agent setup.

Обзор — Cloud Agents; уже разобраны Environment, Builds, Secrets, Snapshots. Capabilities (computer use/MCP) — соседний лонгрид. Pillar: n8n / автоматизация.

Два пути setup

Путь	Когда брать	Что фиксируете
Agent-driven (рекомендуется)	Нужна рабочая среда < 10 минут	Агент ставит deps, проверяет, создаёт Build; потом commit в .cursor/environment.json
Dockerfile + environment.json	Свой base OS, compilers, debuggers	Dockerfile без COPY всего проекта; install в JSON; layer cache

Сверка: cursor.com/docs/cloud-agent/setup (проверка 2026-09-21). Cursor-configured Dockerfiles — private beta для Enterprise.

Порядок разрешения environment

1. .cursor/environment.json в репозитории (или repo group)
2. Personal saved environment
3. Team saved environment

Первый match побеждает. Personal override удобен, чтобы прогнать новую конфигурацию до выката на всю команду.

Multi-repo

Выберите несколько репозиториев при создании environment. Cursor клонирует каждый и переиспользует среду для будущих runs/automations с той же группой. Агент может править frontend+backend+infra и открывать PR в затронутых репо. Long-running для multi-repo в overview пока ограничен — сверяйте актуальный статус в docs.

install vs start vs terminals

• install (раньше update script) — при создании Build: deps, codegen, компиляция, прогрев диска. Должен быть idempotent.
• start — после boot агента: например sudo service docker start.
• terminals — app-процессы в shared tmux (вы + агент).

Build сохраняет только disk state. Живые процессы, export shell vars и in-memory cache в агент не переезжают. Failed Build не затирает active: агенты стартуют с последнего успешного.

{
  "build": {
    "dockerfile": "Dockerfile",
    "context": ".."
  },
  "install": "pnpm install && ./custom_script.sh"
}

В Dockerfile не копируйте весь проект: Cursor сам checkout нужный commit. Computer use для Dockerfile-репо заявлен на Debian/Ubuntu-based образах.

Start from scratch

Можно стартовать без source control: Start from scratch в picker на cursor.com/agents. Cursor создаёт draft Origin-репозиторий. Нужны paid plan и Origin; если Origin выключен админом — агент стартует без репо. Потом: Create repo → опционально Publish через Vercel (нужен Vercel account; на team — план выше Hobby).

Preview: Forwarded Ports в Agents Window (Detected / Auto-Forward / Open in internal browser + Design Mode).

Secrets и AWS IAM

Рекомендуемый путь — Secrets tab в dashboard (не только .env в snapshot). Environment-scoped secrets — только для агентов этой среды. Для 2FA TOTP docs приводит пример oathtool --totp -b "$TOTP_SECRET".

AWS: секрет CURSOR_AWS_ASSUME_IAM_ROLE_ARN + trust policy с External ID команды; runtime выставляет AWS_PROFILE=cursor-cloud-agent. Для короткоживущих JWT без long-lived keys — OIDC tokens.

AGENTS.md для cloud

Добавьте секцию вроде «Cursor Cloud specific instructions»: что поднимать, как тестить, куда не лезть. Длинные куски лучше вынести ссылками на отдельные файлы.

Маршрут на один вечер

1. Cloud Agents dashboard → agent-driven setup на одном репо.
2. Положите secrets (API keys/DB) в Secrets tab.
3. Дождитесь successful Build; зафиксируйте .cursor/environment.json в git.
4. Перенесите тяжёлое в install, живые сервисы — в start/terminals.
5. Прогоните тестовый агент: тест → artifact → PR.

Типичные ошибки

• Класть Docker/БД в install и ждать, что процесс «переживёт» Build.
• Неидемпотентный install (второй Build ломает диск).
• COPY всего проекта в Dockerfile.
• Держать секреты только в snapshot .env вместо Secrets tab.
• Паниковать из-за failed Build: active не заменяется.

FAQ: Cursor Cloud Agent setup

Вывод

Setup — главный рычаг качества Cloud Agents: среда = автономность. Agent-driven для старта, Dockerfile для жёсткого base image, install для диска, start/terminals для процессов. Соседи: Builds, Secrets, Snapshots, Capabilities, Security.