RemoteGymp · API v1

Підключіть помічника AI

Використовуйте клієнт MCP, який підтримує Streamable HTTP і або попередньо зареєстрований OAuth з PKCE, або налаштований маркер носія. Підтримка клієнтів різна; автоматична реєстрація клієнта недоступна.

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

https://api.remotegymp.com/mcp

Для Self-Hosted використовуйте той самий шлях 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