Устранение неполадок MCP

Найдите следующий шаг при проблеме подключения.

Не удаётся подключить размещённый клиент

Проверьте, что настроенный URL — https://mcp.altifigence.com/cloud-mcp и клиент поддерживает Streamable HTTP с OAuth. Следуйте руководству по подключению и проверьте текущий статус квалификации. Страница здоровья сервера и метаданные OAuth не доказывают завершение авторизации конкретным клиентом.

Результат

Следующий шаг

HTTP 401

Подключите Altifigence Cloud заново, если авторизация истекла или отозвана; повторно пройдите авторизацию клиента

HTTP 403

Проверьте организацию согласия, текущий доступ к проекту и политику инструмента; подключитесь с нужным разрешением после включения инструмента организацией

Инструменты пусты или отсутствуют

Проверьте выпущенный каталог, явное одобрение организации и новое согласие для каждого инструмента; обновление старого токена не добавляет инструменты

Чтение рабочей области недоступно

Проверьте состояние и доступ рабочей области в Cloud; повторите после готовности

Инструменты выполнения отсутствуют

Запросите новое согласие cloud.execute и проверьте релиз, политику организации и доступ к среде проекта

Инструменты записи отсутствуют

Запросите новое согласие cloud.write и проверьте явные разрешения организации на инструмент и проект

Конфликт изменения файла

Перечитайте манифест и файл, проверьте параллельные изменения, затем отправьте нужное изменение с текущими ревизиями

Создание проекта или изменение 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 запроса, если показан, и время. Удалите токены и содержимое исходников перед передачей диагностики.