Никита Орлов

СтатьяГайд

Как настроить MCP в Cursor: конфигурация сервера и проверка handshake

Автор отметил, что материал написан или существенно правлен с помощью ИИ (gemini-2.5-flash).

Как настроить MCP в Cursor: системные требования и версия

Для работы Model Context Protocol в Cursor требуется версия редактора от 0.45 и выше, так как в ранних сборках поддержка MCP отсутствовала или работала нестабильно. В качестве хоста для серверов используется Node.js версии 18 и выше или Python 3.10+, в зависимости от выбранного транспорта.

У меня в репозитории поднят сервер на TypeScript, поэтому в системе также должен быть установлен npx или ts-node. Официальная документация Cursor рекомендует проверять запуск через терминал перед тем, как прописывать конфигурацию в редактор.

  1. Cursor версий 0.45.x и выше
  2. Node.js 18+ или Python 3.10+
  3. Доступ к терминалу для проверки запуска команд

Где лежит файл конфигурации и как добавить сервер

Настройки 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. Если файла нет, его нужно создать вручную.

  1. Открыть настройки Cursor через интерфейс
  2. Найти раздел Model Context Protocol
  3. Добавить объект с описанием серверов в JSON-формате

Рабочий конфиг mcp.json для локального сервера

Ниже приведён валидный пример конфигурации для запуска локального сервера через npx. Такой формат используется, когда агент в Cursor обращается к локальной базе знаний или файловой системе репозитория.

Важно указывать абсолютные пути к интерпретаторам и файлам скриптов, если относительные пути вызывают ошибку таймаута при старте.

  1. Ключ mcpServers содержит словарь доступных серверов
  2. Поле command указывает на исполняемый файл node или npx
  3. Поле args передаёт аргументы запуска, включая путь к сборке

Как проверить handshake и статус подключения

После сохранения файла mcp.json в редакторе нужно перезагрузить окно Cursor или нажать кнопку обновления в панели MCP. Зелёный индикатор напротив имени сервера означает, что handshake прошёл успешно и транспорт установил соединение.

Если индикатор горит красным, агент не сможет вызывать инструменты сервера. В таком случае проверяем логи редактора через меню View -> Output, выбирая в выпадающем списке пункт MCP.

  1. Перезагрузить окно редактора командой Developer: Reload Window
  2. Проверить статус зелёного индикатора в настройках MCP
  3. Изучить вывод логов в панели Output при ошибке соединения

Как безопасно передать переменные окружения

Секреты и токены нельзя хардкодить прямо в mcp.json, особенно если репозиторий публичный или файл попадает в общую систему. Переменные окружения передаются через блок env внутри описания конкретного сервера.

Редактор подтягивает значения из системного окружения или локального файла .env, если это предусмотрено конфигурацией запуска процесса.

  1. Использовать блок env в объекте сервера
  2. Избегать добавления токенов в открытый код mcp.json
  3. Проверять доступность переменных внутри скрипта сервера через process.env

Безопасный откат конфигурации при сбое

Если обновление MCP-сервера или правка конфига привели к зависанию агента в Cursor, самым быстрым решением будет временное отключение проблемного модуля.

Для этого достаточно закомментировать или удалить проблемный блок в mcp.json и выполнить перезагрузку окна. Храните рабочую версию конфига в истории git, чтобы не восстанавливать параметры вручную.

  1. Удалить или закомментировать сломанный сервер в mcp.json
  2. Выполнить перезагрузку окна Cursor
  3. Проверить стабильность работы базовых моделей без сторонних инструментов

Источники

Model Context Protocol Documentation: https://modelcontextprotocol.io/Cursor Docs: Model Context Protocol: https://docs.cursor.com/context/model-context-protocol

Источник: https://modelcontextprotocol.io/

0
0

Комментарии (0)

Войдите, чтобы комментировать.

Без Plus — 5 комментариев в месяц. Мало слов — чистый воздух. Войти

Комментариев пока нет — будьте первым.

Ещё в теме «Код и разработка»

Похожие материалы и соседние разборы

Никита Орлов

Как не упереться в лимит запросов в Claude Code и что делать Короче, если вы уже крутите Claude Code в терминале, то наверняка видели эту злую ошибку про rate limit. Сидишь такой, дебажишь сложный баг, агент бодро пишет код, рефакторит тесты — и тут бац: «Rate limit reached». Всё, приплыли, кукушка говорит «ждите час» или сколько там до сброса. У меня такое происходит регулярно, если дать агенту волю. Раньше я просто пускал его в проект и говорил: «Почини всё». Это главная ошибка. Claude начинает читать вообще всю репу, тащит в контекст гигабайты логов и node_modules, если они не заигнорены, и сжирает месячный лимит токенов за полчаса активной работы. Давайте разберем, как я теперь экономлю запросы и выживаю без нервных срывов. Почему улетает claude code rate limit и как с этим жить Основная проблема — контекст. Агенты устроены так, что с

Как не упереться в лимит запросов в Claude Code и что делатьПоказать полностью
0
1
Никита Орлов

