NAVI Protocol MCP

Panduan Pengguna NAVI Protocol MCP

Antarmuka data dan penjelasan DeFi publik untuk klien AI. Tidak memerlukan kunci API, siap pakai langsung, dan cocok untuk kueri pengguna, riset konten, serta integrasi teknis.

Dalam Satu Kalimat

NAVI Protocol MCP adalah layanan Model Context Protocol terbuka. Layanan ini mengemas kemampuan yang tersebar di seluruh ekosistem NAVI Protocol—termasuk peminjaman, penukaran, bridging, DCA, vault hasil Volo Vault, aset dompet, dan interpretasi transaksi Sui—menjadi seperangkat alat terstandarisasi yang dapat dipanggil langsung oleh klien AI.

Nilai intinya bukan sekadar "satu API lagi." Layanan ini mengubah informasi yang biasanya memerlukan perpindahan antara halaman protokol, penjelajah blok, dan beberapa halaman produk menjadi konteks terstruktur yang dapat dipahami, digabungkan, dan dijelaskan oleh AI. Pengguna cukup mengajukan pertanyaan dalam bahasa alami, dan AI dapat memanggil NAVI Protocol MCP untuk menghasilkan jawaban yang lebih mendekati kebutuhan pengambilan keputusan nyata.

Untuk Siapa Ini

• Pengguna sehari-hari yang ingin memahami ekosistem NAVI Protocol dengan cepat tanpa memeriksa banyak halaman secara manual
• Pengguna on-chain yang sudah aktif di Sui dan menginginkan bantuan AI untuk menafsirkan aset, posisi, transaksi, dan risiko
• Pengembang, peneliti, atau tim yang menginginkan layanan MCP DeFi publik, gratis, tanpa autentikasi
• Kreator konten dan analis yang ingin AI menangani pengambilan data dan interpretasi hasil sehingga mereka dapat fokus pada analisis dan keputusan

Informasi Akses Inti

Item	Detail
Endpoint	https://open-api.naviprotocol.io/api/mcp
Autentikasi	Tidak memerlukan kunci API
Biaya	Gratis
Transport yang direkomendasikan	HTTP Streamable
Batasan kemampuan	Kueri dan interpretasi hanya-baca; tidak menangani penandatanganan, otorisasi, atau eksekusi transaksi

Mulai dalam 3 Menit

Opsi A: Tambahkan Langsung di Klien yang Mendukung MCP Jarak Jauh

Jika klien Anda menyediakan entri seperti Add MCP Server, Remote MCP, atau HTTP MCP, Anda hanya memerlukan hal berikut:

• Nama Server: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• Header: kosongkan

Simpan dan sambungkan kembali. Kemudian Anda dapat mengajukan pertanyaan langsung di obrolan tanpa perlu menghafal nama alat tertentu.

Opsi B: Contoh dengan Cursor

Jika Anda menggunakan Cursor, tambahkan server jarak jauh di konfigurasi MCP Anda:

{
  "mcpServers": {
    "navi-protocol": {
      "url": "https://open-api.naviprotocol.io/api/mcp"
    }
  }
}

Setelah konfigurasi, segarkan daftar MCP atau mulai ulang klien, lalu ajukan pertanyaan langsung di kotak obrolan.

Opsi C: Contoh dengan Claude Code

Jika Anda menggunakan Claude Code, Anda dapat menambahkan layanan MCP HTTP melalui baris perintah:

claude mcp add --transport http navi-protocol https://open-api.naviprotocol.io/api/mcp

Opsi D: Contoh dengan Codex

Jika Anda menggunakan OpenAI Codex, tambahkan server MCP di config.toml global atau tingkat proyek (misalnya, ~/.codex/config.toml atau .codex/config.toml):

[mcp_servers.navi-protocol]
url = "https://open-api.naviprotocol.io/api/mcp"

Anda juga dapat menambahkannya dengan cepat melalui CLI:

