> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Разработка с MCP

> Используйте MCP-сервер TronRental из своего приложения или агента: выберите способ аутентификации, затем пример

MCP-сервер TronRental работает по стандартному [транспорту Streamable HTTP](https://modelcontextprotocol.io/specification/latest/basic/transports) на `https://mcp.tronrental.com/mcp`. Его может использовать любой MCP SDK или LLM-платформа, которая поддерживает удалённые MCP-серверы.

* **Без состояния:** каждый запрос — обычный `POST`; сессии хранить не нужно.
* **Инструменты зависят от учётных данных:** `tools/list` возвращает только те инструменты, которые может вызывать ключ или подключение.
* **Те же правила, что у REST:** за каждым инструментом стоит маршрут [REST API](https://docs.tronrental.com/ru/api-reference/energy/get-prices.md), с теми же ценами, проверками и кодами ошибок.

## Выберите способ аутентификации

> [card] API-ключ — ваш собственный сервер
>
> Для вашего бэкенда, скриптов и агентов, которые работают с **вашим** аккаунтом. Передавайте ключ как `Authorization: Bearer <key>` или `X-API-Key: <key>`. Без суточного лимита, `max_price_trx` необязателен, вывод возможен с правом `withdraw`.

> [card] OAuth — аккаунты ваших пользователей
>
> Для приложений, где **каждый пользователь** подключает свой аккаунт TronRental. Пользователь подтверждает [экран согласия](https://docs.tronrental.com/ru/agents/overview.md#вы-сохраняете-контроль); вы получаете токен с правами и суточным лимитом, которые он выбрал. См. [OAuth для MCP-клиентов](https://docs.tronrental.com/ru/agents/reference/oauth.md).

Создайте API-ключ на [странице API](https://tronrental.com/dashboard/api) личного кабинета (доступно после пополнений на 100 TRX в сумме). Давайте ему только те права, которые нужны вашему агенту.

> [!WARNING]
>
> Когда MCP-сервер вызывает за вас LLM-платформа (hosted MCP в OpenAI, MCP-коннектор Claude API), ваш ключ или токен передаётся этой платформе, а вызовы приходят с **её** IP-адресов. Используйте ключ без `withdraw`, держите его права узкими и учтите, что ключ с белым списком IP такие вызовы отклонит. Чтобы ключ оставался на вашем сервере, запускайте MCP-клиент сами (примеры на TypeScript и Python).

## Выберите пример

> [card] [TypeScript](https://docs.tronrental.com/ru/agents/build/typescript.md)
>
> MCP-клиент по Streamable HTTP на официальном TypeScript SDK.

> [card] [Python](https://docs.tronrental.com/ru/agents/build/python.md)
>
> MCP-клиент по Streamable HTTP на официальном Python SDK.

> [card] [OpenAI Agents SDK](https://docs.tronrental.com/ru/agents/build/openai-agents.md)
>
> Hosted MCP-инструмент и локальный MCP-клиент для агентов OpenAI.

> [card] [Claude API](https://docs.tronrental.com/ru/agents/build/claude-api.md)
>
> MCP-коннектор в запросе Messages API.

## MCP или REST?

Используйте **MCP**, когда решает языковая модель, какой вызов сделать: модель читает список инструментов и их описания и выбирает инструмент.

Используйте **[REST API](https://docs.tronrental.com/ru/api-reference/energy/get-prices.md)**, когда ваш код уже знает, что делать, — например, «купить 65,000 энергии перед каждой выплатой». Это один HTTP-запрос без слоя MCP, а [вебхуки](https://docs.tronrental.com/ru/api-reference/webhooks/overview.md) сообщат, когда заказ выполнен. Оба способа используют один и тот же API-ключ, поэтому их можно сочетать.

## Перед запуском

* **Сначала цена, потом покупка.** Передавайте `total_trx` из котировки как `max_price_trx`. См. [Расходы и ошибки](https://docs.tronrental.com/ru/agents/reference/spending-and-errors.md).
* **Безопасные повторы.** Генерируйте `idempotency_key` (UUID) на каждое действие и используйте его повторно при ретраях.
* **Показывайте стоимость.** Сообщайте пользователю, сколько стоит вызов, прежде чем вызвать инструмент, который тратит деньги, — каждый такой инструмент помечен `destructiveHint: true`.
* **Проверяйте результат.** Заказы доставляются в блокчейн за секунды; читайте `get_order` или ждите вебхук `order.updated`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.