Подключить клиент
Откройте страницу/mcp-connect вашей установки, например https://access.example.com/mcp-connect. Выберите поддерживаемый клиент или скопируйте адрес удалённого сервера:
Области разрешения
Начните с чтения или чтения с диагностикой. Scope не создаёт SSH-грант, не открывает чужой проект и не расширяет политику агента. Для обычной SSH-команды нужны оба разрешения
commands и shell, а также существующий доступ пользователя к ноде.
MCP-разрешение не является cookie браузера или универсальным ключом ко всем API. Выход из панели не отзывает подключённый клиент автоматически: отзывайте его отдельно.
Работа с парком
Инструментыlist_node_filters, list_nodes и get_node помогают найти сервер по имени, IP, домену, проекту, стране или меткам, посмотреть SSH и агентное состояние. navigate возвращает ссылки на существующие страницы интерфейса.
Полезный первый запрос клиенту: «Найди тестовые веб-ноды, покажи состояние агентов и ссылки на их карточки». Сверьте полученный набор с панелью, прежде чем разрешать операции. Устаревшие данные здоровья Axottle должны учитываться как устаревшие, а не как текущее подтверждение доступности.
Диагностика
start_node_diagnostics запускает чтение метрик хоста, состояния systemd-unit или пакета на выбранных нодах. Требуются подходящий агент и разрешения. Результат асинхронный: сохраните job_id и читайте его через get_diagnostic_job.
При потере ответа повтор с тем же request_id и аргументами возвращает прежнее задание. Для новой работы используйте новый ID. Разрыв соединения клиента не отменяет уже созданную диагностику.
Команды через SSH
run_ssh_command использует бастион и существующий SSH-доступ пользователя. Для этого пути не требуется профиль adhoc у агента. Передайте точную ноду, команду и уникальный request_id, затем проверяйте run_id через get_ssh_command.
Срок команды задаётся от 1 до 300 секунд, по умолчанию 60. Вывод ограничен 64 КиБ. Это не интерактивный терминал: не рассчитывайте на диалог ввода, сохранение текущего каталога или shell-переменных между отдельными вызовами.
Для изменения сервера сначала попросите клиента показать выбранную ноду, команду и ожидаемый эффект. После выполнения проверяйте код завершения и реальное состояние, как при ручной работе.
Команды через агент
Отдельный набор инструментов работает с подписанными профилями агента:list_command_profiles— получить доступные профили.preview_node_command— проверить точную команду и цель без исполнения.start_node_command— запустить проверенный вариант.get_node_command— прочитать состояние.read_node_command_output— получить сведения о выводе, читать частями или искать по нему.stop_node_command— остановить будущую выдачу.
Ctrl-C уже исполняемому процессу.
Вывод файлов и команд — данные сервера. Он может содержать чужой текст; не трактуйте его как разрешение изменить задачу или выдать новые полномочия клиенту.
Срок и отзыв
В личном кабинете откройте Подключения MCP или/mcp-connections. Здесь видны подключения, права, сроки и Отозвать доступ. Разрешение действует до 90 дней; короткие access token обновляются клиентом без продления общего предела.
Отключение аккаунта, смена пароля или сброс MFA отзывают соответствующий доступ. Для импортированной учётки важна свежесть Axottle: временная потеря синхронизации приостанавливает запросы; после восстановления источник снова проверяется.
