Cursor: контекст и инструменты

Качество ответа агента почти всегда упирается не в модель, а в то, что ты ей дал: правильные файлы, правильные правила и нормальные доказательства из терминала.

Я долго делал одну и ту же ошибку: писал в чат «почини», а потом удивлялся, что агент чинит не то. В Cursor это решается довольно прямолинейно: ты либо прикрепляешь контекст явно через @, либо ты даёшь постоянные инструкции через правила и AGENTS.md, либо оба сразу.

Проверено: 2026-08. Desktop 3.17.19.

Контекст

Как скормить агенту файл и папку

Суть: в Agent-чате набираешь @, выбираешь ровно то, что нужно, и отправляешь запрос уже с прикреплёнными «пилюлями» контекста.

В официальной справке Cursor список контекста для @ сейчас такой: файлы и папки, терминал, прошлые чаты, git-дифы (рабочее состояние и diff ветки с main), встроенный браузер. Это не теория, это прямо то, что Cursor сам умеет прикрепить без копипасты. Источник: Cursor Help: @ mentions and context.

Файлы и папки работают одинаково просто: @src/components/Button.tsx или @src/components/. Для папки есть маленькая фича: после выбора папки можно нажать / и провалиться глубже по дереву. Это удобно, когда ты хочешь дать ровно один модуль, а не весь репозиторий.

Один практический приём: если задача точно про один участок, я почти всегда даю агенту «один файл + одна папка рядом». Не «весь apps/», не «весь src/», а ровно то, где он будет править. Это экономит контекстное окно и снижает шанс, что агент начнёт «ремонтировать» не ту часть проекта.

Про шорткаты. В доке есть подсказка, что @ само по себе считается «контекстным шорткатом» для меню упоминаний. Источник: Cursor Docs: Keyboard Shortcuts.

Правила, скиллы и AGENTS.md: куда это кладётся в Cursor

Это три разных слоя, и они решают разные проблемы.

AGENTS.md я держу в корне проекта. Cursor подхватывает его автоматически и воспринимает как «проектные инструкции» в обычном Markdown. Источник: Cursor Help: Rules.

Если тебе нужно, чтобы эта часть была переносимой между агентами и инструментами, смотри переносимый слой в серии Harness.

Project rules живут в .cursor/rules/ и обычно имеют расширение .mdc. Это уже «правила Cursor», с типами применения (всегда, умно, по файлам, вручную через @). Создать их можно прямо из командной палитры через «New Cursor Rule». Источник тот же: Rules.

User rules это настройки «для всех проектов». Их можно задать в Customize в сайдбаре. В доке отдельно упоминаются и файловые пользовательские правила в ~/.cursor/rules (они не синкаются), и «аккаунтные» правила, которые синкаются. Источник: Rules.

Скиллы (Agent Skills) это отдельная история: это не правило «как себя вести», а «как выполнять повторяемый сценарий». В этой установке Cursor автоматически находит скиллы в нескольких директориях этого репозитория: .agents/skills/, .cursor/skills/, плюс, в моём сетапе, совместимые каталоги вроде .claude/skills/. В других проектах поведение может отличаться. Вызов в чате через /, а если хочешь держать скилл активным как режим, в доке есть вариант с Option+Enter (Mac) или Alt+Enter (Windows). Источник: Cursor Docs: Agent Skills.

Про клавиши панели. В IDE Cmd+I (Windows: Ctrl + I) и Cmd+L оба тогглят боковую панель. Если комбинация «ничего не делает», сначала проверь окно: Agents Window это не VS Code с чатом справа. Источник: Keyboard Shortcuts плюс живая проверка 2026-08.

Типичные промахи контекста

Здесь почти всегда виновата не «глупая модель», а мы сами.

Прикрепил слишком много. Агент читает, но хуже понимает. Лучше один модуль по делу, чем десять папок «на всякий случай».
Забыл доказательство. Просишь «починить тест», но не даёшь вывод из терминала. В итоге агент чинит «на глаз».
Смешал две задачи. «Почини ошибку и заодно улучши архитектуру» часто превращается в ремонт без финала.
Не сказал, что считается готовым. Мне помогает одна фраза: «готово, когда …», и дальше коротко про ожидаемое поведение или команду, которая должна пройти.
Правила живут где попало. Если инструкции важны, им место в AGENTS.md и .cursor/rules/, а не в каком-то случайном заметочнике.

Инструменты

MCP: подключить сервер в настройках

Суть: MCP (Model Context Protocol) это способ подключить к Cursor внешние инструменты и данные так, чтобы агент мог их вызывать во время работы. Здесь я говорю только про подключение, без «как написать сервер».

Официально описаны два пути. Первый: открыть Customize в сайдбаре, зайти в MCPs и поставить интеграцию в один клик. Второй: положить конфиг mcp.json либо в проект (.cursor/mcp.json), либо глобально в домашнюю директорию (~/.cursor/mcp.json). Источник: Cursor Help: MCP integrations.

Про команду и секреты. В документации есть примеры с env и заголовками. Я бы делал так: конфиг можно коммитить, но секреты в git не тащить. Пусть у команды останется шаблон, а ключи живут отдельно.

Ещё одна полезная штука из доки: агент по умолчанию просит подтверждение на вызов MCP-инструментов, а поведение можно настроить в Agent Settings (Auto-review, allowlist). Источник: MCP integrations.

Терминал агента

В Cursor агент умеет запускать команды в терминале и читать вывод, это часть встроенных инструментов. Источник: Cursor Docs: Agent overview.

Что я делаю на практике: если задача про баг, я стараюсь не пересказывать ошибку словами. Я либо даю агенту вывод через @Terminals, либо прямо прошу «запусти команду X и покажи, где падает». Это банально, но работает лучше любых «похоже, оно где-то не так».

В той же доке есть мелочь про настройку профиля: Cursor берёт первый доступный terminal profile, а если хочешь иначе, есть команда «Terminal: Select Default Profile» через командную палитру. Источник: Agent overview.

Браузер

Browser в Cursor это встроенный веб-вью, которым агент может управлять: навигация, клики, ввод текста, скролл, скриншоты, чтение консоли и сетевых запросов (часть функций может быть доступна только в Agent panel). Источник: Cursor Docs: Browser.

Главное ограничение, которое стоит помнить: по умолчанию действия в браузере требуют подтверждения. Это нормально, так безопаснее, особенно если агент может нажать «Submit» там, где ты не хотел.

Чекпоинты и просмотр правок

Чекпоинты в Agent это локальные снимки состояния файлов, которые создаются перед «крупными» правками. Если агент свернул не туда, можно открыть чекпоинт в таймлайне чата, посмотреть правки и восстановиться. Источник: Cursor Docs: Agent overview.

Важно: чекпоинты не заменяют git. Я использую их как страховку от неправильного шага агента, а git как нормальный контроль версий.

Главный вывод

Для меня Cursor начал «попадать» в задачи тогда, когда я перестал кормить его общими фразами и начал кормить доказательствами: нужным файлом, нужным правилом, нужным выводом из терминала.

Если коротко: @ решает проблему «дай ровно то, что нужно сейчас», правила и AGENTS.md решают проблему «не повторяй одно и то же каждый раз», а MCP и браузер добавляют агенту руки там, где репозиторий заканчивается.