RemoteGymp · API v1

Conecta un asistente de IA

Utilice un cliente MCP que admita Streamable HTTP y OAuth prerregistrado con PKCE o un token de portador configurado. La atención al cliente varía; El registro automático de clientes no está disponible.

URL del servidor MCP

https://api.remotegymp.com/mcp

Para autohospedado, utilice la misma ruta MCP en la dirección HTTPS pública de su instalación. Su cliente debe poder alcanzarlo. La dirección de la nube no envía solicitudes a su instalación.

Conéctate con OAuth

  1. En Configuración, cree una credencial con MCP habilitado y solo los permisos que necesita el asistente. Registre la URL de devolución de llamada exacta proporcionada por su cliente. Utilice el nombre de usuario de la credencial como ID del cliente de OAuth. Este flujo no utiliza un secreto de cliente.
  2. Las devoluciones de llamada deben utilizar HTTPS o HTTP en una dirección de bucle invertido explícita. La URL completa debe coincidir, incluido el puerto. Para cambiarla, cree una nueva credencial y revoque la anterior.
  3. Conéctese desde su cliente, inicie sesión como el Propietario que creó la credencial y revise la pantalla de consentimiento. El cliente debe utilizar S256 PKCE y la URL del recurso MCP. El consentimiento puede limitar los permisos de la credencial; no puede agregar permisos.

Puntos finales de OAuth en la nube

Autorización
https://app.remotegymp.com/integration/oauth/authorize
Intercambio de tokens
https://app.remotegymp.com/integration/oauth/token
Metadatos del servidor de autorización
https://app.remotegymp.com/.well-known/oauth-authorization-server
Metadatos de recursos protegidos
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth utiliza nombres de campos de token estándar y tokens de actualización rotativos. El cliente debería manejar la actualización automáticamente. Los tokens de acceso duran como máximo 30 minutos. Las conexiones caducan después de siete días sin actualización o 30 días en total. Reutilizar un token de actualización antiguo invalida la conexión; vuelva a conectarse en lugar de reproducirlo.

Conéctese con un token al portador

Si su cliente admite un token de portador configurado, intercambie una credencial habilitada para MCP en el punto final del token con la audiencia de MCP y luego coloque el token devuelto en la configuración de token de portador seguro del cliente. Caduca a los 30 minutos. No coloque un token en la URL del servidor. Utilice OAuth para clientes que necesiten una actualización automática.

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

Autenticación →

Verificar el acceso antes de realizar el trabajo.

Pídale al cliente que primero enumere sus herramientas disponibles y las capacidades de lectura. Comience con una solicitud de solo lectura, como enumerar dispositivos. Una herramienta ausente puede reflejar permisos, alcance o disponibilidad. Habilitar MCP por sí solo no otorga control remoto.

tools/list · get_capabilities

La visualización de la pantalla sigue el consentimiento del dispositivo. La entrada de pantalla necesita una captura de pantalla nueva. Revise los objetivos, las vistas previas de eliminación y los costos de IA cotizados antes de aprobar el trabajo. La parada de emergencia bloquea una mayor automatización; el trabajo que ya se está ejecutando puede finalizar.

Desconectar o revocar el acceso

Desconéctate de tu cliente y revoca la credencial en Configuración cuando ya no sea necesaria. La revocación detiene sus tokens asociados y conexiones OAuth en solicitudes posteriores. Nunca comparta la credencial entre integraciones no relacionadas.

Revisión de contenido 3f225a253 · OpenAPI SHA-256: b12c42306a89