Пути к конфигурации MCP в macOS: где найти и как отредактировать нужный файл

Нужно найти или отредактировать конфигурацию MCP в macOS? Это руководство специально для macOS показывает, где именно каждый MCP-клиент хранит свои файлы конфигурации, как безопасно открывать и редактировать их с помощью Finder или Terminal и как избежать распространённых проблем с путями в macOS.

Как устроены пути к конфигурации в macOS

В macOS MCP-клиенты хранят файлы конфигурации в разных местах. Одни используют вашу домашнюю папку со скрытыми папками (начинающимися с точки), другие — папки Application Support. Это руководство охватывает все распространённые расположения.

Соглашения о путях в macOS

• ~ = /Users/YourUsername (домашняя папка)
• ~/Library/Application Support/ = папка данных, специфичная для приложения
• Скрытые папки начинаются с точки (например, .cursor)
• В путях используются прямые слэши (/)
• Finder по умолчанию скрывает папку Library

Расположение конфигураций MCP-клиентов в macOS

Claude Desktop

Путь к файлу конфигурации:

~/Library/Application Support/Claude/claude_desktop_config.json

Полный пример:

/Users/YourUsername/Library/Application Support/Claude/claude_desktop_config.json

Как открыть

Способ 1: Finder «Переход к папке»

1. Откройте Finder
2. Нажмите Cmd+Shift+G («Переход к папке»)
3. Вставьте: ~/Library/Application Support/Claude
4. Нажмите Enter
5. Откройте claude_desktop_config.json в текстовом редакторе

Способ 2: Terminal

cd ~/Library/Application\ Support/Claude
open -a "Visual Studio Code" claude_desktop_config.json

Или используйте nano, vim либо ваш предпочитаемый редактор

Cursor

Путь к файлу конфигурации:

~/.cursor/mcp.json

Полный пример:

/Users/YourUsername/.cursor/mcp.json

Скрытая папка

Папка .cursor по умолчанию скрыта. Чтобы её увидеть:

1. Откройте Finder
2. Нажмите Cmd+Shift+. (точка), чтобы показать скрытые файлы
3. Перейдите в вашу домашнюю папку
4. Откройте папку .cursor

Как открыть

Способ 1: Terminal (самый простой)

cd ~/.cursor
open -a "Visual Studio Code" mcp.json

Способ 2: Finder

1. Нажмите Cmd+Shift+., чтобы показать скрытые файлы
2. Нажмите Cmd+Shift+G («Переход к папке»)
3. Введите: ~ и нажмите Enter
4. Откройте папку .cursor
5. Откройте mcp.json

Windsurf

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

Windsurf может использовать один из двух вариантов:

• Интерфейс настроек (настраивается через интерфейс Windsurf)
• Файл конфигурации: ~/Library/Application Support/Windsurf/mcp.json (если используется конфигурация на основе файла)

Сначала проверьте интерфейс настроек

1. Откройте Windsurf
2. Перейдите в Settings → MCP Servers
3. Проверьте, настроен ли там Workify MCP
4. Если нет, добавьте его через интерфейс (предпочтительный способ)

Continue

Путь к файлу конфигурации:

~/Library/Application Support/Continue/config.json

Полный пример:

/Users/YourUsername/Library/Application Support/Continue/config.json

Шаг 1: показать скрытые файлы в Finder

Многие файлы конфигурации находятся в скрытых папках. Сначала включите отображение скрытых файлов:

Показ скрытых файлов в Finder

1. Откройте Finder
2. Нажмите Cmd+Shift+. (клавиша точки)
3. Скрытые файлы и папки теперь будут видны (серым цветом)
4. Нажмите снова, чтобы скрыть их

Шаг 2: доступ к папке Library

Папка Library по умолчанию скрыта. Вот как получить к ней доступ:

Способ 1: «Переход к папке» (рекомендуется)

1. Откройте Finder
2. Нажмите Cmd+Shift+G («Переход к папке»)
3. Введите: ~/Library
4. Нажмите Enter
5. Перейдите в Application Support → папку вашего приложения

Способ 2: Terminal

cd ~/Library/Application\ Support/Claude
open .

Это откроет папку в Finder

Способ 3: сделать Library всегда видимой

1. Откройте Finder
2. Перейдите в вашу домашнюю папку
3. Нажмите Cmd+J («Параметры вида»)
4. Установите флажок «Показывать папку Библиотеки»
5. Library теперь всегда будет видна

Шаг 3: перейдите к файлу конфигурации

Используйте один из этих способов, чтобы быстро перейти к файлам конфигурации:

Способ 1: Terminal (самый быстрый)

Для скрытых папок (например, .cursor):

cd ~/.cursor
open -a "Visual Studio Code" mcp.json

Для папок Application Support:

