Обнаружение
- Неаутентифицированный
POST https://mcp.tronrental.com/mcpотвечает401с - Метаданные защищённого ресурса (RFC 9728) называют ресурс
https://mcp.tronrental.com/mcpи сервер авторизацииhttps://mcp.tronrental.com. - Метаданные сервера авторизации (RFC 8414) находятся по адресу
https://mcp.tronrental.com/.well-known/oauth-authorization-server. Его эндпоинты —/oauth/register,/oauth/authorize,/oauth/tokenи/oauth/revokeна том же хосте.
Регистрация клиента
- Dynamic Client Registration (RFC 7591) на
/oauth/register. Клиенты публичные:token_endpoint_auth_methodвсегдаnone. - Client ID Metadata Documents принимаются от поддерживаемых платформ.
- Redirect URI должны быть в списке разрешённых: loopback (
http://127.0.0.1:<any port>,http://localhost:<any port>) и адреса возврата поддерживаемых платформ. Любой другой URI отклоняется сinvalid_redirect_uri. Делаете веб-приложение с собственным адресом возврата? Напишите в поддержку, чтобы его добавили.
Авторизация
- Authorization code flow с PKCE, только
S256. - Параметр
resourceобязателен и должен бытьhttps://mcp.tronrental.com/mcp; токены выдаются для этой аудитории. scopeперечисляет права, которые просит приложение, через пробел, напримерview deposit_view buy_energy. Пользователь может выдать меньше;scopeв ответе с токеном показывает, что выдано.withdrawдля OAuth не существует и отклоняется сinvalid_scope.- Пользователь входит (или регистрируется) на tronrental.com, выбирает аккаунт, права и суточный лимит расходов и подтверждает. Приложение, неизвестное TronRental, показывается как непроверенное.
Токены
Поддерживаются только гранты
authorization_code и refresh_token; client_credentials — нет: для вызовов между серверами используйте API-ключ.
С access-токеном подключённое приложение может вызывать и REST API, но только маршруты из справочника инструментов; любой другой маршрут отвечает 403 AGENT_ROUTE_CLOSED.
Отзыв
- Приложение может отозвать свои токены на
/oauth/revoke. - Пользователь может отключить приложение в разделе Подключённые приложения на странице API личного кабинета: подключение и все его токены отзываются сразу, а следующий вызов
/mcpполучает401сerror="invalid_token". - Подключение одно на аккаунт и приложение: повторное подключение того же приложения обновляет его права и лимит, а не добавляет второе.