Когда сервер не отвечает

Сервер добавлен, а инструмент не появляется или Claude жалуется, что не может им воспользоваться. Это штатная ситуация — разберём, как искать причину.

Шаг 1. Посмотреть список

Сначала проверь, что сервер вообще подключён и в каком он состоянии:

claude mcp list

Claude Code покажет серверы и их статус. Если рядом с твоим сервером — ошибка или «не подключён», значит, запуск не удался.

Шаг 2. Прочитать логи

Claude Code пишет, что произошло при запуске сервера, в свои логи. Их можно открыть из интерфейса (/mcp в сессии) или найти в каталоге логов Claude Code. В логе обычно видно конкретную причину: процесс не запустился, сервер сразу завершился, не пришёл ответ по сети.

Три частые причины

Неверная команда запуска (stdio). Опечатка в command или args, не установлен — процесс просто не стартует. Проверь, что команду из конфига можно запустить вручную в терминале.
Нет или неверный токен. Сервер стартовал, но без доступа к сервису сразу падает. Проверь, что нужная переменная окружения задана: echo $TRACKER_TOKEN.
Недоступный URL (HTTP). Удалённый сервер не отвечает: опечатка в адресе, сервис лежит, нет сети.

Совет

Диагностируй по транспорту: у stdio-сервера сначала проверяй команду и токен, у HTTP-сервера — адрес и доступность сети. После правки конфига сервер обычно нужно переподключить.

Практика в терминале

Пройди сценарий починки в тренажёре ниже: в конфиге уже есть сервер tracker с опечаткой в команде запуска (traker вместо tracker). Найди его через claude mcp list, удали командой claude mcp remove, подключи заново с правильной командой и проверь список ещё раз.

Проверь себя

Отвечено 0/3

Режим:

С чего начать, если MCP-инструмент недоступен?

Какая из причин типична именно для stdio-сервера?

Сервер стартует, но тут же падает с ошибкой доступа к сервису. Что проверить в первую очередь?

Вопросы и ответы по уроку

С чего начать, если MCP-инструмент недоступен?

Первый шаг — claude mcp list: он показывает статус серверов и сразу видно, упал ли запуск.