Документация

Замена существующих запускателей MCP клиента

У клиента может быть запускатель, отличающийся от реестра: скрипт-обёртка, другой транспорт или старый исполняемый файл. Обычный sync считает это конфликтом. Имя скрипта, личная папка или провайдер не дают автоматического владения.

Перед заменой сравните фактическую команду, аргументы, рабочую папку, окружение, авторизацию и proxy. Обёртка может содержать нужное поведение, которого нет в настройках клиента. Если каноническое описание и секреты Hub уже корректны, сохраняйте их: повторный импорт обёртки лишь перенесёт промежуточный слой в реестр.

Проверьте замену

ahub sync --client dsh --replace first-server second-server --dry-run

--replace выбирает конкретные существующие записи одного клиента. Остальные серверы в области всё ещё синхронизируются, включая добавления и ранее управляемые удаления, поэтому проверяйте полный план файла. Для одной записи дополнительно используйте --only=NAME. Не выбранные конфликты, неподдерживаемые поля, отсутствующие переменные, область клиента и управляемые приложением записи сохраняют защиту. Неизвестные или отсутствующие имена замен отклоняются.

Dry run ничего не пишет и выводит точную команду применения с именами и --expect <revision>. Явная замена без этой ревизии запрещена. Правка входов делает план устаревшим. Реестр Hub и .env эта операция не перезаписывает.

Примените и проверьте

Выполните точную команду только после проверки полного плана. Перед записью sync создаёт закрытую копию и использует общие проверки и компенсирующий откат. Перезапустите клиента, чтобы загрузить новый запускатель.

Повторите обычный dry run без --replace. Успешно перенесённые записи теперь управляются Hub и не должны меняться. Инициализация doctor и tools/list проверяют соединение без вызова инструментов. Готовность backend и права API проверяются отдельно.

Откатите изменения

ahub restore <backup-id> --dry-run

Restore выводит новую команду с ревизией и не перезапишет изменённый после копии файл клиента. Сохраняйте старые скрипты до проверки миграции: операция их не удаляет.