Журналы Claude Code MCP: найдите первую неудавшуюся границу

Если вы ищете журналы Claude Code MCP , начните с решенного состояния сервера, а затем запишите один файл отладки на уровне инцидента. Не начинайте с отслеживания каталога журналов Claude Desktop: текущая документация MCP помечает эти пути к файловой системе специально для рабочего стола, а Claude Code документирует /mcp , claude mcp list , claude debug mcp и debug file . Полезный результат — это не «найти журнал». Целью является определение первой неудачной границы: конфигурация, утверждение проекта, запуск процесса, обнаружение инструмента, выполнение инструмента или внешний результат, который инструмент должен был произвести. Журнал может объяснить одну границу. Он не может доказать все шесть. В этом руководстве используется текущая документация Claude Code и версия npm 2.1.220 , проверенная 30 июля 2026 г. Прикрепляйте установленную версию к каждому инциденту, поскольку поведение и диагностика MCP все еще меняются. Проверяем разрешенное состояние перед чтением необработанного вывода Запустите эти проверки из того же рабочего каталога и той же учетной записи пользователя, в которой возникла проблема: Внутри затронутого сеанса Claude Code выполните: В официальное руководство по отладке конфигурации указано, что /mcp показывает настроенные серверы, состояние подключения и утверждение проекта. Справочник MCP добавляет две важные эксплуатационные детали: сервер .mcp.json в области проекта может оставаться в режиме ожидания до тех пор, пока рабочая область не станет доверенной и сервер не будет одобрен; подключенный сервер по прежнему может предоставлять ноль инструментов, и /mcp сообщает об этом. Эти факты исключают три класса слепого поиска по журналам: Разрешенные доказательства Первое решение Почему логи не на первом месте Сервер отсутствует CONFIG MISSING Пока нет загруженного серверного процесса для диагностики. Проверьте область видимости и источники настроек. Ожидает одобрения APPROVAL WAIT Это законная граница власти, а не крах. Просмотрите и утвердите его в интерактивном режиме. Не удалось подключиться Захват свидетельств отладки MCP Возможно, произошла ошибка команды, пути, среды, аутентификации или транспорта. Подключено, ноль инструментов Повторно подключитесь, а затем запишите данные отладки MCP При запуске удалось установить соединение, но обнаружение не привело к созданию пригодного к использованию реестра. Подключено, инструменты имеются Воспроизвести один ограниченный вызов Состояние соединения ничего не говорит о выбранном инструменте или его внешнем эффекте. Относительные пути заслуживают особого внимания для локальных серверов stdio. Документы Claude Code указывают, что пути command и args разрешаются из каталога, в котором был запущен Claude Code, а не из местоположения .mcp.json . Таким образом, сервер может работать в одном репозитории и выходить из строя из другого с идентичным текстом конфигурации. Захват файла отладки Claude Code MCP с заданной областью действия Текущий Справочник по интерфейсу командной строки Claude Code документирует два соответствующих флага: debug включает режим отладки и принимает фильтры категорий, такие как mcp ; debug file <path записывает выходные данные отладки по явному пути и неявно включает режим отладки. Создайте частный каталог инцидентов, запустите новый сеанс только с категорией отладки MCP и воспроизведите один ограниченный симптом: Внутри этого сеанса проверьте /mcp . Если сервер подключен без инструментов, используйте действие Повторное подключение один раз. Если инструменты присутствуют, вызывайте только самый маленький инструмент, доступный только для чтения, который воспроизводит проблему. Не повторяйте вызов с возможностью записи только для того, чтобы сделать журнал более интересным. Считайте файл отладки конфиденциальным. Он может содержать абсолютные пути, имена серверов, сведения о среде, метаданные запроса или stderr сервера. Запишите полученные доказательства в квитанцию ​​об инциденте, а затем сохраните или удалите необработанный файл в соответствии с вашей политикой безопасности. Не копируйте токены доступа, тела приглашений, аргументы инструментов, результаты или текст stderr в систему мониторинга только потому, что они содержатся в файле. Публичное сообщение Запрос функции Claude Code для файлов журналов каждого MCP сервера сообщает, что пользователям нужны постоянные файлы в стиле рабочего стола для Claude Code. Этот вопрос является полезным предварительным свидетельством, а не гарантией продукта. Поддерживаемая процедура инцидента должна зависеть от документированного файла явной отладки, а не от предполагаемого пути по умолчанию для каждого сервера. Сопоставьте путь доказательства с транспортом Руководство по отладке MCP для версии протокола 28 июля 2026 г. определяет важную транспортную границу. Для локального сервера stdio стандартный вывод передает сообщения протокола. Диагностика сервера принадлежит stderr; запись диагностического текста в стандартный вывод может повредить поток протокола. Руководство по устранению неполадок Claude Code специально рекомендует использовать claude debug mcp , когда подключенный сервер не предоставляет никаких инструментов, поскольку это делает stderr сервера доступным в свидетельствах отладки. Для Streamable HTTP клиент не может перехватить stderr процесса удаленного сервера. Файл отладки Claude Code по прежнему может отображать соединение на стороне клиента и поведение запроса, но для внутреннего сбоя сервера требуются журналы на стороне сервера или OpenTelemetry плюс проверка на уровне HTTP. Пустой сегмент отладки клиента не является доказательством того, что удаленная служба ничего не сделала. Это различие предотвращает распространенный ложный вывод: Зафиксируйте перевозку в квитанции. Без него фраза «no stderr» будет двусмысленной. Создайте квитанцию ​​об инциденте с минимальным содержанием Необработанный журнал является доказательством для расследования. Квитанция является долговременной медицинской картой. Он может оставаться полезным без хранения контента: Сохраняйте приоритет классификатора явным: Я повторил это правило на примере восьми синтетических случаев. Он правильно разделял отсутствующую конфигурацию, ожидание утверждения, зафиксированный сбой при запуске, подключение нулевых инструментов, ошибку инструмента, успешный ответ инструмента без результата, проверенный результат и неудачное соединение с недостаточными доказательствами отладки. Все восемь ожидаемых штатов прошли проверку. Последние два случая являются важной границей. Результат работы инструмента JSON RPC или отсутствие ошибок является свидетельством активности. Если задача обещала создать проблему, изменить запись, доставить файл или обновить место назначения, проверьте это место назначения отдельно. Без этого подтверждения правильное состояние — OUTCOME UNVERIFIED , неработоспособное. Выбрать наименьшее безопасное следующее действие Каждое состояние должно приводить к одному ограниченному ответу: CONFIG MISSING : проверьте область настроек и точный загруженный файл Claude Code. Не изменяйте код сервера. APPROVAL WAIT : передать утверждение ответственному лицу. Не описывайте ожидание как крах. STARTUP FAILED : устраните первую конкретную причину запуска в свидетельстве отладки области действия, затем повторно подключитесь один раз. DISCOVERY EMPTY : сравнить данные инициализации и списка инструментов; при необходимости протестируйте сервер самостоятельно с помощью MCP Inspector. TOOL CALL FAILED : сохраните идентификатор запроса, определите, безопасна ли повторная попытка, и избегайте повтора неопределенной записи. OUTCOME UNVERIFIED : запросить пункт назначения по стабильному идентификатору. Не запускайте инструмент повторно, пока не убедитесь, что эффект уже произошел. UNCERTAIN : соберите недостающие данные о границах или передайте эскалацию. «Неизвестно» — это рабочее состояние, а не приглашение к догадкам. HEALTHY : требуется как пригодная для использования цепочка MCP, так и свежее, детерминированное получение результата. Журналы делают сбой объяснимым. Разрешенный статус делает его доступным для поиска. Квитанция о назначении позволяет проверить возврат. Разделите эти задания, и инцидент MCP в коде Клода станет коротким упражнением по сбору доказательств, а не последовательностью все более рискованных повторных попыток. Sidewisp разработан с учетом приоритетного для здоровья различия между связью, полезным прогрессом, инструментами и результатами. Sidewisp сейчас находится на этапе закрытого предварительного доступа. Адаптеры производственного мониторинга и программа восстановления обычно не поставляются.