Descoberta
- Um
POST https://mcp.tronrental.com/mcpsem autenticação responde401com - Os metadados do recurso protegido (RFC 9728) indicam o recurso
https://mcp.tronrental.com/mcpe o servidor de autorizaçãohttps://mcp.tronrental.com. - Os metadados do servidor de autorização (RFC 8414) estão em
https://mcp.tronrental.com/.well-known/oauth-authorization-server. Os endpoints são/oauth/register,/oauth/authorize,/oauth/tokene/oauth/revokeno mesmo host.
Registro do cliente
- Dynamic Client Registration (RFC 7591) em
/oauth/register. Os clientes são públicos:token_endpoint_auth_methodé semprenone. - Client ID Metadata Documents são aceitos de plataformas compatíveis.
- Redirect URIs precisam estar na lista permitida: loopback (
http://127.0.0.1:<any port>,http://localhost:<any port>) e os callbacks de plataformas compatíveis. Qualquer outra URI é recusada cominvalid_redirect_uri. Está criando um app web com callback próprio? Fale com o suporte para adicioná-lo.
Autorização
- Fluxo de authorization code com PKCE, apenas
S256. - O parâmetro
resourceé obrigatório e deve serhttps://mcp.tronrental.com/mcp; os tokens são emitidos para esse público. scopelista as permissões que o app pede, separadas por espaços, por exemploview deposit_view buy_energy. O usuário pode conceder menos; oscopeda resposta de token diz o que foi concedido.withdrawnão existe para OAuth e é recusado cominvalid_scope.- O usuário entra (ou se cadastra) em tronrental.com, escolhe a conta, as permissões e o limite diário de gastos, e aprova. Um app que a TronRental não conhece aparece como não verificado.
Tokens
Só os grants
authorization_code e refresh_token são suportados; client_credentials não — para chamadas entre servidores use uma chave de API.
Com um token de acesso, um app conectado também pode chamar a API REST, mas apenas as rotas listadas na referência de ferramentas; qualquer outra rota responde 403 AGENT_ROUTE_CLOSED.
Revogação
- O app pode revogar os próprios tokens em
/oauth/revoke. - O usuário pode desconectar o app em Aplicativos conectados na página de API do painel: a conexão e todos os seus tokens são revogados de uma vez, e a próxima chamada a
/mcprecebe401comerror="invalid_token". - Há uma conexão por conta e app: conectar o mesmo app de novo atualiza as permissões e o limite em vez de criar uma segunda.