> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP: подключение внешних клиентов

> OAuth-подключение к парку, области доступа, диагностика, SSH-команды, сохранённые результаты и отзыв.

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

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

Откройте страницу `/mcp-connect` вашей установки, например `https://access.example.com/mcp-connect`. Выберите поддерживаемый клиент или скопируйте адрес удалённого сервера:

```text theme={null}
https://access.example.com/mcp
```

В клиенте выберите удалённый MCP с OAuth. Он откроет Telepúrte для входа локальной учёткой или через Axottle SSO. Проверьте аккаунт, название клиента, точный адрес возврата, запрошенные права и срок, затем подтвердите доступ.

Имя клиента сообщает само приложение, поэтому ориентируйтесь также на адрес возврата. Не передавайте клиенту основной пароль через его произвольную форму: авторизация проходит на странице Telepúrte.

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

| Scope | Возможности |
| - | - |
| `telepurte:read` | Фильтры, поиск нод, карточки и ссылки на страницы |
| `telepurte:diagnostics` | Дополнительно — читающая диагностика через агента |
| `telepurte:commands` | Разрешённые операции команд |
| `telepurte:shell` | Дополнительное разрешение произвольного shell/SSH-команд |

Начните с чтения или чтения с диагностикой. 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` — остановить будущую выдачу.

Здесь действуют ограничения [профилей агента](https://docs.axottle.com/ru/telepurte/commands.md): срок до 30 секунд и сохранение до 4096 байт вывода. Не переносите на этот путь лимиты обычной SSH-команды. Остановка не посылает `Ctrl-C` уже исполняемому процессу.

Вывод файлов и команд — данные сервера. Он может содержать чужой текст; не трактуйте его как разрешение изменить задачу или выдать новые полномочия клиенту.

## Срок и отзыв

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

Отключение аккаунта, смена пароля или сброс MFA отзывают соответствующий доступ. Для импортированной учётки важна свежесть Axottle: временная потеря синхронизации приостанавливает запросы; после восстановления источник снова проверяется.

## Проверка

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

## Откат

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

Проверяйте версии всех участвующих компонентов и фактические настройки своей установки.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.