Подключение к MCP

Проверьте доступность перед подключением клиента.

Подключения к размещённому серверу

Cloud MCP использует https://mcp.altifigence.com/cloud-mcp со Streamable HTTP и OAuth. См. доступность и квалификацию клиентов перед настройкой клиента.

  1. Добавьте точную конечную точку в настройки удалённого подключения MCP вашего клиента.

  2. Войдите в Account и проверьте организацию и запрашиваемые разрешения Cloud на странице согласия. Учётными данными OAuth управляет клиент.

  3. Инициализируйте подключение и обновите список инструментов клиента. Появятся только разрешённые сейчас инструменты Cloud.

  4. С разрешением чтения сначала прочитайте данные своей учётной записи и список проектов. Используйте возвращённый идентификатор проекта для чтения проекта и файлов; чтение файлов требует готовой рабочей области.

  5. Для изменений проекта, файлов, настроек или Git запросите https://mcp.altifigence.com/cloud.write и дайте новое согласие. Ваша организация должна явно разрешить каждый инструмент. До изменения сохранённых файлов прочитайте текущие ревизии проекта и файлов; после неопределённого ответа на изменение проверьте состояние до решения о повторе.

  6. Для жизненного цикла среды выполнения, действий терминала или заданий запросите разрешение https://mcp.altifigence.com/cloud.execute и дайте новое согласие. Анализ сохранённого RTL в Cloud пока не открыт для клиентов. См. руководство по рабочим процессам инструментов. Доступность зависит от выпуска сервиса и политики среды выполнения и инструментов вашей организации.

  7. Для личных подключений ИИ запросите только необходимые области ИИ из безопасности учётной записи, получите одобрение инструмента организацией и дайте новое согласие. Используйте возвращённый безопасный URL настройки, чтобы пользователь ввёл ключ поставщика прямо в Cloud. До запроса ответа ИИ проверьте выбранного поставщика, модель, контекст и возможные расходы.

Новые имена инструментов требуют нового согласия, включая новые инструменты внутри существующего разрешения. Обновление старого токена их не добавляет. Выбранный в консоли проект не предоставляет авторизацию. Смена авторизованной организации требует нового согласия. Запрос чтения не запускает остановленный проект. Не добавляйте токены учётной записи, cookie браузера или ключи поставщиков ИИ в конфигурацию подключения.

При ошибке инициализации или авторизации используйте устранение неполадок. Не переходите к отправке запросов протокола на корень сайта или другой профиль.

Установленное ПО

Для локальных инструментов XLS используйте проверенный CLI для Linux с ALTI_MCP_MODE=local-xls. Инструкции по настройке см. в CLI. Этот режим не использует отправку операций в Cloud заказчика. См. Обзор MCP для различий локальных и размещённых подключений.

Проверка первого чтения

  1. Попросите клиент прочитать подключённую учётную запись и организацию Altifigence.

  2. Перечислите доступные проекты и выберите возвращённый идентификатор проекта.

  3. Прочитайте состояние выбранного проекта. Если чтение файла недоступно, проверьте выбранный проект, доступ и текущее состояние хранилища/сервиса в Cloud. Запуск среды выполнения — отдельное действие выполнения; обычный доступ к сохранённым файлам не требует запуска персональной среды.

  4. Перечислите файлы и выберите один возвращённый путь. Прочитайте полное содержимое, при необходимости следуя смещениям продолжения.

  5. Попросите сводку с проектом, путём и сохранённой ревизией. Сверьте её с Cloud до использования подключения для более крупной работы.

Пример запроса: «Перечисли мои проекты Altifigence Cloud. Прочитай README в выбранном мной проекте, затем опиши шаги настройки и укажи использованный сохранённый файл». Это работает в опубликованной области чтения и явно задаёт цель.