Сервер MCP
NETTS публикует свою документацию в виде MCP-сервера, благодаря чему ИИ-агент может выполнять поиск по этой документации и самой спецификации API вместо того, чтобы гадать или обрабатывать текстовый дамп размером 700 КБ.
https://doc.netts.io/mcpСервер работает в режиме только для чтения. Он ничего не знает о вашей учетной записи, ключах или балансе — только то, что опубликовано на этом сайте.
Второй, отдельный сервер — это прямая связь с NETTS для ИИ-агентов:
https://doc.netts.io/feedback/mcpНе только о документации. Спрашивайте, как сервис ведет себя на самом деле, что действительно возвращает эндпоинт, как Energy, Bandwidth, делегирование и стейкинг в TRON работают на практике, как взаимодействовать с TRC-20 и другими смарт-контрактами. Сообщайте об ошибках, предлагайте новые функции, поднимайте вопросы безопасности. Текст читает человек и пишет ответ.
Два сервера сделаны намеренно вместо одного. Сервер документации остается доступным только для чтения, поэтому хост может разрешить модели свободно искать по документации; у этого сервера есть побочные эффекты — он сохраняет ваш текст и показывает его людям — и он должен запрашивать подтверждение у пользователя перед вызовом.
Что получает агент
| Инструмент | Что делает |
|---|---|
search_docs | Полнотекстовый поиск по страницам документации |
get_doc | Полный текст одной страницы в формате Markdown |
list_docs | Индекс всех страниц |
search_api | Поиск операций NETTS API v2 |
get_endpoint | Параметры, схемы, ответы и коды ошибок одной операции |
get_openapi_schema | Повторно используемая схема из спецификации |
Блог намеренно не индексируется: это статьи для людей, и для агента они представляют собой шум.
Вопросы к NETTS
Обо всем, что не проясняет документация. Человек читает сообщение и пишет ответ; ничего не генерируется автоматически, и ничего из отправленного вами само по себе не меняет сервис или документацию.
| Инструмент | Что делает |
|---|---|
ask_netts | Отправляет вопрос, отчет или предложение сотрудникам NETTS, возвращает feedback_id и access_token |
get_answer | Возвращает статус и, когда он готов, ответ |
Выберите подходящий kind, чтобы сообщение попало нужному специалисту:
kind | Для чего использовать |
|---|---|
question | Как работает сервис, что на самом деле возвращает эндпоинт, TRON Energy и Bandwidth, делегирование, стейкинг, TRC-20 и другие контракты |
documentation_error | Что-то на странице неверно |
missing_information | Что-то важное не задокументировано вовсе |
suggestion | Идея по улучшению сервиса или API |
security | Вопрос безопасности или рекомендация |
Как это работает:
- Вызовите
ask_nettsс вашим сообщением, случайным значениемidempotency_key, а также — если вопрос касается конкретной страницы или операции — сdoc_pathилиoperation_id. Они сверяются с опубликованным релизом, поэтому используйте значения, полученные от сервера документации; для общих вопросов опускайте их. - Вы получаете обратно
feedback_id,access_token, расчетное время ответа иpoll_after_seconds. Сохраните токен: это единственный ключ к ответу. - Вернитесь позже с помощью
get_answer. Пока человек не ответил, статус будетnewилиin_review.
Повторная отправка того же idempotency_key с тем же телом запроса возвращает ту же запись вместо создания второй, поэтому обрыв соединения ни к чему не приводит.
Перед вызовом инструмента. Текст передается людям в NETTS. Сначала спросите пользователя и никогда не включайте в запрос ключи API, секреты, персональные данные или данные учетной записи: учетная запись не нужна, ответ получит любой владелец токена доступа, и по этой же причине ответ никогда не содержит приватной информации или данных по конкретной учетной записи. Для решения любых вопросов, связанных с определенной учетной записью или заказом, используйте обычные каналы поддержки.
Вебхуки отсутствуют: вы запрашиваете ответ самостоятельно. Учетная запись не нужна, канал имеет ограничения по частоте запросов (rate limits). Для защиты от злоупотреблений запросы записываются в журнал вместе с IP-адресом; журналы хранятся 90 дней.
Подключение
Cursor и VS Code — используйте пункты Connect to Cursor и Connect to VS Code в меню в верхней части любой страницы документации. Они устанавливают сервер в один клик.
Claude Code
claude mcp add --transport http netts-docs https://doc.netts.io/mcpВсе остальное — протокол передачи данных Streamable HTTP, без аутентификации. Добавьте оба сервера: сервер документации и сервер обратной связи, если вы хотите иметь возможность задавать вопросы.
{
"mcpServers": {
"netts-docs": {
"type": "http",
"url": "https://doc.netts.io/mcp"
},
"netts-docs-feedback": {
"type": "http",
"url": "https://doc.netts.io/feedback/mcp"
}
}
}Для Claude Code второй сервер добавляется так:
claude mcp add --transport http netts-docs-feedback https://doc.netts.io/feedback/mcpБез MCP
Если ваш инструмент не поддерживает MCP, те же материалы доступны в виде обычных файлов:
/llms.txt— структурированный индекс документации/llms-full.txt— вся документация в одном файле/openapi.yaml— спецификация API- любая страница с добавлением
.md, например/api/v2/endpoints/order1h.md