콘텐츠로 이동

AI 에이전트로 거래하기

jv에는 MCP 서버 jv mcp가 내장되어 있습니다. stdio 모드로 동작하며 서버 이름은 jasper-vault입니다. AI 클라이언트를 연결하면 에이전트가 MCP 도구를 호출하고, 각 도구는 이 컴퓨터에서 해당하는 jv 명령을 실행합니다. 서명에는 같은 로컬 권한 부여가 사용됩니다.

  1. jv CLI 설치.
  2. 먼저 자신의 터미널에서 jv enable을 실행해 권한 부여를 완료하는 것을 권장합니다. 에이전트도 wallet_setup 도구로 권한 부여를 시작할 수 있지만, 아래 설명대로 MCP 설정에 BASE_HTTP_RPC_URL을 지정해야 합니다.
jv install --ai claude            # Claude Code, skill을 현재 디렉터리에 설치
jv install --ai claude --global   # Claude Code, skill을 사용자 디렉터리에 설치
jv install --ai cursor            # Cursor, skill을 현재 디렉터리에 설치
jv install --ai cursor --global   # Cursor, skill을 사용자 디렉터리에 설치
jv install --ai openclaw          # OpenClaw
jv install                        # 세 플랫폼 모두에 설치, skill은 사용자 디렉터리에 설치

jv install은 스킬(에이전트에게 이 도구들의 사용법을 알려 주는 파일)을 설치하고, Claude Code와 Cursor에는 MCP 설정도 작성합니다.

플랫폼 스킬 위치 MCP 설정
Claude Code .claude/skills/jasper-vault-cli/, --global을 붙이면 ~/.claude/skills/jasper-vault-cli/ ~/.claude/settings.json의 mcpServers에 작성
Cursor .cursor/skills/jasper-vault-cli/, --global을 붙이면 ~/.cursor/skills/jasper-vault-cli/ ~/.cursor/mcp.json의 mcpServers에 작성
OpenClaw ~/.openclaw/skills/jasper-vault-cli/ 작성하지 않음
  • MCP 설정은 항상 사용자 디렉터리에 작성되며, --global은 스킬을 설치할 위치만 결정합니다.
  • 대상 위치에 이미 스킬이 있으면 오류가 발생하며, --force를 붙이면 덮어씁니다. CLI를 업그레이드한 뒤에는 --force를 붙여 다시 한 번 설치해 스킬을 새 버전과 맞추는 것을 권장합니다.
  • 설치 후 AI 클라이언트를 다시 시작하십시오.
  • 제거하려면 jv uninstall --ai claude(또는 cursor, openclaw, all)를 사용합니다. 스킬을 사용자 디렉터리에 설치했다면 제거할 때도 --global을 붙여야 합니다.

설치 후 Claude Code에서 /mcp를 입력해 목록에 jasper-vault가 있는지 확인하십시오. 없으면 Claude Code 자체 명령으로 등록합니다.

claude mcp add --scope user --transport stdio jasper-vault -- jv mcp

jv install은 ~/.cursor/mcp.json에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "jasper-vault": { "command": "jv", "args": ["mcp"] }
  }
}

jv install --ai openclaw는 스킬만 설치하고 MCP 설정은 작성하지 않습니다. 스킬은 에이전트가 jasper-vault의 MCP 도구로 거래하도록 요구하므로, OpenClaw의 방식에 따라 jv mcp를 jasper-vault라는 이름의 MCP 서버로 등록해야 합니다.

에이전트가 권한 부여와 출금을 시작하게 하기

섹션 제목: “에이전트가 권한 부여와 출금을 시작하게 하기”

wallet_setup(권한 부여)과 withdraw_via_browser(출금) 두 도구는 실행할 때 BASE_HTTP_RPC_URL이 필요합니다. MCP 서버는 jv 명령을 실행할 때 자신의 환경 변수를 넘겨주므로, 이 변수를 MCP 설정에 작성해야 합니다.

Claude Code:

claude mcp add --scope user -e BASE_HTTP_RPC_URL=https://mainnet.base.org --transport stdio jasper-vault -- jv mcp

Cursor: ~/.cursor/mcp.json의 jasper-vault 아래에 env 항목을 추가합니다.

{
  "mcpServers": {
    "jasper-vault": {
      "command": "jv",
      "args": ["mcp"],
      "env": { "BASE_HTTP_RPC_URL": "https://mainnet.base.org" }
    }
  }
}

자신의 터미널에서만 권한 부여와 출금을 한다면 이 단계는 필요하지 않습니다.

