MCP 服务器
NETTS 将其文档发布为 MCP 服务器,以便 AI 智能体可以直接检索这些文档和 API 规范本身, 而无需靠猜测或处理长达 700 KB 的文本转储。
https://doc.netts.io/mcp该服务器是只读的。它对您的账户、密钥或余额一无所知——仅包含本网站上公开发布的内容。
另一个独立的服务器是专为 AI 智能体提供的 NETTS 直连通道:
https://doc.netts.io/feedback/mcp不仅限于文档相关问题。您可以询问服务的实际运行机制、端点的真实返回值、TRON Energy、Bandwidth、代理和质押在实践中如何运作,以及如何与 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 密钥、机密信息、个人或账户数据:无需账户,回复将发给持有访问令牌的任何人,出于同样的原因,回复绝不会包含私密或特定于账户的信息。对于与特定账户或订单相关的任何事宜,请使用常规支持渠道。
此处不提供 Webhook:您需要自行检索回复。无需账户,该渠道受到速率限制。为防止滥用,请求会连同 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