Descubrimiento
- Un
POST https://mcp.tronrental.com/mcpsin autenticar responde401con - Los metadatos del recurso protegido (RFC 9728) indican el recurso
https://mcp.tronrental.com/mcpy el servidor de autorizaciónhttps://mcp.tronrental.com. - Los metadatos del servidor de autorización (RFC 8414) están en
https://mcp.tronrental.com/.well-known/oauth-authorization-server. Sus endpoints son/oauth/register,/oauth/authorize,/oauth/tokeny/oauth/revokeen el mismo host.
Registro del cliente
- Dynamic Client Registration (RFC 7591) en
/oauth/register. Los clientes son públicos:token_endpoint_auth_methodsiempre esnone. - Se aceptan Client ID Metadata Documents de las plataformas compatibles.
- Las redirect URI deben estar en la lista permitida: loopback (
http://127.0.0.1:<any port>,http://localhost:<any port>) y los callbacks de las plataformas compatibles. Cualquier otra URI se rechaza coninvalid_redirect_uri. ¿Estás creando una app web con su propio callback? Contacta con soporte para que lo añadamos.
Autorización
- Flujo authorization code con PKCE, solo
S256. - El parámetro
resourcees obligatorio y debe serhttps://mcp.tronrental.com/mcp; los tokens se emiten para esta audiencia. scopeenumera los permisos que pide la app, separados por espacios, por ejemploview deposit_view buy_energy. El usuario puede conceder menos; elscopede la respuesta del token indica lo concedido.withdrawno existe para OAuth y se rechaza coninvalid_scope.- El usuario inicia sesión (o se registra) en tronrental.com, elige la cuenta, los permisos y el límite diario de gasto, y aprueba. Una app que TronRental no conoce se muestra como no verificada.
Tokens
Solo se admiten los grants
authorization_code y refresh_token; client_credentials no. Para llamadas de servidor a servidor usa una clave API.
Con un access token, una app conectada también puede llamar a la API REST, pero solo a las rutas que figuran en la referencia de herramientas; cualquier otra ruta responde 403 AGENT_ROUTE_CLOSED.
Revocación
- La app puede revocar sus tokens en
/oauth/revoke. - El usuario puede desconectar la app en Aplicaciones conectadas, en la página API del panel: la conexión y todos sus tokens se revocan a la vez, y la siguiente llamada a
/mcprecibe401conerror="invalid_token". - Hay una conexión por cuenta y app: volver a conectar la misma app actualiza sus permisos y su límite en lugar de añadir una segunda.