Сервер добавлен, а инструмент не появляется или Claude жалуется, что не может им воспользоваться. Это штатная ситуация — разберём, как искать причину.
Шаг 1. Посмотреть список
Сначала проверь, что сервер вообще подключён и в каком он состоянии:
claude mcp list
Claude Code покажет серверы и их статус. Если рядом с твоим сервером — ошибка или «не подключён», значит, запуск не удался.
Шаг 2. Прочитать логи
Claude Code пишет, что произошло при запуске сервера, в свои логи. Их можно открыть из интерфейса (/mcp в сессии) или найти в каталоге логов Claude Code. В логе обычно видно конкретную причину: процесс не запустился, сервер сразу завершился, не пришёл ответ по сети.
Три частые причины
- Неверная команда запуска (stdio). Опечатка в
commandилиargs, не установлен пакет — процесс просто не стартует. Проверь, что команду из конфига можно запустить вручную в терминале. - Нет или неверный токен. Сервер стартовал, но без доступа к сервису сразу падает. Проверь, что нужная переменная окружения задана:
echo $TRACKER_TOKEN. - Недоступный URL (HTTP). Удалённый сервер не отвечает: опечатка в адресе, сервис лежит, нет сети.
Диагностируй по транспорту: у stdio-сервера сначала проверяй команду и токен, у HTTP-сервера — адрес и доступность сети. После правки конфига сервер обычно нужно переподключить.