Перейти к основному содержанию
Telepúrte предоставляет MCP-сервер для внешних клиентов и помощников. Через него можно искать ноды, получать состояние, запускать диагностику и разрешённые команды. Доступ принадлежит конкретному пользователю Telepúrte и ограничивается его актуальными правами.

Подключить клиент

Откройте страницу /mcp-connect вашей установки, например https://access.example.com/mcp-connect. Выберите поддерживаемый клиент или скопируйте адрес удалённого сервера:
В клиенте выберите удалённый MCP с OAuth. Он откроет Telepúrte для входа локальной учёткой или через Axottle SSO. Проверьте аккаунт, название клиента, точный адрес возврата, запрошенные права и срок, затем подтвердите доступ. Имя клиента сообщает само приложение, поэтому ориентируйтесь также на адрес возврата. Не передавайте клиенту основной пароль через его произвольную форму: авторизация проходит на странице Telepúrte.

Области разрешения

Начните с чтения или чтения с диагностикой. 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-переменных между отдельными вызовами. Для изменения сервера сначала попросите клиента показать выбранную ноду, команду и ожидаемый эффект. После выполнения проверяйте код завершения и реальное состояние, как при ручной работе.

Команды через агент

Отдельный набор инструментов работает с подписанными профилями агента:
  1. list_command_profiles — получить доступные профили.
  2. preview_node_command — проверить точную команду и цель без исполнения.
  3. start_node_command — запустить проверенный вариант.
  4. get_node_command — прочитать состояние.
  5. read_node_command_output — получить сведения о выводе, читать частями или искать по нему.
  6. stop_node_command — остановить будущую выдачу.
Здесь действуют ограничения профилей агента: срок до 30 секунд и сохранение до 4096 байт вывода. Не переносите на этот путь лимиты обычной SSH-команды. Остановка не посылает Ctrl-C уже исполняемому процессу. Вывод файлов и команд — данные сервера. Он может содержать чужой текст; не трактуйте его как разрешение изменить задачу или выдать новые полномочия клиенту.

Срок и отзыв

В личном кабинете откройте Подключения MCP или /mcp-connections. Здесь видны подключения, права, сроки и Отозвать доступ. Разрешение действует до 90 дней; короткие access token обновляются клиентом без продления общего предела. Отключение аккаунта, смена пароля или сброс MFA отзывают соответствующий доступ. Для импортированной учётки важна свежесть Axottle: временная потеря синхронизации приостанавливает запросы; после восстановления источник снова проверяется.

Проверка

Начните с чтения парка, затем выполните безвредную диагностику одной ноды. Сверьте результат в Telepúrte. Проверьте, что клиент не видит недоступный пользователю сервер. После тестового отзыва новый вызов должен потребовать повторной авторизации.

Откат

Отзовите разрешение клиента в Telepúrte и удалите подключение из клиента. Уже созданное задание остановите отдельно; выполненные команды не отменяются отзывом OAuth. Для возврата изменений используйте соответствующую процедуру восстановления ноды. Проверяйте версии всех участвующих компонентов и фактические настройки своей установки.