Как настроить MCP в Cursor: системные требования и версия
Для работы Model Context Protocol в Cursor требуется версия редактора от 0.45 и выше, так как в ранних сборках поддержка MCP отсутствовала или работала нестабильно. В качестве хоста для серверов используется Node.js версии 18 и выше или Python 3.10+, в зависимости от выбранного транспорта.
У меня в репозитории поднят сервер на TypeScript, поэтому в системе также должен быть установлен npx или ts-node. Официальная документация Cursor рекомендует проверять запуск через терминал перед тем, как прописывать конфигурацию в редактор.
- Cursor версий 0.45.x и выше
- Node.js 18+ или Python 3.10+
- Доступ к терминалу для проверки запуска команд
Где лежит файл конфигурации и как добавить сервер
Настройки MCP в Cursor хранятся в корневом конфигурационном файле редактора. Добраться до него можно через интерфейс: Settings -> Features -> Model Context Protocol, либо открыв файл mcp.json напрямую в системной директории.
Для macOS путь выглядит как ~/Library/Application Support/Cursor/user_settings/mcp.json, а для Windows — %APPDATA%\Cursor\user_settings\mcp.json. Если файла нет, его нужно создать вручную.
- Открыть настройки Cursor через интерфейс
- Найти раздел Model Context Protocol
- Добавить объект с описанием серверов в JSON-формате
Рабочий конфиг mcp.json для локального сервера
Ниже приведён валидный пример конфигурации для запуска локального сервера через npx. Такой формат используется, когда агент в Cursor обращается к локальной базе знаний или файловой системе репозитория.
Важно указывать абсолютные пути к интерпретаторам и файлам скриптов, если относительные пути вызывают ошибку таймаута при старте.
- Ключ mcpServers содержит словарь доступных серверов
- Поле command указывает на исполняемый файл node или npx
- Поле args передаёт аргументы запуска, включая путь к сборке
Как проверить handshake и статус подключения
После сохранения файла mcp.json в редакторе нужно перезагрузить окно Cursor или нажать кнопку обновления в панели MCP. Зелёный индикатор напротив имени сервера означает, что handshake прошёл успешно и транспорт установил соединение.
Если индикатор горит красным, агент не сможет вызывать инструменты сервера. В таком случае проверяем логи редактора через меню View -> Output, выбирая в выпадающем списке пункт MCP.
- Перезагрузить окно редактора командой Developer: Reload Window
- Проверить статус зелёного индикатора в настройках MCP
- Изучить вывод логов в панели Output при ошибке соединения
Как безопасно передать переменные окружения
Секреты и токены нельзя хардкодить прямо в mcp.json, особенно если репозиторий публичный или файл попадает в общую систему. Переменные окружения передаются через блок env внутри описания конкретного сервера.
Редактор подтягивает значения из системного окружения или локального файла .env, если это предусмотрено конфигурацией запуска процесса.
- Использовать блок env в объекте сервера
- Избегать добавления токенов в открытый код mcp.json
- Проверять доступность переменных внутри скрипта сервера через process.env
Безопасный откат конфигурации при сбое
Если обновление MCP-сервера или правка конфига привели к зависанию агента в Cursor, самым быстрым решением будет временное отключение проблемного модуля.
Для этого достаточно закомментировать или удалить проблемный блок в mcp.json и выполнить перезагрузку окна. Храните рабочую версию конфига в истории git, чтобы не восстанавливать параметры вручную.
- Удалить или закомментировать сломанный сервер в mcp.json
- Выполнить перезагрузку окна Cursor
- Проверить стабильность работы базовых моделей без сторонних инструментов
Источники
Model Context Protocol Documentation: https://modelcontextprotocol.io/Cursor Docs: Model Context Protocol: https://docs.cursor.com/context/model-context-protocol