Какие фреймворки для разработки AI-агентов использовать в 2024 году Привет! У меня тут на днях агент в очередной раз улетел в бесконечный цикл, сжег кучу токенов на OpenAI и затер локальную базу тестов. Классика для ночной смены. Если вы тоже устали от красивых демок на Streamlit, которые сыпятся на первом же нестандартном ответе модели, давайте смотреть на фреймворки для AI агентов с точки зрения инженера. Мне важен не столько красивый синтаксис графов, сколько стабильность под нагрузкой, нормальный async, человеческий логгинг и понимание, куда делся стейт, когда упал воркер. Короче, собрал пятерку инструментов, которые я сам крутил в продакшене, и готов выдать честное сравнение. LangGraph: когда нужен жесткий контроль стейта LangGraph от создателей LangChain — это первое, куда я смотрю, когда логика агента перестает помещаться в один

Фреймворки для AI агентов в продакшене: топ 5 инструментовПоказать полностью
0
1
Никита Орлов

Почему Claude Code падает с ошибкой rate limit в терминале У меня вчера на середине рефакторинга отвалилась утилита. Сижу, правлю большой модуль, жду фидбек от агента, а в терминале прилетает классика: anthropic api rate limit. Процесс обрывается, контекст теряется, настроение так себе. Сама по себе тулза удобная — гоняешь её прямо из репы, она сама шарится по файлам, запускает тесты. Но у неё есть особенность: если репозиторий огромный или в промпт улетает слишком много лишнего кода, лимиты токенов вылетают мгновенно. Anthropic бьет по рукам за превышение RPM и RPD (requests per minute / day), особенно если тариф базовый. Как понять, что это именно claude code rate limit error Ошибки бывают разные. Иногда тулза просто зависает на этапе генерации дифа, иногда выкидывает JSON с кодом 429. Если вы видите в логах упоминание «Too Many Requests»

Claude Code падает с ошибкой rate limit: как чинить в репеПоказать полностью
0
1
Никита Орлов

Зачем вообще запускать локальные модели для кода У меня в репе лежат приватные ключи, проприетарные алгоритмы и куча legacy, которую стыдно показывать даже коллегам, не то что облачным провайдерам. Вчера очередной агент попытался слить кусок контекста наружу, и я психанул. Решил, что хватит кормить чужие датасеты своими энтерпрайз-костылями. Поставил Ollama, выделил под это дело локальную тачку с нормальной видюхой и начал тестировать лучшие модели для кода локально. Главный критерий простой: чтобы она не тупила на автодополнении в Cursor или VS Code и выдавала рабочий синтаксис с первой попытки, а не генерировала синтаксический мусор. Ниже — мой личный топ-5 локальных нейросетей для программирования, которые я потрогал руками, покрутил в разных сценариях и отобрал для повседневной разработки. 1. DeepSeek-Coder-V2: тяжёлая артиллерия для

Какие локальные LLM для написания кода запустить: топ-5 моделейПоказать полностью
0
0
Никита Орлов

Какие формулировки чаще всего ломают ответ модели по коду? Всем привет. У меня в репе опять веселье: вчера агент погнал какую-то дичь и затёр рабочий тест, потому что я поленился нормально описать задачу. И сразу в чате спросили про топ 5 ошибок при промптах для кода. Короче, давайте без воды и копирайтерского бреда разберем, от каких фраз модели начинают генерировать нерабочий мусор. Когда мы пишем задачу ассистенту на бегу, в стиле «почини там всё, чтобы работало», мы получаем ровно то же самое на выходе. Модель не умещает в голове контекст всего проекта, если мы ей его не скормили. Ниже собрал пять главных грабель, на которые наступал сам и вижу у других в коммитах. Первая ошибка: «сделай красиво и по стандарту» Первый пункт в нашем топе 5 ошибок при промптах для кода — это абстрактные требования вроде «перепиши красиво», «оптимизируй» или

Топ 5 ошибок при промптах для кода: почему модель ломает репуПоказать полностью
0
1
Никита Орлов

Зачем перебирать библиотеки для логирования python Привет! У меня в репе опять разрослось приложение, и стандартный print или basicConfig уже не вывозят. Когда на проде случается деплой с багом, читать консоль через docker logs на виртуалке — это путь к нервному срыву. Я задолбался искать, куда складывать логи python приложения, чтобы они не терялись при рестарте контейнера. Поэтому перетряхнул то, чем сам пользуюсь или тестировал в боевых условиях. Никакого энтерпрайза с ценником в крыло самолета, только то, что можно поднять за вечер. 1. Loguru: кому да, кому нет Начну с базы. Loguru — это любовь с первой строчки в мануале. Заменяет стандартный logging одной строчкой from loguru import logger и избавляет от боли с настройкой форматтеров и хендлеров. У меня она стоит на всех пет-проектах и в паре микросервисов. Красивый вывод в консоль из

Инструменты для мониторинга логов python топ 5: мой личный выборПоказать полностью
0
1