RemoteGymp · API v1

Подключите ИИ-помощника

Используйте клиент MCP, который поддерживает потоковый HTTP и либо предварительно зарегистрированный OAuth с PKCE, либо настроенный токен носителя. Поддержка клиентов варьируется; автоматическая регистрация клиентов недоступна.

URL-адрес сервера MCP.

https://api.remotegymp.com/mcp

Для самостоятельного размещения используйте тот же путь MCP на общедоступном HTTPS-адресе вашей установки. Ваш клиент должен иметь возможность добраться до него. Облачный адрес не передает запросы к вашей установке.

Подключитесь с помощью OAuth

  1. В настройках создайте учетные данные с включенным MCP и только теми разрешениями, которые нужны помощнику. Зарегистрируйте точный URL-адрес обратного вызова, предоставленный вашим клиентом. Используйте имя пользователя с учетными данными в качестве идентификатора клиента OAuth. Этот поток не использует секрет клиента.
  2. Обратные вызовы должны использовать HTTPS или HTTP с явным адресом обратной связи. Полный URL-адрес должен совпадать, включая порт. Чтобы изменить его, создайте новые учетные данные и отзовите старые.
  3. Подключитесь из своего клиента, войдите в систему как владелец, создавший учетные данные, и просмотрите экран согласия. Клиент должен использовать S256 PKCE и URL-адрес ресурса MCP. Согласие может сузить разрешения учетных данных; он не может добавлять разрешения.

Конечные точки Cloud OAuth

Авторизация
https://app.remotegymp.com/integration/oauth/authorize
Обмен токенов
https://app.remotegymp.com/integration/oauth/token
Метаданные сервера авторизации
https://app.remotegymp.com/.well-known/oauth-authorization-server
Метаданные защищенного ресурса
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth использует стандартные имена полей токенов и токены чередующегося обновления. Клиент должен автоматически обрабатывать обновление. Токены доступа действуют не более 30 минут. Срок действия подключений истекает через семь дней без обновления или в общей сложности через 30 дней. Повторное использование старого токена обновления делает соединение недействительным; переподключитесь вместо повторного воспроизведения.

Подключение с помощью токена на предъявителя

Если ваш клиент поддерживает настроенный токен носителя, обменяйтесь учетными данными с поддержкой MCP в конечной точке токена с аудиторией MCP, а затем поместите возвращенный токен в настройку безопасного токена носителя клиента. Срок действия истекает через 30 минут. Не помещайте токен в URL-адрес сервера. Используйте OAuth для клиентов, которым требуется автоматическое обновление.

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

Аутентификация →

Проверьте доступ перед выполнением работы

Попросите клиента сначала перечислить доступные инструменты и ознакомиться с возможностями. Начните с запроса только для чтения, например перечисления устройств. Отсутствующий инструмент может отражать разрешения, область действия или доступность. Включение MCP само по себе не обеспечивает удаленное управление.

tools/list · get_capabilities

Просмотр экрана осуществляется с согласия устройства. Для ввода экрана требуется новый снимок экрана. Прежде чем утверждать работу, просмотрите цели, предварительные просмотры удаления и указанные затраты на ИИ. Аварийная остановка блокирует дальнейшую автоматизацию; уже запущенная работа может закончиться.

Отключить или отозвать доступ

Отключитесь в своем клиенте и отзовите учетные данные в настройках, когда они больше не нужны. Отзыв останавливает связанные токены и соединения OAuth при последующих запросах. Никогда не делитесь учетными данными между несвязанными интеграциями.

Редактирование контента 3f225a253 · OpenAPI SHA-256: b12c42306a89