RemoteGymp · API v1

Connectez un assistant IA

Utilisez un client MCP prenant en charge Streamable HTTP et soit OAuth pré-enregistré avec PKCE, soit un jeton de support configuré. Le support client varie ; L'enregistrement automatique des clients n'est pas disponible.

URL du serveur MCP

https://api.remotegymp.com/mcp

Pour l'auto-hébergement, utilisez le même chemin MCP sur l'adresse HTTPS publique de votre installation. Votre client doit pouvoir l'atteindre. L'adresse Cloud ne transmet pas les requêtes à votre installation.

Connectez-vous avec OAuth

  1. Dans Paramètres, créez un identifiant avec MCP activé et uniquement les autorisations dont l'assistant a besoin. Enregistrez l'URL de rappel exacte fournie par votre client. Utilisez le nom d'utilisateur des informations d'identification comme ID client OAuth. Ce flux n'utilise pas de secret client.
  2. Les rappels doivent utiliser HTTPS ou HTTP sur une adresse de bouclage explicite. L'URL complète doit correspondre, y compris le port. Pour le modifier, créez un nouvel identifiant et révoquez l'ancien.
  3. Connectez-vous depuis votre client, connectez-vous en tant que propriétaire qui a créé les informations d'identification et examinez l'écran de consentement. Le client doit utiliser S256 PKCE et l'URL de la ressource MCP. Le consentement peut restreindre les autorisations des informations d'identification ; il ne peut pas ajouter d'autorisations.

Points de terminaison Cloud OAuth

Autorisation
https://app.remotegymp.com/integration/oauth/authorize
Échange de jetons
https://app.remotegymp.com/integration/oauth/token
Métadonnées du serveur d'autorisation
https://app.remotegymp.com/.well-known/oauth-authorization-server
Métadonnées des ressources protégées
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth utilise des noms de champs de jetons standard et des jetons d'actualisation rotatifs. Le client doit gérer l'actualisation automatiquement. Les jetons d'accès durent au maximum 30 minutes. Les connexions expirent après sept jours sans actualisation ou 30 jours au total. La réutilisation d'un ancien jeton d'actualisation invalide la connexion ; reconnectez-vous au lieu de le rejouer.

Connectez-vous avec un jeton au porteur

Si votre client prend en charge un jeton de porteur configuré, échangez un identifiant compatible MCP au point de terminaison du jeton avec l'audience MCP, puis placez le jeton renvoyé dans le paramètre de jeton de porteur sécurisé du client. Il expire après 30 minutes. Ne mettez pas de jeton dans l'URL du serveur. Utilisez OAuth pour les clients nécessitant une actualisation automatique.

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

Authentification →

Vérifiez l'accès avant de travailler

Demandez au client de lister d'abord ses outils disponibles et ses capacités de lecture. Commencez par une requête en lecture seule, telle que la liste des appareils. Un outil absent peut refléter les autorisations, la portée ou la disponibilité. L'activation de MCP seule n'accorde pas le contrôle à distance.

tools/list · get_capabilities

L'affichage de l'écran suit le consentement de l'appareil. La saisie à l’écran nécessite une nouvelle capture d’écran. Examinez les objectifs, les aperçus de suppression et les coûts d’IA indiqués avant d’approuver le travail. L'arrêt d'urgence bloque toute automatisation ultérieure ; les travaux déjà en cours pourraient se terminer.

Déconnecter ou révoquer l'accès

Déconnectez-vous de votre client et révoquez les informations d'identification dans Paramètres lorsqu'elles ne sont plus nécessaires. La révocation arrête ses jetons associés et les connexions OAuth lors des demandes ultérieures. Ne partagez jamais les informations d’identification entre des intégrations non liées.

Révision du contenu 3f225a253 · OpenAPI SHA-256: b12c42306a89