Устранение неполадок MCP
Найдите следующий шаг при проблеме подключения.
Не удаётся подключить размещённый клиент
Проверьте, что настроенный URL — https://mcp.altifigence.com/cloud-mcp и клиент поддерживает Streamable HTTP с OAuth. Следуйте руководству по подключению и проверьте текущий статус квалификации. Страница здоровья сервера и метаданные OAuth не доказывают завершение авторизации конкретным клиентом.
Результат | Следующий шаг |
|---|---|
HTTP 401 | Подключите Altifigence Cloud заново, если авторизация истекла или отозвана; повторно пройдите авторизацию клиента |
HTTP 403 | Проверьте организацию согласия, текущий доступ к проекту и политику инструмента; подключитесь с нужным разрешением после включения инструмента организацией |
Инструменты пусты или отсутствуют | Проверьте выпущенный каталог, явное одобрение организации и новое согласие для каждого инструмента; обновление старого токена не добавляет инструменты |
Чтение рабочей области недоступно | Проверьте состояние и доступ рабочей области в Cloud; повторите после готовности |
Инструменты выполнения отсутствуют | Запросите новое согласие |
Инструменты записи отсутствуют | Запросите новое согласие |
Конфликт изменения файла | Перечитайте манифест и файл, проверьте параллельные изменения, затем отправьте нужное изменение с текущими ревизиями |
Создание проекта или изменение Git не подтверждено | Проверьте список проектов, репозиторий или удалённое состояние перед повтором; повтор создания, коммита или push может иметь нежелательные эффекты |
Удаление проекта принято | Отслеживайте состояние проекта/рабочей области до завершения очистки; «принято» не означает «завершено» |
Передача провайдера Git запрещена | Проверьте выбранные репозиторий, ветку и текущее подключение провайдера; инструмент не обходит разрешения провайдера |
Операция среды не подтверждена | Прочитайте статус среды и сохраните ID операции; возобновление использует ID операции остановленной среды |
Поколение проекта, версия файла или политика изменились | Получите новую оценку и проверьте выбранное предложение и политику использования |
Отправка не подтверждена | Проверьте тот же ID задания; повторяйте только с идентичными аргументами и тем же ID |
Результат не готов | Прочитайте статус задания перед повторным запросом результата |
Недостаточно кредитов | Проверьте состояние оплаты организации в Cloud |
HTTP 413 | Сократите запрос до аргументов обнаруженной схемы инструмента |
HTTP 501 от локального инструмента | Установленная среда не реализует операцию; одно обнаружение не подтверждает поддержку |
HTTP 503 | Дождитесь восстановления сервиса; сохраните настроенную точку подключения |
Запрос чтения не запускает и не перезапускает проект. Неизвестные или неавторизованные имена инструментов не включают редактирование или выполнение. Исправьте подключение или условие доступа перед повтором; не передавайте альтернативные учётные данные в аргументах.
Слишком много запросов
Если ответ содержит HTTP 429, подождите период из Retry-After перед повтором. Избегайте повторных попыток регистрации или входа.
Обратитесь в поддержку
Обратитесь в поддержку Altifigence, указав имя клиента, версию, время проблемы и сообщение ошибки после удаления чувствительной информации. Не включайте учётные данные, cookies или содержимое проекта.
Восстановление без дублирования работы
Место сбоя | Что проверить перед повтором |
|---|---|
Идентичность или обнаружение | Версию клиента, точку подключения, вход/сеанс и список инструментов согласия. |
Продолжение чтения файла | Версии файла и манифеста; начните заново при изменённом снимке. |
Запись файла, коммит или push | Текущее состояние сохранённого файла, репозитория и удалённого сервера. |
Отправка задания | Существующие ID и статус задания; сохраняйте исходную идентичность. |
Ввод терминала или AI-запрос | Текущие сеанс/вывод; не воспроизводите ввод автоматически. |
Запишите минимальный воспроизводимый запрос с заполнителями вместо данных проекта. Сохраните код ошибки, HTTP-статус, ID запроса, если показан, и время. Удалите токены и содержимое исходников перед передачей диагностики.