из умного чата в агента который реально что-то делает: лезет в GitHub, парсит сайты, работает с твоими локальными приложениями. Без MCP он умный, но слепой. С MCP - умный и с руками.
Проблема в том что конфиги для десктопного приложения и для CLI - разные файлы, разные места, разная логика. Путаница там постоянная, и большинство инструкций написаны либо только для Mac, либо игнорируют десктопную версию. Разберём Windows конкретно.
Десктопное приложение: где лежит конфиг
На скриншоте выше видно папку
- вот там и живёт всё что нужно. Файл называется
без расширения в проводнике, но по факту это JSON.
Быстрый путь туда - вставь в адресную строку проводника:
Файл который нужен:
Открывай любым текстовым редактором - Notepad, VS Code, что угодно. Структура такая:
Вот реальный пример с тремя серверами - firecrawl для парсинга сайтов, Pencil для дизайна и Burp Suite для безопасности:
После сохранения -
полностью закрой приложение
. Не сворачивай, именно закрой через трей. Потом открывай заново. Если MCP подключился - в нижней части нового чата появится иконка молотка с цифрой (количество инструментов).
CLI: совсем другой файл, и это важно
Вот где люди ломаются чаще всего. Для Claude Code CLI (терминальная версия) MCP серверы идут
не в
- туда класть бесполезно, он просто проигнорируется без единого предупреждения.
Правильное место - файл
в домашней директории:
Обрати внимание - это не папка
, а файл
на уровень выше. Разница в одну точку, и именно из-за неё половина людей час ищет где проблема.
Добавить сервер можно двумя способами.
Способ 1 - команда в терминале:
Если нужна переменная окружения с ключом - проще редактировать файл руками, команда с
неудобная.
Способ 2 - редактировать
напрямую:
Если файла
нет - создай его сам, это нормально.
Для конкретного проекта
(а не глобально) - создай файл
в корне проекта. Его можно коммитить в git если команда использует одни и те же серверы.
Проверить что всё подхватилось - в сессии напечатай
. Покажет список серверов и статус каждого.
Частые ошибки и как их чинить
Сервер не появляется после перезапуска
Первое что проверять - синтаксис JSON. Лишняя запятая в конце блока, отсутствующая запятая между серверами, непарные скобки - всё это приводит к тому что файл молча игнорируется. Скопируй содержимое в
и проверь.
или
Node.js не установлен или не прописан в PATH. Установи с
, после установки перезапусти терминал. Проверь:
и
должны выдавать версии.
Пути с пробелами на Windows
Если путь к exe содержит пробелы (
) - в JSON нужны двойные обратные слеши и путь в кавычках уже есть за счёт самого JSON. Как в примере с Pencil выше -
работает корректно.
Сервер подключился но Claude его не использует
Это нормальное поведение в 2026 - Claude Code использует Tool Search и не загружает все инструменты сразу. Он подтянет инструмент когда задача будет релевантной. Если хочешь убедиться что сервер живой - напечатай
и посмотри статус:
значит всё ок.
В десктопе работает, в CLI нет (или наоборот)
Это разные конфиги, они не синхронизируются. Если добавил сервер в
- в CLI его не будет. Нужно добавить отдельно в
Ошибка при запуске Burp или других Java-приложений
Убедись что путь к
правильный и версия Java совместима с jar-файлом. Также проверь что порт в
совпадает с тем что реально слушает сервер.
Scope: локальный или глобальный
В CLI есть понятие scope - область видимости сервера.
- сервер доступен во всех проектах, хранится в
. Для серверов с личными API-ключами.
- только для текущего проекта, хранится в
в папке проекта. Можно коммитить если ключи не нужны или используются командные.
По умолчанию
создаёт user scope. Для проектного:
Не клади серверы с личными ключами в
который идёт в git - это утечка.
Полезные команды для CLI
Если разбираешься как устроен Opus и почему он так хорошо работает с инструментами - есть
полный обзор модели
с бенчмарками и сравнениями. А про то как Anthropic думает об агентных возможностях на уровне архитектуры -
