NAVI Protocol MCP

NAVI Protocol MCP 사용자 가이드

AI 클라이언트를 위한 공개 DeFi 데이터 및 설명 인터페이스입니다. API 키가 필요 없으며, 바로 사용할 수 있고, 사용자 질의, 콘텐츠 리서치, 기술 통합에 적합합니다.

한 문장 요약

NAVI Protocol MCP는 개방형 모델 컨텍스트 프로토콜 서비스입니다. 대출, 스왑, 브리징, DCA, Volo Vault 수익 금고, 지갑 자산, Sui 트랜잭션 해석 등 NAVI Protocol 생태계 전반에 흩어진 기능들을 AI 클라이언트가 직접 호출할 수 있는 표준화된 도구 모음으로 패키징합니다.

핵심 가치는 단순한 "API 하나 더"가 아닙니다. 일반적으로 프로토콜 페이지, 블록 탐색기, 여러 제품 페이지를 오가며 확인해야 하는 정보를 AI가 이해하고, 조합하고, 설명할 수 있는 구조화된 컨텍스트로 전환합니다. 사용자는 자연어로 질문하기만 하면, AI가 NAVI Protocol MCP를 호출하여 실제 의사 결정에 더 가까운 답변을 생성할 수 있습니다.

대상 사용자

• 여러 페이지를 수동으로 확인하지 않고 NAVI Protocol 생태계를 빠르게 이해하려는 일반 사용자
• 자산, 포지션, 트랜잭션, 위험 해석에 AI 도움을 받고자 하는 Sui 온체인 활동 사용자
• 공개적이고 무료이며 인증이 필요 없는 DeFi MCP 서비스를 원하는 개발자, 연구자, 팀
• 데이터 검색과 결과 해석을 AI에 맡겨 분석과 의사 결정에 집중하려는 콘텐츠 제작자 및 분석가

핵심 접근 정보

항목	세부 사항
엔드포인트	https://open-api.naviprotocol.io/api/mcp
인증	API 키 불필요
비용	무료
권장 전송 방식	Streamable HTTP
기능 범위	읽기 전용 조회 및 해석, 서명, 권한 부여, 트랜잭션 실행은 처리하지 않음

3분 안에 시작하기

옵션 A: 원격 MCP를 지원하는 클라이언트에서 직접 추가

클라이언트가 Add MCP Server, Remote MCP, HTTP MCP 같은 항목을 제공한다면, 다음 정보만 있으면 됩니다.

• 서버 이름: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• 헤더: 비워 둠

저장 후 다시 연결하세요. 그러면 특정 도구 이름을 외우지 않고도 채팅에서 바로 질문할 수 있습니다.

옵션 B: Cursor 사용 예시

Cursor를 사용한다면, MCP 설정에 원격 서버를 추가하세요.

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

설정 후 MCP 목록을 새로고침하거나 클라이언트를 재시작한 다음, 채팅창에서 바로 질문하세요.

옵션 C: Claude Code 사용 예시

Claude Code를 사용한다면, 명령줄을 통해 HTTP MCP 서비스를 추가할 수 있습니다.

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

옵션 D: Codex 사용 예시

OpenAI Codex를 사용한다면, 글로벌 또는 프로젝트 수준의 config.toml (예: ~/.codex/config.toml 또는 .codex/config.toml)에 MCP 서버를 추가하세요.

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

CLI를 통해 빠르게 추가할 수도 있습니다.

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

설정 후, 다음 두 프롬프트로 연결 상태를 빠르게 확인하세요.

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

더 나은 질문 방법

일반 사용자는 도구를 수동으로 호출할 필요가 없습니다. 가장 좋은 방법은 AI에게 목표, 대상 객체, 선호하는 출력 형식을 직접 알려주는 것입니다.

권장 프롬프트 스타일

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

더 높은 품질의 프롬프트를 위한 습관

• "쉬운 말로 설명해 줘" 또는 "리서치 리포트 형식으로 요약해 줘"와 같이 출력 스타일을 지정하세요.
• "인용만 하고 거래는 실행하지 마" 또는 "Sui 메인넷만"과 같이 제약 조건을 지정하세요.
• "위험에 먼저 집중해 줘", "청구 가능한 보상에 먼저 집중해 줘", "브리지 연결 가능성에 먼저 집중해 줘"와 같이 우선순위를 지정하세요.

현재 이용 가능한 공개 기능