jv mcp는 17개의 도구를 제공합니다.

분류 도구 대응 명령
거래 create_order jv order create
거래 close_position jv order close
거래 protect_order jv order protect
거래 set_take_profit jv tp set
거래 set_stop_loss jv sl set
조회 list_orders jv orders list
조회 get_order jv orders get
조회 get_order_stats jv orders stats
조회 get_price jv price
조회 get_job_status jv job status
지정가 주문 list_limit_orders jv limit-order list
지정가 주문 get_limit_order_status jv limit-order status
지정가 주문 cancel_limit_order jv limit-order cancel
지갑 및 자금 wallet_setup jv enable
지갑 및 자금 deposit_via_browser jv deposit
지갑 및 자금 withdraw_via_browser jv withdraw
기타 check_update CLI에 새 버전이 있는지 확인
  • MCP에는 시장 목록을 나열하는 도구도, 지갑 정보를 조회하는 도구도 없습니다. 지시할 때는 JVBTC처럼 심볼을 직접 적으십시오. 전체 목록은 jv market list로 확인합니다. 지정가 주문을 조회할 때는 지갑 주소를 제공해야 하며, jv wallet info의 eoa를 사용할 수 있습니다.
  • 일반 도구는 최대 90초 동안 실행됩니다. wallet_setup, deposit_via_browser, withdraw_via_browser는 브라우저에서 서명을 완료할 때까지 최대 16분 동안 실행됩니다.
  • CLI에 새 버전이 있으면 도구 결과 끝에 업그레이드 안내가 한 줄 추가됩니다.
이렇게 말하면 에이전트가 호출하는 도구
JVBTC 지금 얼마예요? get_price
증거금 100 JVUSD, 20배 레버리지로 JVBTC 롱 포지션을 시장가로 열어 주세요 create_order
JVBTC 60000에 지정가 롱 주문을 걸어 주세요. 증거금 50, 10배 레버리지, 2시간 유효 create_order, 지정가와 유효 기간 포함
주문 42에 PPO 보호를 추가해 주세요. OTM 3단계, 8시간 protect_order
주문 43은 숏 포지션이에요. 익절 58000, 손절 66000 set_take_profit, set_stop_loss, 방향은 숏
지금 제 포지션을 보여 주세요 list_orders
주문 42를 종료해 주세요 / 전체 포지션을 종료해 주세요 close_position
Base에서 200 USDC를 입금해 주세요 deposit_via_browser, URL을 반환하며 웹 페이지에서 지갑으로 서명
  • 별도의 지갑을 사용하고, 거래할 자금만 넣어 두십시오.
  • AI 클라이언트에서 주문, 포지션 종료, 출금 관련 도구의 호출 확인을 유지하고, 자동 승인으로 설정하지 마십시오. 확인하기 전에 방향, 심볼, 증거금, 레버리지를 꼼꼼히 확인하십시오.
  • 에이전트가 ~/.jaspervault/ 아래의 파일을 읽거나 표시하거나 업로드하지 못하게 하고, 키 파일 내용을 대화에 붙여 넣지 마십시오.
  • 에이전트가 권한 부여, 입금 또는 출금 URL을 제공하면, 지갑에서 서명하기 전에 금액, 주소, 만료 시각 등 서명 내용을 확인하십시오.
  • 같은 에이전트가 출처가 불분명한 웹 페이지나 문서를 읽으면서 동시에 주문 도구를 갖고 있지 않도록 하십시오. 콘텐츠에 숨겨진 지시가 에이전트를 유도해 주문하게 할 수 있습니다.
  • 주문은 "status": "completed"(시장가 주문, 보호 추가) 또는 limitOrderId(지정가 주문, 익절·손절 주문)가 반환되어야 명확한 성공입니다. timeout, failed 또는 네트워크 오류가 반환되면 주문이 이미 체결되었을 수 있으므로, 먼저 list_orders와 list_limit_orders로 결과를 확인한 뒤 다시 주문할지 결정하십시오.
  • 축소한 적이 있는 포지션은 close_position으로 종료하면 종료 후 반대 방향 포지션이 열릴 수 있으므로, 웹에서 종료하는 것을 권장합니다. close_position으로 종료한 후에는 list_orders로 포지션이 종료되었고 새로 열린 반대 방향 포지션이 없는지 확인하십시오. 이유는 명령줄로 거래하기의 ‘포지션 추가, 축소 및 종료’ 섹션을 참고하십시오.
  • 위임 키로 할 수 있는 일과 할 수 없는 일은 트레이더 연동 개요를 참고하십시오.