Меню документации

Устранение проблем с подключением MCP

На этой странице

Прежде чем менять проект, проверьте подключение. Большинство проблем при настройке связано с командой запуска сервера, доступом, рабочей областью или выбранным режимом.

  1. Убедитесь, что в окружении процесса клиента доступны Node.js версии 22 или новее и npx.

  2. Проверьте, соответствует ли запись owlmeans формату конфигурации, который ожидает клиент.

  3. Перезапустите клиент после того, как сохраните конфигурацию или измените предпочтительный режим инференса.

    Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
    Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
  4. Проверьте состояние подключения к серверу, затем вызовите session_status.

  5. Войдите в аккаунт через браузер, если срок действия доступа истёк или доступ был отозван.

  6. Проверьте расположение проекта, режим инференса и рабочую область, прежде чем повторить нужное действие.

ПроблемаЧто проверить дальше
Сервер не запускаетсяПуть к команде, массив аргументов и тайм-аут запуска в клиенте.
Инструменты отсутствуютСписок инструментов подключённого хоста, расположение проекта и режим инференса.
Используются не те локальные файлыКорни MCP и явно заданный каталог проекта.
Доступ запрещёнАккаунт, организацию, срок действия токена и переопределение токена через окружение.
Делегированная работа ожидает продолженияОбработку задач агента и вопросы без ответа.
Генерация, похоже, остановиласьСостояние текущего проекта или запуска перед повторной отправкой.

Для локального выполнения или делегированного инференса используйте подключение stdio. Облачная конечная точка не имеет доступа к вашему компьютеру.

В сообщении о проблеме укажите клиент, текст ошибки, выбранный режим и сведения о состоянии без секретных данных. Не передавайте файлы с учётными данными, токены доступа или приватные URL подключения. Прочитайте разделы о входе в аккаунт и настройках CLI.

Названия и товарные знаки

OpenAI, ChatGPT и связанные с ними товарные знаки OpenAI принадлежат OpenAI; Codex — продукт OpenAI. Правила использования.

Claude и Claude Code — продукты Anthropic; их названия и товарные знаки остаются собственностью соответствующего владельца. Правила использования.

Названия Node.js, npx и все связанные с ними товарные знаки остаются собственностью соответствующих владельцев или сопровождающих проектов. Упоминания обозначают продукты, стандарты или примеры исходного кода. Документация OwlMeans не подразумевает спонсорской поддержки или одобрения со стороны этих владельцев.