RemoteGymp · API v1

Yhdistä AI-avustaja

Käytä MCP-asiakasta, joka tukee Streamable HTTP:tä ja joko esirekisteröityä OAuthia PKCE:llä tai määritettyä siirtotietunnusta. Asiakastuki vaihtelee; automaattinen asiakasrekisteröinti ei ole käytettävissä.

MCP-palvelimen URL-osoite

https://api.remotegymp.com/mcp

Jos kyseessä on Self-Hosted, käytä samaa MCP-polkua asennuksesi julkisessa HTTPS-osoitteessa. Asiakkaasi on voitava tavoittaa se. Pilviosoite ei lähetä välityspalvelinpyyntöjä asennuksellesi.

Yhdistä OAuthiin

  1. Luo Asetuksissa tunnistetiedot, joissa MCP on käytössä ja vain avustajan tarvitsemat käyttöoikeudet. Rekisteröi asiakkaasi toimittama tarkka takaisinsoitto-URL-osoite. Käytä tunnistetietojen käyttäjänimeä OAuth-asiakastunnuksena. Tämä työnkulku ei käytä asiakassalaisuutta.
  2. Takaisinkutsujen on käytettävä HTTPS-protokollaa tai HTTP:tä nimenomaisessa takaisinkytkentäosoitteessa. Koko URL-osoitteen on vastattava porttia. Jos haluat muuttaa sitä, luo uusi valtuustieto ja peruuta vanha.
  3. Muodosta yhteys asiakkaaltasi, kirjaudu sisään valtuustietojen luoneena omistajana ja tarkista suostumusnäyttö. Asiakkaan on käytettävä S256 PKCE:tä ja MCP-resurssin URL-osoitetta. Suostumus voi kaventaa valtuustietojen käyttöoikeuksia; se ei voi lisätä käyttöoikeuksia.

Cloud OAuth -päätepisteet

Valtuutus
https://app.remotegymp.com/integration/oauth/authorize
Tokenin vaihto
https://app.remotegymp.com/integration/oauth/token
Valtuutuspalvelimen metatiedot
https://app.remotegymp.com/.well-known/oauth-authorization-server
Suojatun resurssin metatiedot
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth käyttää vakiokenttien nimiä ja pyöriviä päivitystunnisteita. Asiakkaan tulee käsitellä päivitys automaattisesti. Käyttöoikeudet kestävät enintään 30 minuuttia. Yhteydet vanhenevat seitsemän päivän kuluttua ilman päivitystä tai yhteensä 30 päivän kuluttua. Vanhan päivitystunnuksen uudelleenkäyttö mitätöi yhteyden; muodosta yhteys uudelleen toiston sijaan.

Yhdistä siirtotietunnuksella

Jos asiakkaasi tukee määritettyä siirtotietunnusta, vaihda MCP-yhteensopiva valtuustieto tunnuksen päätepisteessä MCP-yleisön kanssa ja aseta sitten palautettu valtuutus asiakkaan suojatun siirtotietunnuksen asetukseen. Se vanhenee 30 minuutin kuluttua. Älä laita merkkiä palvelimen URL-osoitteeseen. Käytä OAuthia asiakkaille, jotka tarvitsevat automaattisen päivityksen.

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

Todennus →

Tarkista pääsy ennen töiden aloittamista

Pyydä asiakasta luettelemaan ensin käytettävissä olevat työkalunsa ja lukuominaisuudet. Aloita vain luku -pyynnöllä, kuten laitteiden luetteloimalla. Poissa oleva työkalu voi heijastaa käyttöoikeuksia, laajuutta tai saatavuutta. Pelkästään MCP:n käyttöönotto ei anna kauko-ohjausta.

tools/list · get_capabilities

Näytön katselu seuraa laitteen suostumusta. Näytön syöttö vaatii uuden kuvakaappauksen. Tarkista tavoitteet, poistojen esikatselut ja noteeratut tekoälykustannukset ennen työn hyväksymistä. Hätäpysäytys estää lisäautomaation; jo käynnissä oleva työ saattaa päättyä.

Katkaise yhteys tai peruuta käyttöoikeus

Katkaise yhteys asiakassovelluksessa ja peruuta valtuustiedot asetuksista, kun niitä ei enää tarvita. Peruuttaminen pysäyttää siihen liittyvät tunnukset ja OAuth-yhteydet myöhemmissä pyynnöissä. Älä koskaan jaa valtuustietoja toisiinsa liittymättömien integraatioiden välillä.

Sisällön versio 3f225a253 · OpenAPI SHA-256: b12c42306a89