Cursor MCP — это подключение MCP-серверов к редактору Cursor, после которого агент внутри среды разработки получает доступ к репозиторию и внешним инструментам: поиск по коду, чтение задач из трекера, работа с базой знаний команды. Если задачам агента хватает кода в открытом проекте, MCP подключать незачем: встроенных возможностей редактора достаточно. Смысл возникает там, где агенту нужны системы за пределами редактора.
Агент в среде
Серверы описываются в файле .cursor/mcp.json: в корне проекта или в домашней папке пользователя. Cursor показывает агенту инструменты подключённых серверов и по умолчанию просит подтверждение перед каждым запуском.
Cursor строился вокруг ИИ-помощника: агент читает открытые файлы, предлагает правки и исполняет команды. MCP расширяет эту картину вовне: агент начинает видеть задачи из трекера, документы базы знаний, статусы CI. Без MCP модель оперирует тем, что лежит в проекте, с MCP — ещё и тем, что лежит в процессах вокруг проекта. Ограничения самого редактора для российской команды разобраны в материале про Cursor в России.
Как это выглядит технически. Сервер на своей машине запускается через stdio, и Cursor управляет им сам; удалённый сервер подключается по SSE или Streamable HTTP, и один такой сервер обслуживает всю команду. Ключи в конфигурации подставляйте из переменных окружения записью вида ${env:ИМЯ}, чтобы секреты оставались вне файла в репозитории. Включать и выключать сервер можно в боковой панели настроек, оставляя запись в конфигурации, а журнал работы серверов открывается в панели Output в разделе MCP Logs. Для удалённых серверов Cursor поддерживает OAuth со статическими учётными данными.
Минимальный набор
Соблазн подключить всё сразу понятен, но каждый лишний инструмент — это контекст, который модель учитывает при выборе действия, и риск ошибочного вызова. Минимальный рабочий набор для агента в репозитории собирается из четырёх функций, остальное добавляйте по мере вопросов, на которые агент отвечает «данных в контексте нет».
- Поиск по коду и чтение файлов — база для любой задачи агента в репозитории.
- Список открытых задач трекера с возможностью прочитать карточку целиком.
- Создание ветки и коммита — запись результата работы, доступная с первого дня.
- Запуск проверок: линтер и тесты как инструмент, агент обязан гонять их до сдачи.
Слияние, деплой и правка защищённых веток на старте у агента отсутствуют. Порядок «читать сразу, писать в отдельных ветках, остальное после пилота» повторяет логику выдачи прав новому сотруднику и избавляет от неприятных сюрпризов в первые недели.
Ориентир зрелости набора: агент закрывает рутинную задачу от чтения карточки до зелёных проверок без вмешательства, а журнал вызовов показывает, что в выборе модели участвовало мало лишних инструментов. Когда набор справляется с одним типом задач, расширяйте его на следующий сценарий, например на разбор регрессий по падению тестов.
Права доступа
Права в MCP-контуре решаются на двух уровнях: токен сервиса и состав инструментов сервера. Токен выдаётся с минимальными разрешениями: у многих систем чтение и запись разводятся по отдельным ключам, берите читающий. Состав инструментов определяет сам сервер, поэтому выбирайте серверы с узким набором или включайте только нужные группы, если сервер так умеет. Описание инструментов разобрано в гайде по инструментам MCP-сервера.
В Cursor подтверждение вызова инструмента включено по умолчанию. Режим, где разрешённые инструменты запускаются сразу, ускоряет работу, но список «что можно без вопросов» утверждает владелец контура: чтение и поиск — да, запись в репозиторий — после проверки. Общий для команды набор серверов держите в .cursor/mcp.json проекта, личные инструменты разработчика — в файле домашней папки, так границы видны по расположению конфигурации.
| Действие агента | Уровень права | Кто подтверждает |
|---|---|---|
| Читать код и задачи | Токен чтения | Автоматический режим |
| Создавать ветки и коммиты | Токен записи в ветки | Автоматический режим |
| Открывать merge request | Токен записи плюс шаблон | Тимлид смотрит diff |
| Менять код в main | Право отсутствует | Только через ревью человека |
Проверка изменений
Даже при аккуратных правах итоговую правку проверяет человек, и здесь агенту задаётся жёсткий ритуал сдачи. Diff — главный артефакт контроля: модель обязана показать, что поменяла, прогнать проверки и перечислить отклонения от задачи. Ревьюер смотрит три вещи: соответствие задаче, затронутые файлы вне области задачи и обработку ошибок. Стилистика и naming — зона автоматических проверок, внимание человека дороже и расходуется на смысл.
Полезная привычка ревьюеров: спорную правку возвращают автору с вопросом, а чужой код без согласования переписывает только его автор. Агент учится на разобранных замечаниях быстрее, когда видит формулировку «почему отклонено», и доля возвратов по мелочи со временем может снижаться. В журнале вызовов видно, на каком шаге цепочки агент чаще всего спотыкается, и это подсказка, куда добавить описание инструмента или пример.
- Агент завершает задачу и формирует summary: что сделано, какие файлы тронуты, что проверено.
- Локально запускаются тесты и линтер; при падении агент чинит до зелёного статуса.
- Diff показывается ревьюеру вместе со ссылкой на задачу, человек оставляет правки или принимает.
- Принятые изменения уходят в merge request, история вызовов инструментов остаётся в журнале.
Принятые изменения оставляют след в двух местах: в истории merge request и в журнале вызовов. Сверка этих двух источников раз в неделю показывает, делает ли агент больше, чем просили. Журнал серверов в панели Output пригодится и ревьюеру: по нему видно, какие инструменты агент вызывал для этой правки.
Что подключить в Cursor под ваш репозиторий?
Частые ошибки
Первая ошибка — выдать агенту токен с полными правами «на потом разберёмся». Такие конфигурации обычно разбирают после инцидента: случайный пуш в защищённую ветку или правка чужого модуля «по аналогии». Вторая ошибка — игнорировать журнал вызовов: без него поведение модели превращается в чёрный ящик, и любой сбой списывается на «нейросеть опять поглючила». Регламент работы агента в репозитории с правами и журналом раскрыт в статье про агентов для разработки, а выбор между редакторами — в сравнении Cursor и Claude Code. Состав работ по такому контуру описан на странице про ИИ-агентов для бизнес-процессов.
Контур держится на разделении обязанностей: агент рассуждает, MCP-слой доставляет вызов, внешние системы исполняют. Пока границы чёткие, замена трекера или добавление сервиса происходит в конфигурации, а промпт агента остаётся прежним. Дополнительная страховка — отключение лишних серверов: пока для сервера нет задач, его можно выключить в настройках, оставив запись в конфигурации.
Возьмите одну рутинную задачу, например разбор мелких правок из списка технического долга. Агенту достаются чтение и свои ветки, main закрыт, diff-ритуал обязателен. Права расширяйте после того, как несколько задач подряд приняты без возвратов.