
РазборЕвгений10 мин чтения
Cursor AI: как подключить к проекту, правила, MCP и приватность
Как подключить Cursor к своему репозиторию: импорт VS Code, Ask и Agent, правила .cursor/rules и AGENTS.md, MCP, Privacy Mode и .cursorignore.
Содержание · 10 разделов
Cursor это редактор кода с ИИ. Он построен на кодовой базе VS Code, поэтому выглядит привычно, но это отдельное приложение со своим агентом. Агент читает проект, правит файлы и запускает команды в терминале. Ниже разбираю, как подключить Cursor к уже существующему репозиторию: установка, перенос настроек из VS Code, правила для агента, MCP и приватность. Всё собрано по документации Cursor на 30 октября 2026 года. Сам я этот маршрут для статьи не прогонял, примеры запросов и файлов здесь шаблонные.
Раньше Cursor индексировал проект в облаке, Cmd+K открывал отдельное окно inline edit, а для документации была команда @Docs. Сейчас порядок работы другой, и дальше я отмечаю, где именно.
Установка и вход
Скачивайте Cursor только с официальной страницы загрузки. Приложение есть для macOS, Windows и Linux. Дальше по Quickstart всё просто: открыть приложение и войти в аккаунт.
Если вы переходите с VS Code, откройте настройки Cursor и в блоке VS Code Import нажмите Import. Cursor перенесёт расширения, темы, настройки и сочетания клавиш.
После импорта проверьте расширения, которыми реально пользуетесь. Cursor берёт их из реестра Open VSX, а не из VS Code Marketplace, и в документации прямо сказано: не все расширения VS Code там есть и не все работают одинаково.
Как открыть существующий проект
Для знакомства с проектом откройте его папку: File → Open Folder. Так агент сможет найти README, скрипты и тесты. Для локальной задачи потом передавайте только нужные файлы.
Перед первым запросом сделайте три вещи:
- Закоммитьте или отложите текущие изменения, проверьте
git statusи создайте отдельную ветку. После работы агента смотрите diff и список новых файлов. Коммит поможет восстановить отслеживаемые файлы, новые файлы проверяйте отдельно. Изменения во внешних системах и другие последствия команд Git не отменяет. - Включите Privacy Mode, если код не ваш или закрытый (подробности ниже).
- Добавьте
.cursorignoreс файлами, которые агенту читать незачем.
Поиск по проекту: без отдельной облачной индексации
Старые инструкции советуют дождаться, пока Cursor проиндексирует проект и загрузит его в облако. Сейчас документация по поиску описывает Instant Grep: поиск работает сам, настраивать ничего не надо, индекс строится и хранится на вашем компьютере. Цитата: «Cursor does not upload file paths or code to build a search index, and it does not store embeddings of your codebase for search».
Отсюда легко сделать неверный вывод, будто код никуда не уходит. Там же следующей строкой сказано, что, когда агент открывает найденный файл, его содержимое может попасть в запрос к модели. Поиск локальный, а модель работает на серверах.
Про файл .cursorindexingignore: в текущей справке по ignore-файлам его нет. Поддерживается ли он в вашей версии, я подтвердить не смог, поэтому полагаться на него не советую.
Ask, Agent и что стало с Cmd+K
В Cursor несколько режимов, и для чужого проекта важен порядок.
| Режим | Что делает | Когда брать |
|---|---|---|
| Ask | Отвечает на вопросы и ищет по коду, файлы не меняет | Первое знакомство с репозиторием |
| Agent | Ищет, читает, правит файлы, запускает команды | Конкретная ограниченная задача |
| Plan | Позволяет согласовать план до изменений, правит после одобрения | Сложная задача, где сначала нужно проверить подход |
Отдельно от режимов работают ещё две вещи. Tab это автодополнение по последним правкам и окружающему коду: Tab принимает подсказку, Esc отклоняет. Cloud Agents запускают агента на отдельной виртуальной машине в облаке. По справке там разворачивается среда разработки: репозиторий, зависимости, секреты, которые вы ей передали, и доступ в сеть. Такой агент может писать тесты, чинить баги и сам открывать pull request.
Agent открывается в боковой панели, на Mac сочетанием Cmd+I. Cmd+K (Ctrl+K) раньше открывал окно inline edit. Теперь, по документации, выделенный код по этому сочетанию уходит в Agent, отдельного окна больше нет.
Первый запрос: разведка без правок
Начните с Ask. Пример запроса:
Объясни устройство этого репозитория без изменения файлов.
Найди точки входа, основные модули, команды запуска и тестов.
Для каждого вывода укажи файл-основание. Если команды не описаны — так и скажи.
Не запускай команды и ничего не устанавливай.
Ссылки на файлы упрощают проверку: каждый вывод можно сверить с кодом. Как ловить выдумки модели, рассказано в статье про галлюцинации нейросети.
Первая правка: одна задача и проверка diff
Потом дайте Agent одну небольшую задачу с явными границами:
Контекст: @README.md и существующие скрипты запуска проекта.
Задача: уточни раздел README «Локальный запуск» по реально найденным командам.
Ограничения: меняй только README.md; не устанавливай зависимости,
не трогай секреты и конфиги; неизвестные шаги не выдумывай.
Готово: покажи diff, назови источники команд и что ещё нужно проверить человеку.
Quickstart сам советует то же самое: посмотреть diff и попросить Cursor запустить проверки, которые в проекте уже есть. Тесты, линтер, сборку запускайте и после правки агента. Если тестов нет, проверяете руками.
Как дать агенту нужный контекст
Наберите @ в чате и выберите конкретный файл или папку: @auth.ts, @src/components/. Если вы не знаете, где лежит нужный код, агент найдёт его поиском сам.
Окно контекста у модели ограничено. Когда оно подходит к пределу, Cursor сжимает старую часть переписки в резюме, поэтому важные ограничения лучше повторять, когда переходите к новой задаче. Подробнее в статье про контекстное окно.
Команды @Docs больше нет. Сотрудник Cursor на официальном форуме написал, что её убрали и возвращать пока не планируют. Вместо неё кладите нужную документацию в проект markdown-файлом и упоминайте через @, давайте ссылку или прописывайте постоянные указания в правилах.
Правила для агента: .cursor/rules и AGENTS.md
Правила это постоянные инструкции, которые Cursor подкладывает модели в запросы. В документации описаны в том числе такие варианты:
- Project Rules: файлы
.mdcв папке.cursor/rules, лежат в Git вместе с проектом. Формат MDC: markdown с шапкой, где задаютсяdescription,globsиalwaysApply. Обычный.mdв этой папке система правил игнорирует. - AGENTS.md: простой markdown в корне проекта. Можно класть такие файлы и в подпапки: инструкции складываются с родительскими, и более конкретные важнее.
- User Rules: ваши личные настройки для всех проектов, задаются в Customize → Rules.
Пример правила .cursor/rules/safe-changes.mdc:
---
description: Небольшие изменения существующего проекта
alwaysApply: true
---
Сначала прочитай README и существующие тесты.
Делай один логический набор изменений за задачу.
Не выдумывай команды и результаты проверок.
Перед удалением данных, установкой зависимостей и внешними действиями спроси.
В конце покажи diff, реальные проверки и оставшиеся ограничения.
Для старта хватит того же текста в AGENTS.md, только без шапки.
У правил есть граница: это текст для модели, а не песочница. В документации так и написано: «Rules provide persistent, reusable context at the prompt level». Модель может правило нарушить. Если доступ к чему-то нужно закрыть по-настоящему, это делают права в системе и настройки инструментов.
MCP: как подключить внешние инструменты
Через MCP Cursor подключается к внешним инструментам и данным: базе, трекеру задач, своему скрипту. Что такое MCP-сервер и зачем он нужен, рассказано в отдельной статье: MCP-сервер.
По документации Cursor конфигурация лежит в одном из двух мест:
.cursor/mcp.jsonв проекте: инструменты только для этого проекта;~/.cursor/mcp.jsonв домашней папке: инструменты для всех проектов.
Формат такой:
{
"mcpServers": {
"local-server": {
"command": "python",
"args": ["/path/to/project/tools/mcp_server.py"],
"env": {
"MCP_TOKEN": "${env:MCP_TOKEN}"
}
}
}
}
Это схема формата, а не готовый сервер: путь замените на свой и сверьтесь с документацией сервера. ${env:MCP_TOKEN} Cursor возьмёт из переменной окружения. Так значение ключа не нужно записывать в mcp.json. Отдельно проверьте, что файлы с секретами и логи не отслеживаются Git. Для удалённого сервера вместо command и args указывают url, а токен передают в headers, тоже через ${env:…}.
По умолчанию Cursor запрашивает разрешение на использование MCP-инструментов. Новичку лучше это не отключать, пока не разобрались, что именно сервер умеет и к чему у него доступ.
Приватность: Privacy Mode и .cursorignore
Чтобы отвечать, Cursor отправляет промпты и куски кода провайдерам моделей: OpenAI, Anthropic, Google. Это сказано в справке о приватности. Privacy Mode эту передачу выбранного контекста не отменяет и офлайн-режима не даёт.
Privacy Mode включается в настройках Cursor. С ним ваш код не используют для обучения ни в Cursor, ни у провайдеров моделей. Без Privacy Mode Cursor по своей политике использования данных может хранить и использовать код, промпты и действия в редакторе для обучения. Даже с Privacy Mode данные могут сохранить для расследования злоупотреблений, а если вы подключили свой API-ключ, действуют уже правила провайдера этого ключа.
.cursorignore кладут в корень проекта, синтаксис как у .gitignore:
.env*
**/credentials.json
**/secrets.json
**/*.pem
**/*.key
node_modules/
dist/
Файлы из списка закрыты для Agent. Но в справке есть важная оговорка: команды терминала и MCP-инструменты работают вне этих ограничений и прочитать игнорируемый файл могут. Агент, которому разрешено запускать команды, способен выполнить cat .env. Сам Cursor пишет, что полной защиты из-за непредсказуемости LLM не гарантирует.
Отсюда два правила. Закрытый рабочий код подключайте только с разрешения владельца и после того, как прочитали политику данных. Секреты не коммитьте, но учтите, что файл вне репозитория агент тоже может прочитать через терминал или MCP, если у процесса есть доступ. Давайте инструментам минимальные права и отдельно проверьте, к чему у них есть доступ.
Тарифы и лимиты
По документации Cursor на 30 октября 2026 года Cursor продаётся в составе The X Subscription: одна подписка на Grok, Cursor и X. Планы там называются Free, Plus, Premium, Super и Ultra, плюс места для команд. Платные планы включают недельный объём использования моделей Cursor, общий для редактора, CLI, Cloud Agents и приложений Grok. Сторонние модели в этот объём не входят. Старые планы Cursor (Hobby, Pro, Pro+, Ultra и другие) продолжают работать по прежним правилам, с двумя месячными пулами.
Цены я не привожу: они меняются, смотрите страницу тарифов. В справке о лимитах сказано, что от выбора модели зависит, как быстро вы израсходуете включённый объём. Остаток и дату обновления на новой подписке показывает раздел Usage в кабинете Grok, тот же остаток виден в настройках редактора.
Cursor, Codex и Claude Code
| Cursor | OpenAI Codex | Claude Code | |
|---|---|---|---|
| Что это | Отдельный редактор на базе VS Code с агентом, который ищет, читает и правит код, запускает команды | Агент: CLI на компьютере, расширение для IDE и облачная версия Codex Web | Агент: читает код, правит файлы, запускает команды; работает в терминале, IDE, десктопе и браузере |
| Связь с Cursor | — | Расширение Codex ставится в том числе в Cursor | Отдельный инструмент |
Модель Claude, выбранная в Cursor, и Claude Code это разные вещи: в первом случае работает агент Cursor, во втором агент Anthropic со своими инструментами. Выбирать что-то одно не обязательно. Расширение Codex по его README ставится в VS Code, Cursor и Windsurf, так что их можно держать в одном редакторе. Сравнительных замеров скорости и качества здесь нет, поэтому «кто лучше» я не пишу. Подробнее про Codex в статье OpenAI Codex, про установку на Windows в статье Codex на Windows.
Перед первой задачей агенту
- Права: какие команды агенту можно запускать и есть ли у него доступ к секретам через терминал или MCP.
- Контекст: нужные файлы указаны через
@, лишнее закрыто в.cursorignore. - Границы: одна задача, список файлов, которые можно менять, и чего делать нельзя.
- Проверка: diff, новые файлы, тесты и линтер проекта.
Частые вопросы
Cursor это нейросеть или редактор? Редактор кода на базе VS Code. Нейросети он подключает от разных провайдеров, модель выбирается в настройках.
Как перенести настройки из VS Code? В настройках Cursor, блок VS Code Import, кнопка Import. Перенесутся расширения, темы, настройки и сочетания клавиш. Расширения проверьте: Cursor берёт их из Open VSX.
Нужно ли ждать индексации проекта? Отдельного шага облачной индексации больше нет. По текущей документации поиск по проекту локальный (Instant Grep) и запускается автоматически.
Что выбрать для правил: .cursor/rules или AGENTS.md? Для простых инструкций хватит AGENTS.md. .cursor/rules с .mdc удобен, когда нужны отдельные правила с условиями применения, в том числе для определённых файлов.
Читайте также
- OpenAI Codex: что это, как устроен доступ и как начать
- Codex на Windows: установка, вход и песочница. Как я запустил его на своём ПК
- MCP-сервер: что это и как подключить к Claude Code, Codex и Cursor
- Контекстное окно нейросети: что это, какой размер у Claude и GPT и почему длинный чат дорогой
- Галлюцинации нейросети: что это и как я ловлю их у своих ИИ-агентов
Источники
- Cursor Downloads
- Cursor Quickstart
- Cursor Docs: Search (Instant Grep)
- Cursor Docs: Inline edit
- Cursor Forum: Where did the docs go
- Cursor Docs: Rules
- Cursor Docs: MCP
- Cursor Help: Privacy
- Cursor Data Use
- Cursor Help: Ignore files
- Cursor Pricing
- Cursor Docs: Models & Pricing
- OpenAI Codex README
- Cursor Docs: VS Code migration
- Cursor Help: Migrate from VS Code
- Cursor Help: Ask mode
- Cursor Docs: Prompting
- Cursor Help: Usage limits
- Claude Code overview
- Cursor Help: Cloud Agents