Máy chủ MCP

NETTS phát hành tài liệu của mình dưới dạng một máy chủ MCP, giúp tác nhân AI có thể tìm kiếm các tài liệu này và chính đặc tả kỹ thuật API thay vì phải phỏng đoán hoặc tiếp nhận một bản trích xuất văn bản thô nặng 700 KB.

https://doc.netts.io/mcp

Máy chủ này ở chế độ chỉ đọc. Nó không biết gì về tài khoản, khóa hay số dư của bạn — chỉ biết những nội dung được công bố trên trang web này.

Máy chủ thứ hai, độc lập là kênh liên lạc trực tiếp tới NETTS dành cho các tác nhân AI:

https://doc.netts.io/feedback/mcp

Không chỉ dành riêng cho tài liệu. Hãy hỏi về cách dịch vụ thực sự hoạt động, endpoint thực sự trả về những gì, Energy, Bandwidth, ủy quyền (delegation) và staking trên TRON vận hành trên thực tế ra sao, cách tương tác với TRC-20 và các hợp đồng thông minh khác. Báo cáo lỗi, đề xuất tính năng, nêu các lo ngại về bảo mật. Một nhân sự thật sẽ đọc và viết câu trả lời.

Việc tách thành hai máy chủ thay vì một là có chủ đích. Máy chủ tài liệu được giữ ở chế độ chỉ đọc để máy chủ host có thể cho phép mô hình tìm kiếm tài liệu thoải mái; máy chủ phản hồi này có tác dụng phụ (side effect) — nó lưu văn bản của bạn và hiển thị cho con người xem — và nên hỏi ý kiến người dùng trước khi được gọi.

Những gì tác nhân nhận được

Công cụ	Chức năng
search_docs	Tìm kiếm toàn văn trên các trang tài liệu
get_doc	Toàn bộ nội dung Markdown của một trang
list_docs	Mục lục của tất cả các trang
search_api	Tìm kiếm các thao tác của NETTS API v2
get_endpoint	Tham số, schema, phản hồi và mã lỗi của một thao tác
get_openapi_schema	Một schema có thể tái sử dụng từ đặc tả kỹ thuật

Phần blog cố tình không được lập chỉ mục: đó là các bài viết dành cho con người, và đối với tác nhân thì chúng là dữ liệu nhiễu.

Đặt câu hỏi cho NETTS

Bất kỳ điều gì tài liệu chưa làm rõ. Một nhân sự thật sẽ đọc và viết câu trả lời; không có nội dung nào được tạo tự động, và không có nội dung nào bạn gửi có thể tự nó làm thay đổi dịch vụ hoặc tài liệu.

Công cụ	Chức năng
ask_netts	Gửi câu hỏi, báo cáo hoặc đề xuất tới đội ngũ NETTS, trả về feedback_id và access_token
get_answer	Trả về trạng thái và nội dung phản hồi sau khi được soạn xong

Chọn một kind để tin nhắn đến đúng người phụ trách:

kind	Mục đích sử dụng
question	Cách dịch vụ hoạt động, endpoint thực sự trả về những gì, Energy và Bandwidth của TRON, ủy quyền, staking, TRC-20 và các hợp đồng khác
documentation_error	Nội dung nào đó trên một trang bị sai
missing_information	Nội dung quan trọng hoàn toàn chưa được ghi chép lại
suggestion	Ý tưởng cải thiện dịch vụ hoặc API
security	Mối lo ngại về bảo mật hoặc một khuyến nghị

Quy trình hoạt động:

1. Gọi ask_netts cùng với nội dung tin nhắn của bạn, một idempotency_key ngẫu nhiên, và — khi câu hỏi liên quan đến một trang hoặc thao tác cụ thể — doc_path hoặc operation_id. Các giá trị này sẽ được xác thực dựa trên bản phát hành đã công bố, vì vậy hãy sử dụng các giá trị mà máy chủ tài liệu đã cung cấp cho bạn; bỏ qua chúng đối với các câu hỏi chung.
2. Bạn sẽ nhận lại một feedback_id, một access_token, thời gian phản hồi ước tính và poll_after_seconds. Hãy giữ lại token này: nó là chìa khóa duy nhất để nhận câu trả lời.
3. Quay lại kiểm tra sau bằng get_answer. Cho đến khi có người trả lời, trạng thái sẽ là new hoặc in_review.

Việc gửi lại cùng một idempotency_key với cùng phần thân (body) sẽ trả về bản ghi tương tự thay vì tạo bản ghi thứ hai, do đó mất kết nối mạng sẽ không gây tốn kém thêm chi phí.

Trước khi bạn gọi công cụ này. Văn bản sẽ được chuyển tới đội ngũ nhân sự tại NETTS. Hãy hỏi ý kiến người dùng trước, và tuyệt đối không bao gồm API key, dữ liệu bí mật, thông tin cá nhân hoặc thông tin tài khoản: không cần tài khoản, câu trả lời sẽ được gửi tới bất kỳ ai nắm giữ access token, và vì lý do đó câu trả lời sẽ không bao giờ chứa thông tin riêng tư hoặc đặc thù của tài khoản. Đối với bất kỳ vấn đề nào gắn liền với một tài khoản hoặc đơn hàng cụ thể, hãy sử dụng các kênh hỗ trợ thông thường.

Không có webhook: bạn sẽ tự truy xuất câu trả lời. Không cần tài khoản, và kênh có giới hạn tần suất (rate limit). Để ngăn chặn lạm dụng, các yêu cầu được ghi nhật ký kèm địa chỉ IP; nhật ký được lưu trong 90 ngày.

Kết nối

Cursor và VS Code — sử dụng các mục Connect to Cursor và Connect to VS Code trong menu ở đầu bất kỳ trang tài liệu nào. Chúng sẽ cài đặt máy chủ chỉ với một cú nhấp chuột.

Claude Code

claude mcp add --transport http netts-docs https://doc.netts.io/mcp

Các môi trường khác — phương thức truyền tải là Streamable HTTP, không yêu cầu xác thực. Hãy thêm cả hai máy chủ: máy chủ tài liệu, và máy chủ phản hồi nếu bạn muốn có thể đặt câu hỏi.

{
  "mcpServers": {
    "netts-docs": {
      "type": "http",
      "url": "https://doc.netts.io/mcp"
    },
    "netts-docs-feedback": {
      "type": "http",
      "url": "https://doc.netts.io/feedback/mcp"
    }
  }
}

Đối với Claude Code, lệnh cho máy chủ thứ hai là:

claude mcp add --transport http netts-docs-feedback https://doc.netts.io/feedback/mcp

Không sử dụng MCP

Nếu công cụ của bạn không hỗ trợ MCP, nội dung tương tự được cung cấp dưới dạng các tệp văn bản thuần túy:

• /llms.txt — chỉ mục có cấu trúc của tài liệu
• /llms-full.txt — toàn bộ tài liệu trong một tệp duy nhất
• /openapi.yaml — đặc tả kỹ thuật API
• bất kỳ trang nào có thêm đuôi .md, ví dụ /api/v2/endpoints/order1h.md