MCP sunucusu

NETTS, dokümantasyonunu bir MCP sunucusu olarak yayımlar; böylece bir yapay zekâ aracısı tahmin yürütmek veya 700 KB'lık bir metin yığınıyla beslenmek yerine bu belgeleri ve API belirtiminin kendisini doğrudan arayabilir.

https://doc.netts.io/mcp

Sunucu salt okunurdur. Hesabınız, anahtarlarınız veya bakiyeniz hakkında hiçbir şey bilmez — yalnızca bu sitede yayımlananları bilir.

İkinci, ayrı bir sunucu ise yapay zekâ aracıları için NETTS'e doğrudan bir hat niteliğindedir:

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

Yalnızca dokümantasyon hakkında değil. Hizmetin gerçekte nasıl davrandığını, bir uç noktanın gerçekte ne döndürdüğünü, TRON Energy, Bandwidth, delegasyon ve staking işlemlerinin pratikte nasıl çalıştığını, TRC-20 ve diğer akıllı sözleşmelerle nasıl etkileşim kurulacağını sorun. Hataları bildirin, özellikler önerin, güvenlik endişelerini dile getirin. Bir insan bunu okur ve yanıtı yazar.

Tek bir sunucu yerine iki sunucu olması kasıtlı bir tercihtir. Dokümantasyon sunucusu salt okunur kalır, böylece bir ana makine modelin belgeleri serbestçe aramasına izin verebilir; bu sunucunun ise yan etkileri vardır — metninizi depolar ve insanlara gösterir — bu nedenle çağrılmadan önce kullanıcıya danışmalıdır.

Aracının edindikleri

Araç	Ne yapar
search_docs	Dokümantasyon sayfaları üzerinde tam metin araması
get_doc	Bir sayfanın tam Markdown içeriği
list_docs	Tüm sayfaların dizini
search_api	NETTS API v2 operasyonlarını arama
get_endpoint	Bir operasyonun parametreleri, şemaları, yanıtları ve hata kodları
get_openapi_schema	Belirtimden yeniden kullanılabilir bir şema

Blog kasıtlı olarak dizine eklenmemiştir: bunlar insanlar için yazılmış makalelerdir ve bir aracı için yalnızca gürültü niteliğindedir.

NETTS'e sorma

Dokümantasyonun açıklığa kavuşturmadığı her şey. Bir insan bunu okur ve yanıtı yazar; hiçbir şey yapay zekâ tarafından üretilmez ve gönderdiğiniz hiçbir şey hizmeti veya dokümantasyonu tek başına değiştirmez.

Araç	Ne yapar
ask_netts	NETTS personeline bir soru, rapor veya öneri gönderir; feedback_id ve access_token döndürür
get_answer	Durumu ve yazıldıktan sonra yanıtı döndürür

Mesajın doğru kişiye ulaşması için bir kind seçin:

kind	Kullanım amacı
question	Hizmetin nasıl çalıştığı, bir uç noktanın gerçekte ne döndürdüğü, TRON Energy ve Bandwidth, delegasyon, staking, TRC-20 ve diğer sözleşmeler
documentation_error	Bir sayfada bir şeylerin yanlış olması
missing_information	Önemli bir konunun hiç belgelenmemiş olması
suggestion	Hizmeti veya API'yi geliştirmeye yönelik bir fikir
security	Bir güvenlik endişesi veya bir öneri

Nasıl çalışır:

1. Mesajınız, rastgele bir idempotency_key ve soru belirli bir sayfa ya da operasyonla ilgili olduğunda doc_path veya operation_id ile ask_netts aracını çağırın. Bunlar yayımlanan sürüme göre doğrulanır, bu nedenle dokümantasyon sunucusunun size verdiği değerleri kullanın; genel sorular için bunları boş bırakın.
2. Geriye bir feedback_id, bir access_token, tahmini bir yanıt süresi ve poll_after_seconds alırsınız. Belirteci saklayın: yanıta ulaşmanın tek anahtarı odur.
3. Daha sonra get_answer ile tekrar kontrol edin. Bir insan yanıtlayana kadar durum new veya in_review olarak kalır.

Aynı idempotency_key değerini aynı gövdeyle yeniden göndermek, ikinci bir kayıt oluşturmak yerine aynı kaydı döndürür; böylece bağlantı kopması bir kayba yol açmaz.

Çağırmadan önce. Metin NETTS'teki insanlara iletilir. Önce kullanıcıya danışın ve kesinlikle API anahtarlarını, gizli bilgileri, kişisel verileri veya hesap verilerini dahil etmeyin: hesap gerekmez, yanıt erişim belirtecini elinde bulunduran kişiye gider ve aynı nedenden ötürü bir yanıt asla özel veya hesaba özgü bilgiler içermez. Belirli bir hesaba veya siparişe bağlı herhangi bir konu için normal destek kanallarını kullanın.

Webhook yoktur: yanıtı kendiniz alırsınız. Hesap gerekmez ve kanal hız sınırlamasına tabidir. Kötüye kullanımı önlemek için istekler IP adresiyle birlikte kaydedilir; kayıtlar 90 gün saklanır.

Bağlanma

Cursor ve VS Code — herhangi bir dokümantasyon sayfasının üst kısmındaki menüde bulunan Connect to Cursor ve Connect to VS Code öğelerini kullanın. Sunucuyu tek bir tıklamayla kurarlar.

Claude Code

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

Diğer her şey — aktarım Streamable HTTP protokolüdür, kimlik doğrulama yoktur. Her iki sunucuyu da ekleyin: dokümantasyon sunucusu ve soru sorabilmek istiyorsanız geri bildirim sunucusu.

{
  "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 için ikincisi şudur:

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

MCP olmadan

Aracınız MCP protokolünü desteklemiyorsa, aynı içerik düz dosyalar olarak da mevcuttur:

• /llms.txt — dokümantasyonun yapılandırılmış dizini
• /llms-full.txt — tüm dokümantasyon tek bir dosyada
• /openapi.yaml — API belirtimi
• sonuna .md eklenmiş herhangi bir sayfa, örneğin /api/v2/endpoints/order1h.md