Устранение неполадок MCP в Cursor: изменения не применяются после редактирования конфигурации

Отредактировали конфигурацию MCP в Cursor, но изменения не вступают в силу? Это специфичное для Cursor руководство по устранению неполадок поможет вам исправить проблемы, когда обновления конфигурации не применяются. Узнайте о требованиях к перезапуску/перезагрузке, путанице с расположением файла конфигурации и о том, как проверить список активных серверов.

Почему изменения конфигурации не применяются

Cursor читает файл конфигурации MCP только при запуске. Простого сохранения файла недостаточно — необходимо перезапустить или перезагрузить приложение:

Распространённые причины

Cursor не перезапущен после изменений конфигурации
Не выполнена перезагрузка окна (перезагрузка может быть обязательной)
Редактирование неверного файла конфигурации (путаница с расположением)
Файл конфигурации сохранён некорректно
Синтаксические ошибки JSON, препятствующие загрузке конфигурации
Cursor кэширует старую конфигурацию

Шаг 1: проверьте расположение файла конфигурации

Сначала убедитесь, что вы редактируете правильный файл:

Правильный путь к файлу конфигурации

Расположение конфигурации MCP в Cursor

~/.cursor/mcp.json

Полные пути:

macOS/Linux: /Users/yourusername/.cursor/mcp.json
Windows: C:\Users\yourusername\.cursor\mcp.json

Распространённые ошибки в расположении

Неверно: конфигурация рабочего пространства

Редактирование .cursor/mcp.json в рабочем пространстве проекта

Решение: используйте конфигурацию в домашнем каталоге: ~/.cursor/mcp.json

Неверно: другое имя файла

Редактирование mcp_config.json или cursor-mcp.json

Решение: файл должен называться именно mcp.json

Неверно: неправильный каталог

Редактирование файла в ~/.config/cursor/ или другом расположении

Решение: файл должен находиться в каталоге ~/.cursor/ (с точкой)

Как проверить расположение файла

Убедитесь, что вы редактируете правильный файл:

Откройте терминал/командную строку
Перейдите в домашний каталог: cd ~
Проверьте, существует ли файл: ls -la .cursor/mcp.json (macOS/Linux) или dir .cursor\mcp.json (Windows)
Откройте именно этот файл в редакторе

Шаг 2: перезапуск против перезагрузки

Для применения изменений конфигурации Cursor требует либо полного перезапуска, либо перезагрузки окна:

Вариант 1: полный перезапуск (рекомендуется)

Шаги полного перезапуска

Сохраните файл mcp.json
Полностью закройте Cursor (Cmd+Q в macOS, Alt+F4 в Windows или File → Quit)
Подождите 2–3 секунды, пока процесс полностью завершится
Снова откройте Cursor
Дождитесь полной инициализации Cursor
Проверьте, появляется ли MCP-сервер

Вариант 2: перезагрузка окна

Перезагрузка не всегда срабатывает

Иногда перезагрузки окна достаточно, но не всегда:

Сохраните файл mcp.json
Откройте палитру команд: Cmd+Shift+P (macOS) или Ctrl+Shift+P (Windows/Linux)
Введите «Reload Window» и выберите этот пункт
Дождитесь перезагрузки окна
Если MCP-сервер по-прежнему не появляется, попробуйте полный перезапуск

Не просто закрытие окна

Простое закрытие окна Cursor может не полностью завершить приложение. Проверьте:

macOS: проверьте наличие иконки Cursor в доке (правый клик → Quit, если приложение всё ещё запущено)
Windows: проверьте процесс Cursor в системном трее
Linux: проверьте, запущен ли процесс Cursor: ps aux | grep cursor

Шаг 3: проверьте список активных серверов

После перезапуска убедитесь, что Cursor загрузил ваши MCP-серверы:

Проверьте статус MCP-сервера

Способы убедиться, что MCP-серверы загружены:

Найдите индикатор MCP-сервера в интерфейсе Cursor
Проверьте список MCP-серверов в настройках Cursor
Попробуйте спросить «Какие MCP-инструменты доступны?»
Найдите инструменты Workify в списке доступных инструментов