codex mcp add navi-protocol --url https://open-api.naviprotocol.io/api/mcp

Setelah pengaturan, gunakan dua prompt di bawah ini untuk memverifikasi konektivitas dengan cepat:

• Please explain in plain language what capabilities NAVI Protocol mainly supports right now.
• Please list NAVI's major lending pools.

Cara Mengajukan Pertanyaan yang Lebih Baik

Pengguna biasa tidak perlu memanggil alat secara manual. Cara terbaik adalah memberi tahu AI tujuan Anda, objek target, dan format keluaran yang diinginkan secara langsung.

Gaya Prompt yang Direkomendasikan

• Please introduce NAVI Protocol's current overall status in non-technical language.
• I want to see the key parameters of the SUI lending pool. Please explain them to me.
• If I swap 1 SUI to USDC, roughly how much would I get? Quote only, do not execute any transaction.
• Help me check DEEP's contract address, decimals, and current price.
• Which chains are currently supported by NAVI Astros Bridge? Can USDC on Sui be bridged?
• Help me explain what happened in this Sui transaction: 2aWS5J9i4SxW3DVfKheR9Sdx6iMKPW6vfka56v5tuTSw
• What Volo Vault yield vaults are available right now? Which one has the highest APY?
• This is my Sui address: <YOUR_SUI_ADDRESS>. Please summarize my assets, positions, and risks.

Kebiasaan untuk Prompt Berkualitas Lebih Tinggi

• Tentukan gaya keluaran, seperti "jelaskan dengan bahasa sederhana" atau "ringkas dalam format laporan riset"
• Tentukan batasan, seperti "hanya kutipan, jangan eksekusi perdagangan" atau "hanya Sui mainnet"
• Tentukan prioritas, seperti "fokus pada risiko terlebih dahulu," "fokus pada hadiah yang dapat diklaim terlebih dahulu," atau "fokus pada jangkauan bridge terlebih dahulu"

Kemampuan Publik yang Tersedia Saat Ini

Tabel di bawah ini merangkum kemampuan utama yang saat ini diekspos oleh NAVI Protocol MCP dan contoh prompt bahasa alami yang dapat diajukan pengguna secara langsung.

Kasus Penggunaan	Alat Representatif	Prompt yang Direkomendasikan
Gambaran protokol	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Analisis pool peminjaman	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Pemeriksaan risiko	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Informasi hadiah	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Dompet dan posisi	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Konfigurasi pasar	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Informasi token	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Kutipan swap	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Penemuan bridge	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Pelacakan bridge	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
Kueri DCA	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Gambaran Volo Vault	volo_get_vaults, volo_get_vault, volo_get_vault_system_summary	What Volo Vault yield vaults are available? What is the overall TVL and revenue?
Analitik Volo Vault	volo_get_vault_apy_history, volo_get_vault_share_price_history, volo_get_vault_tvl_history, volo_get_vault_total_tvl_history	How has this Volo Vault's APY trended over the past month?
Posisi pengguna Volo Vault	volo_get_vault_user_positions, volo_get_vault_user_status, volo_get_vault_user_transactions	How much has this address staked in Volo Vault? What are the earnings?
Penjelasan transaksi	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Template yang Direkomendasikan untuk Pertanyaan Berbasis Alamat

Jika Anda bersedia memberikan alamat Sui Anda, AI dapat lebih lanjut merangkum aset, posisi, risiko, dan hadiah Anda. Berikut adalah template yang dapat Anda salin dan gunakan langsung:

This is my Sui address: <YOUR_SUI_ADDRESS>.
Please help me with the following 5 things:
1. Summarize what assets I currently hold;
2. Summarize my positions in NAVI and other protocols;
3. If my health factor has risk, warn me directly;
4. Tell me whether I have any unclaimed rewards;
5. Summarize my Volo Vault positions and earnings.

Permintaan ini biasanya menggabungkan kemampuan berikut:

