RemoteGymp · API v1

Connetti un assistente AI

Utilizzare un client MCP che supporti Streamable HTTP e OAuth preregistrato con PKCE o un token di connessione configurato. Il supporto del cliente varia; la registrazione automatica del cliente non è disponibile.

URL del server MCP

https://api.remotegymp.com/mcp

Per Self-Hosted, utilizzare lo stesso percorso MCP sull'indirizzo HTTPS pubblico della propria installazione. Il tuo cliente deve essere in grado di raggiungerlo. L'indirizzo cloud non invia richieste proxy alla tua installazione.

Connettiti con OAuth

  1. In Impostazioni, crea una credenziale con MCP abilitato e solo le autorizzazioni necessarie all'assistente. Registra l'esatto URL di richiamata fornito dal tuo cliente. Utilizza il nome utente della credenziale come ID client OAuth. Questo flusso non utilizza un segreto client.
  2. Le richiamate devono utilizzare HTTPS o HTTP su un indirizzo di loopback esplicito. L'URL completo deve corrispondere, inclusa la porta. Per modificarlo, crea una nuova credenziale e revoca quella vecchia.
  3. Connettiti dal tuo client, accedi come Proprietario che ha creato la credenziale e rivedi la schermata di consenso. Il client deve utilizzare S256 PKCE e l'URL della risorsa MCP. Il consenso può restringere le autorizzazioni della credenziale; non può aggiungere autorizzazioni.

Endpoint OAuth cloud

Autorizzazione
https://app.remotegymp.com/integration/oauth/authorize
Scambio di gettoni
https://app.remotegymp.com/integration/oauth/token
Metadati del server di autorizzazione
https://app.remotegymp.com/.well-known/oauth-authorization-server
Metadati delle risorse protette
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth utilizza nomi di campi token standard e token di aggiornamento a rotazione. Il client dovrebbe gestire l'aggiornamento automaticamente. I token di accesso durano al massimo 30 minuti. Le connessioni scadono dopo sette giorni senza aggiornamento o 30 giorni in totale. Il riutilizzo di un vecchio token di aggiornamento invalida la connessione; riconnettersi invece di riprodurlo.

Connettiti con un token al portatore

Se il tuo client supporta un token di connessione configurato, scambia una credenziale abilitata per MCP sull'endpoint del token con il pubblico MCP, quindi inserisci il token restituito nell'impostazione sicura del token di connessione del client. Scade dopo 30 minuti. Non inserire un token nell'URL del server. Utilizza OAuth per i client che necessitano di aggiornamento automatico.

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

Autenticazione →

Controllare l'accesso prima di iniziare il lavoro

Chiedere al cliente di elencare gli strumenti disponibili e leggere prima le funzionalità. Inizia con una richiesta di sola lettura, ad esempio elencando i dispositivi. Uno strumento assente può riflettere autorizzazioni, ambito o disponibilità. L'attivazione del solo MCP non garantisce il controllo remoto.

tools/list · get_capabilities

La visualizzazione dello schermo presuppone il consenso del dispositivo. L'input sullo schermo richiede un nuovo screenshot. Esamina gli obiettivi, le anteprime di eliminazione e i costi AI preventivati ​​prima di approvare il lavoro. L'arresto di emergenza blocca ulteriori automazioni; il lavoro già in corso potrebbe terminare.

Disconnettersi o revocare l'accesso

Disconnettiti dal tuo client e revoca la credenziale in Impostazioni quando non è più necessaria. La revoca interrompe i token associati e le connessioni OAuth nelle richieste successive. Non condividere mai le credenziali tra integrazioni non correlate.

Revisione dei contenuti 3f225a253 · OpenAPI SHA-256: b12c42306a89