Что такое MCP и зачем он нужен
MCP (Model Context Protocol) — стандарт, по которому ИИ-ассистент подключается к внешним инструментам. Подключили MCP-сервер базы данных — и агент Cursor может сам посмотреть схему таблиц. Подключили трекер задач — и агент прочитает описание задачи без копирования текста.
Серверы бывают локальными (запускаются командой на вашем компьютере) и удалёнными (подключаются по URL).
Где лежит конфигурация
- Для одного проекта — файл .cursor/mcp.json в корне проекта. Его можно положить в репозиторий, чтобы у команды были одинаковые подключения.
- Для всех проектов — файл ~/.cursor/mcp.json в домашней папке.
- Через интерфейс — страница Customize в боковой панели Cursor и маркетплейс, где официальные подключения ставятся в один клик.
Подключение локального сервера
Создайте файл
В корне проекта создайте папку .cursor и в ней файл mcp.json.
Опишите сервер
Внутри объекта mcpServers добавьте запись с именем сервера, полем command (например, npx или python), массивом args и, при необходимости, env с ключами.
Перезапустите
Откройте настройки MCP в Cursor и убедитесь, что сервер появился и горит зелёным.
Проверьте в агенте
Попросите агента выполнить действие через этот инструмент — он покажет вызов и попросит подтверждение.
Подключение удалённого сервера
Для сервера по сети вместо command указывается поле url с адресом, а ключи доступа передаются в headers. Многие сервисы дают готовый фрагмент конфигурации в своей документации — его достаточно вставить внутрь mcpServers.
Не храните ключи в mcp.json, который уходит в общий репозиторий. Выносите их в переменные окружения.
Если «подключить Cursor» значит другое
Часто под этим запросом имеют в виду Git. Cursor унаследовал встроенную работу с Git от VS Code: вкладка Source Control, вход в GitHub через аккаунт, клонирование по ссылке из палитры команд.
Подключить документацию библиотеки можно через @ в поле ввода: агент подтянет страницы по ссылке и будет опираться на них, а не на устаревшие знания модели.
Типичные ошибки
- Сервер красный — не установлен Node.js или Python, которые указаны в command.
- Агент не видит инструмент — слишком много серверов включено одновременно; отключите лишние.
- Ошибка авторизации — ключ передан не в том поле или истёк.
- Из России ничего не работает — с 4 сентября 2026 года вход в Cursor из РФ заблокирован, MCP тут не поможет.
Безопасность подключений
MCP-сервер получает те права, которые вы ему дали. Сервер базы данных с доступом на запись может удалить данные по ошибке агента. Для экспериментов подключайте копию базы или пользователя только на чтение.
Ставьте серверы из официальных источников и проверяйте, что именно запускается в command. Агент по умолчанию спрашивает подтверждение перед вызовом инструмента — не отключайте это для серверов с доступом к рабочим данным.
Какие серверы подключают чаще всего
- Базы данных — посмотреть схему и выполнить запрос прямо из чата.
- Трекеры задач — прочитать описание задачи и обновить статус.
- Браузер — открыть страницу и проверить вёрстку после правок.
- Документация — актуальные справочники по библиотекам вместо устаревших знаний модели.
Когда быстрее через ИИ-агента
Если нужно не настроить интеграцию, а один раз получить данные из API или собрать их в таблицу, это быстрее поручить ИИ-агенту LeanTech: он напишет код, запустит его в песочнице и отдаст таблицу и скрипт. Работает из России, оплата картой РФ.
Агент не настраивает Cursor и MCP на вашем компьютере и не имеет доступа к вашим внутренним системам без ваших данных.