• navi_get_coins
• get_positions
• navi_get_health_factor
• navi_get_available_rewards
• volo_get_vault_user_positions
• volo_get_vault_user_status

Jika kueri berbasis alamat sesekali terkena batas laju atau waktu habis dari upstream, mencoba lagi nanti biasanya berhasil.

Pengujian Langsung untuk Pengguna Teknis

Jika Anda ingin memverifikasi ketersediaan layanan di terminal terlebih dahulu, Anda dapat mengirim permintaan MCP secara langsung. Contoh inisialisasi di bawah ini menggunakan versi protokol 2025-06-18, yang telah diverifikasi dalam panduan ini. Jika klien Anda secara otomatis menegosiasikan versi protokol, spesifikasi manual tidak diperlukan.

1. Inisialisasi

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {
        "name": "demo-client",
        "version": "1.0.0"
      }
    }
  }'

2. Daftar Alat

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

3. Panggil Alat Secara Langsung

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "navi_get_protocol_stats",
      "arguments": {}
    }
  }'

Tips Penggunaan

• Jika ini pertama kalinya Anda dengan DeFi, minta AI untuk menjelaskan hasil dalam bahasa sederhana alih-alih langsung mengeluarkan JSON mentah.
• Jika Anda ingin mengevaluasi apakah suatu aset atau pool layak untuk riset lebih dalam, gunakan jalur ini terlebih dahulu: gambaran protokol -> parameter pool -> kutipan -> risiko.
• Jika Anda tidak yakin tentang alamat kontrak atau desimal token, cari berdasarkan simbol secara langsung, misalnya: Help me check DEEP token info.
• Jika Anda berencana memberikan alamat Anda sendiri, minta AI untuk merangkum aset, posisi, dan risiko bersama-sama untuk hasil yang lebih lengkap dan efisien.
• Jika Anda hanya ingin menguji konektivitas terlebih dahulu, mulailah dengan prompt yang tidak bergantung pada alamat dompet, seperti gambaran protokol, parameter pool SUI, atau penjelasan transaksi publik.

Batasan dan Catatan Umum

• NAVI Protocol MCP saat ini berfungsi sebagai lapisan kueri dan interpretasi hanya-baca. Ini tidak menangani penandatanganan, otorisasi, atau eksekusi perdagangan langsung.
• Apakah klien AI mendukung MCP Jarak Jauh, HTTP Streamable, atau negosiasi protokol otomatis bergantung pada implementasi klien itu sendiri.
• Kueri berbasis alamat, riwayat bridge, atau beberapa kemampuan agregat mungkin terpengaruh oleh status layanan upstream, batas laju, dan waktu habis.
• Jika Anda memerlukan interpretasi daripada data mentah, secara eksplisit minta AI untuk merangkum, membandingkan, atau menyoroti risiko dalam prompt Anda.

Mengapa Ini Penting untuk Pengalaman Pengguna

Nilai NAVI Protocol MCP adalah menyatukan berbagai kemampuan on-chain ke dalam satu lapisan akses yang dapat dipanggil langsung oleh AI, secara signifikan mengurangi beban kognitif pengguna.

Alur penggunaan tradisional sering kali:

• Memeriksa angka di halaman protokol
• Melacak transaksi di penjelajah blok
• Membuka halaman lain untuk memeriksa rute swap atau dukungan bridge
• Merangkai konteks secara manual dan membuat penilaian

Dengan NAVI Protocol MCP, AI dapat terlebih dahulu mengambil data terstruktur, lalu menggabungkannya dengan pertanyaan Anda untuk menghasilkan jawaban yang lebih mendekati skenario keputusan nyata. Bagi pengguna, yang benar-benar penting bukanlah bidang itu sendiri, tetapi "bagaimana saya harus menafsirkan data ini saat ini?" Di sinilah MCP memberikan nilai paling besar pada tingkat pengalaman produk.