Проверочный запрос

Проверочный запрос

"What MCP servers are configured? List available MCP tools."

Если Workify MCP работает, вы должны увидеть инструменты, такие как list_tasks, get_task, create_task и т. д.

Шаг 4: проверьте наличие ошибок JSON

Невалидный JSON помешает Cursor загрузить конфигурацию:

Проверьте синтаксис JSON

Ошибки JSON препятствуют загрузке

Если в вашей конфигурации есть синтаксические ошибки JSON, Cursor молча не загрузит её:

Замыкающие запятые
Отсутствующие кавычки
Несопоставленные скобки
Комментарии (JSON не поддерживает комментарии)

См. Ошибки JSON в конфигурации для подробных исправлений.

Проверьте вашу конфигурацию

Проверьте валидность JSON:

Скопируйте всё содержимое файла mcp.json
Вставьте в JSONLint или аналогичный валидатор
Исправьте все указанные ошибки
Сохраните исправленный файл
Перезапустите Cursor

Шаг 5: очистите кэш Cursor

Иногда Cursor кэширует старую конфигурацию. Очистите кэш, чтобы принудительно выполнить свежую загрузку:

Расположение кэша

macOS

rm -rf ~/Library/Caches/com.todesktop.230313mzl4w4u92
# Затем перезапустите Cursor

Windows

Remove: %APPDATA%\Cursor\Cache
# Затем перезапустите Cursor

Linux

rm -rf ~/.cache/cursor
# Затем перезапустите Cursor

Предупреждение об очистке кэша

Очистка кэша удалит другие настройки Cursor. Делайте это, только если другие шаги не помогли.

Шаг 6: убедитесь, что файл конфигурации был сохранён

Убедитесь, что ваши изменения действительно записаны на диск:

Проверка сохранения

Проверьте, что файл сохранён:

Закройте файл в редакторе
Снова откройте ~/.cursor/mcp.json
Убедитесь, что ваши изменения на месте
Проверьте отметку времени изменения файла (должна быть недавней)

Распространённые проблемы с сохранением

Файл не сохранён

Симптом: изменения исчезают при повторном открытии файла
Решение: убедитесь, что вы сохранили файл (Cmd+S / Ctrl+S) перед закрытием

Сохранён неверный файл

Симптом: сохранён другой файл или копия рабочего пространства
Решение: убедитесь, что вы редактируете ~/.cursor/mcp.json (домашний каталог, а не рабочее пространство)

Чек-лист быстрого решения

Системное устранение неполадок

✅ Проверено расположение файла конфигурации: ~/.cursor/mcp.json (домашний каталог)
✅ Проверен синтаксис JSON (нет ошибок в валидаторе)
✅ Файл сохранён, и изменения сохранились
✅ Cursor полностью закрыт (не просто закрыто окно)
✅ Подождали несколько секунд после закрытия
✅ Cursor полностью перезапущен
✅ Дождались полной инициализации Cursor
✅ Убедились, что MCP-сервер появляется в Cursor
✅ Проверено запросом «Какие MCP-инструменты доступны?»

Всё ещё не работает?

Если изменения конфигурации по-прежнему не применяются после всех шагов:

Проверьте логи Cursor на наличие сообщений об ошибках (Help → Toggle Developer Tools → Console)
Попробуйте создать минимальную конфигурацию только с Workify для теста
Убедитесь, что версия Cursor актуальна (в старых версиях могут быть проблемы с MCP)
См. Инструменты не отображаются для дополнительного устранения неполадок
Ознакомьтесь с Ошибкой подключения для проблем с сетью

Связанные руководства

Ошибки JSON в конфигурации — исправление синтаксиса JSON, препятствующего загрузке конфигурации
Инструменты не отображаются — исправление проблем, когда инструменты не появляются
Настройка Cursor — обзор руководства по настройке MCP в Cursor
Указатель по устранению неполадок — просмотр всех руководств по устранению неполадок