СтатьяГайд

Cline не видит MCP сервер: как починить конфиг в VS Code

Автор отметил, что материал написан или существенно правлен с помощью ИИ (Редакционный ИИ-агент).

Cline не видит MCP сервер: как починить конфиг в VS Code

В чем суть проблемы с Cline и MCP сервером

Короче, сидел вчера настраивал связку VS Code плюс Cline, чтобы агент сам дергал нужные локальные инструменты через Model Context Protocol. И всё сломалось на ровном месте. В логах Cline висит банальное connection refused, хотя сам сервер из терминала поднимается нормально и по curl отвечает.

У меня в репе лежал кастомный JSON-сервер для работы с базой. Cline упорно делал вид, что его не существует, или падал по таймауту. Если у вас то же самое — cline mcp connection refused или cline не подключается к mcp, дело почти всегда в путях внутри конфига и том, как VS Code передает переменные окружения.

В чем суть проблемы с Cline и MCP сервером
VS Code terminal error log

Где искать этот проклятый mcp server json config cline

Вся эта кухня живет не в корне проекта, как я сначала наивно думал, а в глобальной директории пользователя. Cline хранит настройки MCP в отдельном файле. Если вы на маке или линуксе, то путь будет примерно такой:

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json. На винде путь ведет в AppData/Roaming. Откройте этот файл и посмотрите, что у вас прописано в секции mcpServers.

Разбор типичной ошибки в конфиге

У меня ошибка крылась в путях к интерпретатору Node.js. Я указал просто node, надеясь на глобальный PATH. Но у VS Code, когда его запускаешь через графический интерфейс macOS, свой собственный усеченный PATH, который понятия не имеет о ваших nvm или fnm.

В итоге агент пытался запустить скрипт через системную ноду, у которой не было нужных зависимостей, и сервер молча дох при старте. Cline при этом просто галлюцинировал ошибки связи, потому что процесс падал моментально.

Рабочий патч конфига без воды

Вот рабочий вариант, который завелся у меня после всех танцев с бубном. Обратите внимание: пути к исполняемым файлам прописаны абсолютные, а не через относительные сокращения.

Сохраните этот JSON в свой cline_mcp_settings.json, перезапустите VS Code, и сервер обязан подхватиться.

Чек-лист: проверяем, почему всё еще может не работать

Если вы поменяли конфиг, а Cline всё равно делает вид, что ничего не изменилось, пройдитесь по этому списку. Я наступил на каждые из этих граблей.

  • Скомпилирован ли проект сервера? Если у вас TypeScript, убедитесь, что вы сделали npm run build и файлы в dist лежат на месте.
  • Абсолютные пути. Замените все тильды ~ и относительные пути на полные системные пути от корня диска.
  • Логи. Откройте панель Output в VS Code, выберите в выпадающем списке Cline и смотрите сырые stderr процессы.
  • Версии протокола. Убедитесь, что сам пакет @modelcontextprotocol/sdk актуален и у вас не развязались версии на клиенте и сервере.
  • Рестарт расширения. Иногда просто перезагрузки окна VS Code (Command Palette -> Developer: Reload Window) недостаточно, проще полностью убить процесс IDE.
0
18

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

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

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

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

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

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

Никита Орлов

Симптом: Cursor IDE не видит локальный интерпретатор Python Симптом: при открытии проекта в Cursor IDE линтер ругается на отсутствие модулей, а в правом нижнем углу или через палитру команд не удается выбрать локальный интерпретатор из папки .venv. Поведение воспроизводится при открытии нового воркспейса на базе стандартного модуля venv или Poetry без явно прописанных путей в конфигурации рабочей зоны. Причина сбоя: расхождение путей в settings.json и workspace Поскольку Cursor построен на базе VS Code, он использует те же механизмы поиска интерпретаторов, но часто теряет контекст проекта из-за структуры вложенных папок или монорепозиториев. Если в настройках воркспейса жестко не зафиксирован путь к исполняемому файлу python, сканер окружения падает по таймауту или берет дефолтную системную версию. Фиксим через ручную правку settings.json

Показать полностью
0
24
Никита Орлов

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

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

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

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

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

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

Зачем мы вообще стали искать дешевую CRM для малого бизнеса Привет! На связи Павел Дронов. У нас тут небольшая точка, клиенты идут потоком, и в какой-то момент блокноты и таблички в Excel просто треснули по швам. Менеджер забыл перезвонить, кто-то потерял чек, клиент ушел к конкурентам. Знакомая картина, да? Я сел выбирать софт и схватился за голову. Цены на некоторые разрекламированные системы улетают в космос — смотришь на тариф, а там подписки на три-пять тысяч в месяц за каждого сотрудника. Для маленького бизнеса это разорительно. Мы не корпорация, нам не нужны космические отчеты по эффективности каждого отдела или интеграция с какими-то заморскими сервисами. Нам нужно, чтобы воронка продаж не забивалась, клиенты получали вовремя смски, а база не терялась. Поэтому я потратил пару недель, протестировал с десяток вариантов и собрал личный топ

Дешевые CRM для малого бизнеса: топ и реальный счет за софтПоказать полностью
0
12
Никита Орлов

Введение в мультиагентные системы: почему старые подходы больше не тащат Привет! У меня в репе за последние полгода скопилось столько экспериментов с AI-агентами, что пора бы разложить всё по полочкам. Если раньше мы просто кидали промпты в LLM через API и радовались, то теперь бизнес требует полноценных конвейеров. Один агент пишет код, второй ищет баги, третий ревьюит — и всё это должно крутиться без падений. Пытаться писать такую оркестрацию на голом Python и костылях из asyncio — верный способ поседеть к релизу. Нужны нормальные фреймворки для мультиагентных систем, топ которых я как раз и хочу разобрать. Ниже — пять инструментов, которые мы щупали руками, ловили на них баги и собирали работающие контуры. LangGraph: когда нужен полный контроль над состоянием графа Первый кандидат в нашем списке — LangGraph от команды LangChain. Я начинал с

Фреймворки для мультиагентных систем: топ-5 инструментов в 2025Показать полностью
0
27