RemoteGymp · API v1

Conectați un asistent AI

Utilizați un client MCP care acceptă HTTP Streamable și fie OAuth preînregistrat cu PKCE, fie un token purtător configurat. Suportul pentru clienți variază; înregistrarea automată a clientului nu este disponibilă.

Adresa URL a serverului MCP

https://api.remotegymp.com/mcp

Pentru Self-Hosted, utilizați aceeași cale MCP pe adresa HTTPS publică a instalării. Clientul dvs. trebuie să poată ajunge la el. Adresa Cloud nu trimite solicitări proxy pentru instalarea dvs.

Conectați-vă cu OAuth

  1. În Setări, creați o acreditare cu MCP activat și numai permisiunile de care are nevoie asistentul. Înregistrați adresa URL exactă de apel invers furnizată de clientul dvs. Utilizați numele de utilizator acreditiv ca ID de client OAuth. Acest flux nu folosește un secret de client.
  2. Reapelurile trebuie să utilizeze HTTPS sau HTTP pe o adresă de loopback explicită. Adresa URL completă trebuie să se potrivească, inclusiv portul. Pentru a o schimba, creați o nouă acreditare și revocați-o pe cea veche.
  3. Conectați-vă de la clientul dvs., conectați-vă ca Proprietar care a creat acreditările și examinați ecranul de consimțământ. Clientul trebuie să utilizeze S256 PKCE și adresa URL a resursei MCP. Consimțământul poate restrânge permisiunile acreditării; nu poate adăuga permisiuni.

Puncte finale Cloud OAuth

Autorizare
https://app.remotegymp.com/integration/oauth/authorize
Schimb de jetoane
https://app.remotegymp.com/integration/oauth/token
Metadatele serverului de autorizare
https://app.remotegymp.com/.well-known/oauth-authorization-server
Metadatele resurselor protejate
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth folosește nume standard de câmpuri de jetoane și jetoane de reîmprospătare rotative. Clientul ar trebui să gestioneze automat reîmprospătarea. Jetoanele de acces durează cel mult 30 de minute. Conexiunile expiră după șapte zile fără reîmprospătare sau după 30 de zile în total. Reutilizarea unui vechi token de reîmprospătare invalidează conexiunea; reconectați-vă în loc să îl reluați.

Conectați-vă cu un jeton purtător

Dacă clientul dvs. acceptă un simbol purtător configurat, schimbați o acreditare activată pentru MCP la punctul final al jetonului cu publicul MCP, apoi puneți jetonul returnat în setarea securizată a jetonului purtător al clientului. Expiră după 30 de minute. Nu puneți un token în adresa URL a serverului. Utilizați OAuth pentru clienții care au nevoie de reîmprospătare automată.

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

Autentificare →

Verificați accesul înainte de a lucra

Cereți clientului să listeze mai întâi instrumentele sale disponibile și să citească capabilitățile. Începeți cu o solicitare numai în citire, cum ar fi listarea dispozitivelor. Un instrument absent poate reflecta permisiuni, domeniul sau disponibilitatea. Activarea MCP singură nu oferă control de la distanță.

tools/list · get_capabilities

Vizualizarea ecranului urmează consimțământul dispozitivului. Intrarea pe ecran necesită o captură de ecran nouă. Examinați obiectivele, previzualizările de ștergere și costurile AI cotate înainte de a aproba munca. Oprirea de urgență blochează automatizarea ulterioară; lucrul care rulează deja se poate termina.

Deconectați sau revocați accesul

Deconectați-vă de la client și revocați acreditările din Setări atunci când nu mai sunt necesare. Revocarea oprește tokenurile asociate și conexiunile OAuth la solicitările ulterioare. Nu împărtășiți niciodată acreditările între integrări care nu au legătură.

Revizuirea conținutului 3f225a253 · OpenAPI SHA-256: b12c42306a89