AI 에이전트로 거래하기
jv에는 MCP 서버 jv mcp가 내장되어 있습니다. stdio 모드로 동작하며 서버 이름은 jasper-vault입니다. AI 클라이언트를 연결하면 에이전트가 MCP 도구를 호출하고, 각 도구는 이 컴퓨터에서 해당하는 jv 명령을 실행합니다. 서명에는 같은 로컬 권한 부여가 사용됩니다.
시작하기 전에
섹션 제목: “시작하기 전에”- jv CLI 설치.
- 먼저 자신의 터미널에서
jv enable을 실행해 권한 부여를 완료하는 것을 권장합니다. 에이전트도wallet_setup도구로 권한 부여를 시작할 수 있지만, 아래 설명대로 MCP 설정에BASE_HTTP_RPC_URL을 지정해야 합니다.
스킬 및 MCP 설정 설치: jv install
섹션 제목: “스킬 및 MCP 설정 설치: jv install”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
섹션 제목: “Claude Code”설치 후 Claude Code에서 /mcp를 입력해 목록에 jasper-vault가 있는지 확인하십시오. 없으면 Claude Code 자체 명령으로 등록합니다.
Cursor
섹션 제목: “Cursor”jv install은 ~/.cursor/mcp.json에 다음 내용을 추가합니다.
OpenClaw
섹션 제목: “OpenClaw”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:
Cursor: ~/.cursor/mcp.json의 jasper-vault 아래에 env 항목을 추가합니다.
자신의 터미널에서만 권한 부여와 출금을 한다면 이 단계는 필요하지 않습니다.
MCP 도구
섹션 제목: “MCP 도구”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로 포지션이 종료되었고 새로 열린 반대 방향 포지션이 없는지 확인하십시오. 이유는 명령줄로 거래하기의 ‘포지션 추가, 축소 및 종료’ 섹션을 참고하십시오. - 위임 키로 할 수 있는 일과 할 수 없는 일은 트레이더 연동 개요를 참고하십시오.