เซิร์ฟเวอร์ MCP
NETTS เผยแพร่เอกสารประกอบในรูปแบบเซิร์ฟเวอร์ MCP เพื่อให้ตัวแทน AI (AI agent) สามารถค้นหาเอกสารเหล่านี้และข้อกำหนดเฉพาะของ API ได้โดยตรง แทนที่จะต้องคาดเดาหรือรับข้อมูลข้อความขนาดใหญ่ถึง 700 KB
https://doc.netts.io/mcpเซิร์ฟเวอร์นี้เป็นแบบอ่านอย่างเดียว (read-only) โดยจะไม่ทราบข้อมูลใดๆ เกี่ยวกับบัญชี คีย์ หรือยอดคงเหลือของคุณ — มีเพียงข้อมูลที่เผยแพร่อยู่บนเว็บไซต์นี้เท่านั้น
เซิร์ฟเวอร์ตัวที่สองซึ่งแยกต่างหากคือช่องทางติดต่อโดยตรงสู่ NETTS สำหรับตัวแทน AI:
https://doc.netts.io/feedback/mcpไม่จำกัดเพียงแค่เรื่องเอกสารประกอบเท่านั้น คุณสามารถสอบถามเกี่ยวกับการทำงานจริงของบริการ ผลลัพธ์ที่แท้จริงจากเอนด์พอยต์ การทำงานจริงของ TRON Energy, Bandwidth, การมอบสิทธิ์ (delegation) และการสเตก (staking) ตลอดจนวิธีโต้ตอบกับ TRC-20 และสมาร์ตคอนแทรกต์อื่นๆ รายงานข้อผิดพลาด เสนอแนะฟีเจอร์ หรือแจ้งข้อกังวลด้านความปลอดภัย โดยจะมีเจ้าหน้าที่เป็นผู้อ่านและเขียนตอบกลับ
เหตุผลที่แยกออกเป็นสองเซิร์ฟเวอร์อย่างตั้งใจ คือเพื่อให้เซิร์ฟเวอร์เอกสารประกอบคงสถานะอ่านอย่างเดียว ซึ่งโฮสต์สามารถอนุญาตให้โมเดลค้นหาเอกสารได้อย่างอิสระ ในขณะที่เซิร์ฟเวอร์นี้มีผลข้างเคียง (side effects) — มีการจัดเก็บข้อความของคุณและแสดงให้เจ้าหน้าที่เห็น — จึงควรถามความยินยอมจากผู้ใช้ก่อนที่จะเรียกใช้งาน
สิ่งที่ตัวแทนจะได้รับ
| เครื่องมือ | หน้าที่การทำงาน |
|---|---|
search_docs | ค้นหาแบบเต็มข้อความ (Full-text search) ในหน้าเอกสารประกอบ |
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 คีย์, ข้อมูลลับ, ข้อมูลส่วนบุคคล หรือข้อมูลบัญชีโดยเด็ดขาด: ไม่จำเป็นต้องมีบัญชี คำตอบจะถูกส่งไปยังผู้ที่ถือโทเคนเข้าถึง และด้วยเหตุผลเดียวกันนี้ คำตอบจะไม่มีข้อมูลส่วนตัวหรือข้อมูลเฉพาะของบัญชี สำหรับเรื่องใดก็ตามที่เชื่อมโยงกับบัญชีหรือคำสั่งซื้อเฉพาะ โปรดใช้ช่องทางสนับสนุนตามปกติ
ไม่มีการใช้เว็บฮุก (webhooks): คุณจะต้องดึงข้อมูลคำตอบด้วยตนเอง ไม่จำเป็นต้องมีบัญชี และช่องทางนี้มีการจำกัดอัตราการใช้งาน คำขอจะถูกบันทึกพร้อมที่อยู่ 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