RemoteGymp · API v1

Csatlakoztasson egy AI-asszisztenst

Használjon olyan MCP-ügyfelet, amely támogatja a Streamable HTTP-t, és vagy előre regisztrált OAuth-t PKCE-vel vagy konfigurált vivőjogkivonatot. Az ügyfélszolgálat változó; automatikus ügyfélregisztráció nem elérhető.

MCP szerver URL

https://api.remotegymp.com/mcp

A Self-Hosted esetén használja ugyanazt az MCP-útvonalat a telepítés nyilvános HTTPS-címén. Ügyfelének el kell tudni érnie. A Cloud-cím nem küld proxykérést a telepítéshez.

Csatlakozzon az OAuthhoz

  1. A Beállításokban hozzon létre egy hitelesítő adatot az MCP-vel, és csak az asszisztensnek szükséges engedélyekkel. Regisztrálja az ügyfele által megadott pontos visszahívási URL-t. Használja a hitelesítő felhasználónevet OAuth-ügyfélazonosítóként. Ez a folyamat nem használ ügyféltitkot.
  2. A visszahívásoknak HTTPS-t vagy HTTP-t kell használniuk explicit visszahurkolási címen. A teljes URL-nek meg kell egyeznie, beleértve a portot is. A módosításhoz hozzon létre egy új hitelesítő adatot, és vonja vissza a régit.
  3. Csatlakozzon ügyfelétől, jelentkezzen be a hitelesítő adatot létrehozó Tulajdonosként, és tekintse meg a hozzájárulási képernyőt. Az ügyfélnek S256 PKCE-t és az MCP-erőforrás URL-címét kell használnia. A beleegyezés szűkítheti a hitelesítő adatok engedélyeit; nem adhat hozzá engedélyeket.

Cloud OAuth-végpontok

Engedélyezés
https://app.remotegymp.com/integration/oauth/authorize
Tokencsere
https://app.remotegymp.com/integration/oauth/token
Az engedélyezési szerver metaadatai
https://app.remotegymp.com/.well-known/oauth-authorization-server
Védett erőforrás metaadatai
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

Az OAuth szabványos tokenmezőneveket és forgó frissítési tokeneket használ. Az ügyfélnek automatikusan kell kezelnie a frissítést. A hozzáférési tokenek legfeljebb 30 percig érvényesek. A kapcsolatok frissítés nélkül hét nap vagy összesen 30 nap elteltével járnak le. Egy régi frissítési token újrafelhasználása érvényteleníti a kapcsolatot; csatlakoztassa újra a lejátszás helyett.

Csatlakozás vivőjelzővel

Ha az ügyfél támogatja a konfigurált vivőjogkivonatot, cserélje ki az MCP-kompatibilis hitelesítő adatokat a token végpontján az MCP-közönséggel, majd helyezze a visszaadott tokent az ügyfél biztonságos vivőjogkivonat-beállításába. 30 perc múlva lejár. Ne helyezzen el tokent a szerver URL-jébe. Használja az OAuth-ot az automatikus frissítést igénylő ügyfelek számára.

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

Hitelesítés →

Munkavégzés előtt ellenőrizze a hozzáférést

Kérje meg az ügyfelet, hogy először sorolja fel elérhető eszközeit és olvasási képességeit. Kezdje írásvédett kéréssel, például eszközök listázásával. A hiányzó eszköz engedélyeket, hatókört vagy elérhetőséget tükrözhet. Az MCP engedélyezése önmagában nem biztosít távvezérlést.

tools/list · get_capabilities

A képernyő megtekintése az eszköz beleegyezését követi. A képernyőbevitelhez friss képernyőképre van szükség. A munka jóváhagyása előtt tekintse át a célokat, a törlési előnézeteket és az AI-költségeket. A vészleállító blokkolja a további automatizálást; a már futó munka befejeződhet.

Szüntesse meg vagy vonja vissza a hozzáférést

Szüntesse meg a kapcsolatot az ügyfélben, és vonja vissza a hitelesítő adatot a Beállításokban, amikor már nincs rá szüksége. A visszavonás leállítja a kapcsolódó tokeneket és az OAuth-kapcsolatokat a következő kérések során. Soha ne ossza meg a hitelesítő adatokat a független integrációk között.

Tartalom felülvizsgálata 3f225a253 · OpenAPI SHA-256: b12c42306a89