RemoteGymp · API v1

Podłącz asystenta AI

Użyj klienta MCP obsługującego Streamable HTTP i albo wstępnie zarejestrowany OAuth z PKCE, albo skonfigurowany token okaziciela. Obsługa klienta jest różna; automatyczna rejestracja klienta nie jest dostępna.

Adres URL serwera MCP

https://api.remotegymp.com/mcp

W przypadku Self-Hosted użyj tej samej ścieżki MCP na publicznym adresie HTTPS swojej instalacji. Twój klient musi mieć możliwość dotarcia do niego. Adres chmury nie przekazuje żądań do Twojej instalacji.

Połącz się za pomocą OAuth

  1. W Ustawieniach utwórz dane uwierzytelniające z włączoną funkcją MCP i tylko uprawnieniami potrzebnymi asystentowi. Zarejestruj dokładny adres URL wywołania zwrotnego dostarczony przez klienta. Użyj nazwy użytkownika poświadczeń jako identyfikatora klienta OAuth. W tym przepływie nie jest używany klucz tajny klienta.
  2. Wywołania zwrotne muszą używać protokołu HTTPS lub HTTP na jawnym adresie zwrotnym. Pełny adres URL musi się zgadzać, łącznie z portem. Aby to zmienić, utwórz nowe dane uwierzytelniające i unieważnij stare.
  3. Połącz się ze swoim klientem, zaloguj się jako właściciel, który utworzył dane uwierzytelniające i przejrzyj ekran zgody. Klient musi używać S256 PKCE i adresu URL zasobu MCP. Zgoda może zawęzić uprawnienia danych uwierzytelniających; nie może dodawać uprawnień.

Punkty końcowe Cloud OAuth

Autoryzacja
https://app.remotegymp.com/integration/oauth/authorize
Wymiana tokenów
https://app.remotegymp.com/integration/oauth/token
Metadane serwera autoryzacji
https://app.remotegymp.com/.well-known/oauth-authorization-server
Chronione metadane zasobów
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth wykorzystuje standardowe nazwy pól tokenów i rotacyjne tokeny odświeżania. Klient powinien automatycznie obsłużyć odświeżanie. Tokeny dostępu działają maksymalnie 30 minut. Połączenia wygasają po siedmiu dniach bez odświeżania lub łącznie po 30 dniach. Ponowne użycie starego tokena odświeżania unieważnia połączenie; podłącz ponownie, zamiast odtwarzać ponownie.

Połącz się za pomocą żetonu okaziciela

Jeśli Twój klient obsługuje skonfigurowany token okaziciela, wymień dane uwierzytelniające z włączoną obsługą MCP w punkcie końcowym tokenu z odbiorcami MCP, a następnie umieść zwrócony token w bezpiecznym ustawieniu tokena okaziciela klienta. Wygasa po 30 minutach. Nie umieszczaj tokena w adresie URL serwera. Użyj protokołu OAuth w przypadku klientów wymagających automatycznego odświeżania.

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

Uwierzytelnianie →

Przed przystąpieniem do pracy sprawdź dostęp

Poproś klienta, aby najpierw wypisał dostępne narzędzia i możliwości przeczytania. Zacznij od żądania tylko do odczytu, takiego jak lista urządzeń. Brak narzędzia może odzwierciedlać uprawnienia, zakres lub dostępność. Samo włączenie MCP nie zapewnia zdalnego sterowania.

tools/list · get_capabilities

Oglądanie ekranu wymaga zgody urządzenia. Wejście ekranowe wymaga świeżego zrzutu ekranu. Przed zatwierdzeniem pracy przejrzyj cele, podglądy usunięcia i podane koszty sztucznej inteligencji. Wyłącznik awaryjny blokuje dalszą automatyzację; już uruchomiona praca może się zakończyć.

Odłącz lub cofnij dostęp

Rozłącz się w swoim kliencie i unieważnij dane uwierzytelniające w Ustawieniach, gdy nie będą już potrzebne. Odwołanie powoduje zatrzymanie powiązanych tokenów i połączeń OAuth w przypadku kolejnych żądań. Nigdy nie udostępniaj poświadczeń pomiędzy niepowiązanymi integracjami.

Zmiany treści 3f225a253 · OpenAPI SHA-256: b12c42306a89