cd ~/Library/Application\ Support/Claude
open -a "Visual Studio Code" claude_desktop_config.json

Способ 2: Finder «Переход к папке»

1. Откройте Finder
2. Нажмите Cmd+Shift+G
3. Введите путь (например, ~/.cursor или ~/Library/Application Support/Claude)
4. Нажмите Enter
5. Откройте файл конфигурации

Шаг 4: безопасно отредактируйте файл конфигурации

Перед редактированием примите следующие меры предосторожности:

Контрольный список безопасности

• ✅ Закройте MCP-клиент перед редактированием (Cursor, Claude Desktop и т. д.)
• ✅ Сделайте резервную копию файла конфигурации
• ✅ Используйте редактор с поддержкой JSON (VS Code, TextEdit, BBEdit)
• ✅ Проверьте синтаксис JSON перед сохранением
• ✅ Сохраните файл перед закрытием

Рекомендуемые редакторы

• VS Code: лучший выбор, встроенная проверка JSON
• TextEdit: встроенный, работает, но включите режим «Обычный текст»
• BBEdit: отличная альтернатива с подсветкой синтаксиса
• nano/vim: редакторы в Terminal, удобны для быстрых правок

Создайте резервную копию

Быстрые шаги резервного копирования:

1. В Finder щёлкните правой кнопкой по файлу конфигурации
2. Выберите «Дублировать»
3. Переименуйте копию в config.json.backup

Или в Terminal:

cp mcp.json mcp.json.backup

Шаг 5: проверьте синтаксис JSON

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

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

• Завершающие запятые (не допускаются в JSON)
• Отсутствующие кавычки вокруг ключей
• Неправильная вложенность или скобки
• Неэкранированные специальные символы

Проверьте перед сохранением

Способы проверки

• VS Code: показывает ошибки JSON красными волнистыми линиями
• Онлайн: скопируйте/вставьте в JSONLint
• Terminal: python3 -m json.tool config.json (проверяет синтаксис)

Шаг 6: типичные проблемы, характерные для macOS

Проблема 1: файл не найден

Симптом

Файл конфигурации отсутствует в ожидаемом расположении

Решение

1. Проверьте, существует ли родительская папка (например, папка .cursor)
2. Если нет, создайте её: mkdir -p ~/.cursor
3. Создайте файл конфигурации: echo '{}' > ~/.cursor/mcp.json
4. Добавьте конфигурацию вашего MCP-сервера

Проблема 2: отказано в доступе

Симптом

Не удаётся сохранить изменения в файле конфигурации

Решение

1. Проверьте права доступа к файлу: ls -l ~/.cursor/mcp.json
2. При необходимости исправьте права: chmod 644 ~/.cursor/mcp.json
3. Убедитесь, что файл принадлежит вам: chown $USER ~/.cursor/mcp.json

Проблема 3: путаница между путями Finder и Terminal

Симптом

Не удаётся найти файл или редактируется не то расположение

Решение

• Используйте ~ для домашней папки (работает и в Finder, и в Terminal)
• Проверьте текущий каталог: pwd в Terminal
• Если не уверены, используйте абсолютные пути: /Users/YourUsername/.cursor/mcp.json
• Используйте «Переход к папке» (Cmd+Shift+G) для точной навигации в Finder

Проблема 4: проблемы с форматированием в TextEdit

Симптом

TextEdit добавляет форматирование или сохраняет как RTF

Решение

1. В TextEdit перейдите в Format → Make Plain Text (Формат → Преобразовать в обычный текст)
2. Или используйте defaults write com.apple.TextEdit RichText -int 0 в Terminal
3. Лучше: используйте VS Code или другой редактор кода

Краткая процедура проверки

Перед перезапуском MCP-клиента

1. ✅ Найден правильный файл конфигурации для вашего клиента
2. ✅ Включены скрытые файлы в Finder (Cmd+Shift+.) при необходимости
3. ✅ Сделана резервная копия исходной конфигурации
4. ✅ Проверен синтаксис JSON (без ошибок)
5. ✅ Файл успешно сохранён
6. ✅ MCP-клиент закрыт перед редактированием
7. ✅ Проверено, что права доступа к файлу разрешают запись

Первый тестовый запрос

После перезапуска MCP-клиента протестируйте с помощью такого запроса:

"Какие инструменты MCP доступны? Перечисли все настроенные MCP-серверы."

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

Краткая справка: все пути в macOS

Связанные материалы по устранению неполадок

• Ошибки JSON в конфигурации — исправление синтаксических ошибок JSON в файлах конфигурации
• Проблемы с конфигурацией Cursor — исправление, когда конфигурация Cursor не применяется после правок
• Пути к конфигурации в Windows — поиск файлов конфигурации в Windows
• Указатель по устранению неполадок — просмотр всех руководств по устранению неполадок