·guide·Fasad Salatov
Ошибки конфига MCP: чиним claude_desktop_config.json
Лишние запятые, неверные пути, забытый env — пять ошибок конфига, которые ломают MCP, и как правильно.
Конфиг MCP маленький, но не прощает ошибок. Вот пять, которые его ломают, и правильная форма.
Правильная форма
Каждый сервер — одна запись под mcpServers с ключом-именем на твой выбор:
command— исполняемый файл (обычноnpxилиuvx).args— массив, например["-y", "@scope/server"].env— необязательный объект с секретами/настройками.
Пять ошибок
- Лишняя запятая после последнего ключа. В JSON её быть не может — это ломает весь файл.
- args строкой вместо массива. Должно быть
["-y", "pkg"], а не"-y pkg". - Пути Windows без экранирования. Обратные слэши удваиваются:
C:\\Users\\me\\.... - Секреты в args вместо env. Токены — в
env, не в командной строке, иначе утекут в логи. - Не тот файл/место. Правишь не тот
claude_desktop_config.json(он ровно один, пути выше) — и изменение ни на что не влияет.
Как убедиться, что валидно
Вставь файл в JSON-валидатор до перезапуска. Парсится — Claude прочитает. Если Claude всё равно игнорит сервер — JSON в порядке, но падает сама команда: запусти её в терминале и посмотри ошибку.
Пропусти файл вообще
Ручная правка — корень всех пунктов выше. На Unyly Install пишет запись в нужный файл, в нужной форме, под Cursor / VS Code / Claude Code / Claude Desktop — без JSON руками.