NAVI Protocol MCP

Hướng dẫn sử dụng NAVI Protocol MCP

Giao diện dữ liệu và giải thích DeFi công khai dành cho các ứng dụng AI. Không cần khóa API, sẵn sàng sử dụng ngay, phù hợp cho truy vấn người dùng, nghiên cứu nội dung và tích hợp kỹ thuật.

Tóm tắt trong một câu

NAVI Protocol MCP là một dịch vụ Model Context Protocol mở. Nó đóng gói các khả năng phân tán trong hệ sinh thái NAVI Protocol – bao gồm cho vay, hoán đổi, cầu nối, DCA, kho lợi nhuận Volo Vault, tài sản ví và diễn giải giao dịch Sui – thành một bộ công cụ chuẩn hóa mà các ứng dụng AI có thể gọi trực tiếp.

Giá trị cốt lõi của nó không chỉ là "thêm một API nữa". Nó biến những thông tin thường đòi hỏi phải chuyển qua lại giữa các trang giao thức, trình khám phá khối và nhiều trang sản phẩm thành ngữ cảnh có cấu trúc mà AI có thể hiểu, kết hợp và giải thích. Người dùng chỉ cần đặt câu hỏi bằng ngôn ngữ tự nhiên, AI có thể gọi NAVI Protocol MCP để đưa ra câu trả lời gần với nhu cầu ra quyết định thực tế hơn.

Đối tượng sử dụng

• Người dùng phổ thông muốn nhanh chóng hiểu hệ sinh thái NAVI Protocol mà không cần kiểm tra thủ công nhiều trang
• Người dùng on-chain đã hoạt động trên Sui muốn AI trợ giúp diễn giải tài sản, vị thế, giao dịch và rủi ro
• Nhà phát triển, nhà nghiên cứu hoặc nhóm muốn có dịch vụ DeFi MCP công khai, miễn phí, không cần xác thực
• Người sáng tạo nội dung và nhà phân tích muốn AI xử lý việc truy xuất dữ liệu và diễn giải kết quả để họ tập trung vào phân tích và quyết định

Thông tin truy cập cốt lõi

Mục	Chi tiết
Điểm cuối	https://open-api.naviprotocol.io/api/mcp
Xác thực	Không cần khóa API
Chi phí	Miễn phí
Phương thức truyền tải khuyến nghị	Streamable HTTP
Giới hạn khả năng	Truy vấn và diễn giải chỉ đọc; không xử lý ký, ủy quyền hoặc thực thi giao dịch

Bắt đầu trong 3 phút

Tùy chọn A: Thêm trực tiếp trong ứng dụng hỗ trợ MCP từ xa

Nếu ứng dụng của bạn cung cấp các mục như Add MCP Server, Remote MCP hoặc HTTP MCP, bạn chỉ cần những thông tin sau:

• Tên máy chủ: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• Headers: để trống

Lưu và kết nối lại. Sau đó bạn có thể đặt câu hỏi trực tiếp trong chat mà không cần nhớ tên công cụ cụ thể.

Tùy chọn B: Ví dụ với Cursor

Nếu bạn sử dụng Cursor, hãy thêm máy chủ từ xa trong cấu hình MCP của bạn:

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

Sau khi cấu hình, làm mới danh sách MCP hoặc khởi động lại ứng dụng, sau đó đặt câu hỏi trực tiếp trong hộp chat.

Tùy chọn C: Ví dụ với Claude Code

Nếu bạn sử dụng Claude Code, bạn có thể thêm dịch vụ HTTP MCP qua dòng lệnh:

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

Tùy chọn D: Ví dụ với Codex

Nếu bạn sử dụng OpenAI Codex, hãy thêm máy chủ MCP trong config.toml toàn cục hoặc cấp dự án (ví dụ: ~/.codex/config.toml hoặc .codex/config.toml):

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

Bạn cũng có thể thêm nhanh qua CLI:

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

Sau khi thiết lập, sử dụng hai lời nhắc dưới đây để nhanh chóng xác minh kết nối:

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

Cách đặt câu hỏi tốt hơn

Người dùng thông thường không cần gọi công cụ thủ công. Cách tốt nhất là nói trực tiếp với AI về mục tiêu, đối tượng mục tiêu và định dạng đầu ra mong muốn của bạn.

Phong cách lời nhắc khuyến nghị

• 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.

Thói quen để có lời nhắc chất lượng cao hơn

• Chỉ định phong cách đầu ra, chẳng hạn như "giải thích bằng ngôn ngữ đơn giản" hoặc "tóm tắt theo định dạng báo cáo nghiên cứu"
• Chỉ định ràng buộc, chẳng hạn như "chỉ trích dẫn, không thực hiện giao dịch" hoặc "chỉ mạng chính Sui"
• Chỉ định ưu tiên, chẳng hạn như "tập trung vào rủi ro trước", "tập trung vào phần thưởng có thể nhận trước" hoặc "tập trung vào khả năng tiếp cận cầu nối trước"

Các khả năng công khai hiện có

Bảng dưới đây tóm tắt các khả năng chính hiện được NAVI Protocol MCP cung cấp và các lời nhắc ngôn ngữ tự nhiên ví dụ mà người dùng có thể hỏi trực tiếp.