아래 표는 NAVI Protocol MCP가 현재 제공하는 주요 기능과 사용자가 직접 질문할 수 있는 자연어 프롬프트 예시를 요약한 것입니다.

사용 사례	대표 도구	권장 프롬프트
프로토콜 개요	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
대출 풀 분석	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
위험 점검	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
보상 정보	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
지갑 및 포지션	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
시장 설정	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
토큰 정보	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
스왑 견적	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
브리지 탐색	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
브리지 추적	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
DCA 조회	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
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?
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?
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?
트랜잭션 설명	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

주소 기반 질문을 위한 권장 템플릿

Sui 주소를 제공할 의향이 있다면, AI가 자산, 포지션, 위험, 보상을 더 잘 요약해 줄 수 있습니다. 다음은 복사하여 바로 사용할 수 있는 템플릿입니다.

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.

이러한 요청은 보통 다음 기능들을 결합합니다.

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

주소 기반 쿼리에서 업스트림 속도 제한이나 타임아웃이 간헐적으로 발생하면, 보통 나중에 다시 시도하면 해결됩니다.

기술 사용자를 위한 직접 테스트

터미널에서 먼저 서비스 가용성을 확인하려면 MCP 요청을 직접 보낼 수 있습니다. 아래 초기화 예시는 프로토콜 버전 2025-06-18을 사용하며, 이 가이드에서 검증되었습니다. 클라이언트가 프로토콜 버전을 자동으로 협상한다면 수동 지정은 필요하지 않습니다.

1. 초기화

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. 도구 목록 조회

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. 도구 직접 호출

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

사용 팁

• DeFi가 처음이라면, AI에게 원시 JSON을 직접 출력하는 대신 결과를 쉬운 말로 설명해 달라고 요청하세요.
• 자산이나 풀이 심층 리서치할 가치가 있는지 평가하려면, 프로토콜 개요 -> 풀 매개변수 -> 견적 -> 위험 순서로 진행하세요.
• 토큰의 컨트랙트 주소나 소수점 자릿수를 잘 모르겠다면, 심볼로 직접 검색하세요. 예: Help me check DEEP token info.
• 자신의 주소를 제공할 계획이라면, AI에게 자산, 포지션, 위험을 함께 요약해 달라고 요청하여 더 풍부하고 효율적인 결과를 얻으세요.
• 먼저 연결 상태만 테스트하려면, 프로토콜 개요, SUI 풀 매개변수, 공개 트랜잭션 설명 등 지갑 주소에 의존하지 않는 프롬프트로 시작하세요.

일반적인 경계 및 참고 사항

• NAVI Protocol MCP는 현재 읽기 전용 조회 및 해석 계층으로 작동합니다. 서명, 권한 부여, 직접적인 거래 실행은 처리하지 않습니다.
• AI 클라이언트가 Remote MCP, Streamable HTTP, 자동 프로토콜 협상을 지원하는지 여부는 클라이언트 자체 구현에 달려 있습니다.
• 주소 기반 쿼리, 브리지 이력, 일부 집계 기능은 업스트림 서비스 상태, 속도 제한, 타임아웃의 영향을 받을 수 있습니다.
• 원시 데이터보다 해석이 필요하다면, 프롬프트에서 AI에게 요약, 비교, 위험 강조를 명시적으로 요청하세요.

사용자 경험에 중요한 이유

NAVI Protocol MCP의 가치는 여러 온체인 기능을 AI가 직접 호출할 수 있는 단일 접근 계층으로 통합하여 사용자의 인지 부하를 크게 줄인다는 점입니다.

기존의 일반적인 사용 흐름은 다음과 같습니다.

• 프로토콜 페이지에서 숫자 확인
• 블록 탐색기에서 트랜잭션 추적
• 스왑 경로나 브리지 지원을 확인하기 위해 다른 페이지 열기
• 수동으로 컨텍스트를 조합하고 판단

NAVI Protocol MCP를 사용하면, AI가 먼저 구조화된 데이터를 가져온 다음, 이를 사용자 질문과 결합하여 실제 의사 결정 시나리오에 더 가까운 답변을 생성할 수 있습니다. 사용자에게 진정 중요한 것은 필드 자체가 아니라 "지금 이 데이터를 어떻게 해석해야 하는가?"입니다. 바로 이 지점에서 MCP가 제품 경험 수준에서 가장 큰 가치를 제공합니다.