Trường hợp sử dụng	Công cụ đại diện	Lời nhắc khuyến nghị
Tổng quan giao thức	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Phân tích pool cho vay	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Kiểm tra rủi ro	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Thông tin phần thưởng	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Ví và vị thế	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Cấu hình thị trường	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Thông tin token	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Báo giá hoán đổi	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Khám phá cầu nối	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Theo dõi cầu nối	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
Truy vấn DCA	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Tổng quan 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?
Phân tích 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?
Vị thế người dùng 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?
Giải thích giao dịch	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Mẫu khuyến nghị cho câu hỏi dựa trên địa chỉ

Nếu bạn sẵn sàng cung cấp địa chỉ Sui của mình, AI có thể tóm tắt thêm tài sản, vị thế, rủi ro và phần thưởng của bạn. Dưới đây là mẫu bạn có thể sao chép và sử dụng trực tiếp:

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.

Những yêu cầu này thường kết hợp các khả năng sau:

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

Nếu các truy vấn dựa trên địa chỉ đôi khi gặp giới hạn tốc độ hoặc timeout từ upstream, thử lại sau thường có hiệu quả.

Kiểm tra trực tiếp cho người dùng kỹ thuật

Nếu bạn muốn xác minh tính khả dụng của dịch vụ trong terminal trước, bạn có thể gửi trực tiếp các yêu cầu MCP. Ví dụ khởi tạo dưới đây sử dụng phiên bản giao thức 2025-06-18, đã được xác minh trong hướng dẫn này. Nếu ứng dụng của bạn tự động thương lượng phiên bản giao thức, không cần chỉ định thủ công.

1. Khởi tạo

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. Liệt kê công cụ

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. Gọi trực tiếp một công cụ

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": {}
    }
  }'

Mẹo sử dụng

• Nếu đây là lần đầu bạn tiếp xúc với DeFi, hãy yêu cầu AI giải thích kết quả bằng ngôn ngữ đơn giản thay vì xuất trực tiếp JSON thô.
• Nếu bạn muốn đánh giá xem một tài sản hoặc pool có đáng nghiên cứu sâu hơn không, hãy sử dụng lộ trình này trước: tổng quan giao thức -> tham số pool -> báo giá -> rủi ro.
• Nếu bạn không chắc về địa chỉ hợp đồng hoặc số thập phân của token, hãy tìm kiếm trực tiếp theo ký hiệu, ví dụ: Help me check DEEP token info.
• Nếu bạn dự định cung cấp địa chỉ của mình, hãy yêu cầu AI tóm tắt cùng lúc tài sản, vị thế và rủi ro để có kết quả đầy đủ và hiệu quả hơn.
• Nếu bạn chỉ muốn kiểm tra kết nối trước, hãy bắt đầu với lời nhắc không phụ thuộc vào địa chỉ ví, chẳng hạn như tổng quan giao thức, tham số pool SUI hoặc giải thích một giao dịch công khai.

Các giới hạn và lưu ý chung

• NAVI Protocol MCP hiện đóng vai trò là lớp truy vấn và diễn giải chỉ đọc. Nó không xử lý ký, ủy quyền hoặc thực thi giao dịch trực tiếp.
• Việc ứng dụng AI có hỗ trợ MCP từ xa, Streamable HTTP hay tự động thương lượng giao thức hay không phụ thuộc vào cách triển khai của chính ứng dụng đó.
• Các truy vấn dựa trên địa chỉ, lịch sử cầu nối hoặc một số khả năng tổng hợp có thể bị ảnh hưởng bởi trạng thái dịch vụ upstream, giới hạn tốc độ và timeout.
• Nếu bạn cần diễn giải thay vì dữ liệu thô, hãy yêu cầu AI tóm tắt, so sánh hoặc làm nổi bật rủi ro một cách rõ ràng trong lời nhắc của bạn.

Tại sao điều này quan trọng đối với trải nghiệm người dùng

Giá trị của NAVI Protocol MCP nằm ở chỗ nó hợp nhất nhiều khả năng on-chain vào một lớp truy cập duy nhất mà AI có thể gọi trực tiếp, giảm đáng kể tải nhận thức cho người dùng.

Luồng sử dụng truyền thống thường là:

• Kiểm tra một con số trên trang giao thức
• Theo dõi giao dịch trong trình khám phá khối
• Mở các trang khác để kiểm tra tuyến hoán đổi hoặc hỗ trợ cầu nối
• Tự ghép nối ngữ cảnh và đưa ra phán đoán

Với NAVI Protocol MCP, AI có thể trước tiên lấy dữ liệu có cấu trúc, sau đó kết hợp với câu hỏi của bạn để tạo ra câu trả lời gần với các tình huống quyết định thực tế hơn. Đối với người dùng, điều thực sự quan trọng không phải là bản thân các trường dữ liệu, mà là "tôi nên diễn giải dữ liệu này như thế nào ngay bây giờ?" Đây chính là nơi MCP mang lại giá trị lớn nhất ở cấp độ trải nghiệm sản phẩm.