コンテンツにスキップ

AI エージェントで取引する

jv には MCP サーバー jv mcp が組み込まれています。stdio モードで動作し、サーバー名は jasper-vault です。AI クライアントを接続すると、エージェントが MCP ツールを呼び出し、各ツールがローカルで対応する jv コマンドを実行します。署名には同じローカルの認可が使われます。

  1. jv CLI をインストールします。
  2. まずご自身のターミナルで jv enable を実行して認可を完了しておくことをおすすめします。エージェントから wallet_setup ツールで認可を開始することもできますが、その場合は後述のとおり MCP 設定で BASE_HTTP_RPC_URL を設定する必要があります。

スキルと MCP 設定のインストール:jv install

Section titled “スキルと MCP 設定のインストール:jv install”
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                        # 3 つのプラットフォームすべてに、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 サーバーとして登録する必要もあります。

エージェントに認可と出金を開始させる

Section titled “エージェントに認可と出金を開始させる”

wallet_setup(認可)と withdraw_via_browser(出金)の 2 つのツールは、実行時に 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 を 1 項目追加します。

{
  "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 が返されるので、Web ページでウォレットで署名します
  • 専用のウォレットを使い、取引に使う予定の資金だけを入れてください。
  • AI クライアントでは、注文・決済・出金系ツールの呼び出し確認を有効のままにし、自動承認に設定しないでください。確認する前に、方向、シンボル、証拠金、レバレッジをよく確認してください。
  • エージェントに ~/.jaspervault/ 配下のファイルを読み取らせたり、表示させたり、アップロードさせたりしないでください。キーファイルの内容を会話に貼り付けることもしないでください。
  • エージェントが認可・入金・出金の URL を提示したら、ウォレットで署名する前に、金額、アドレス、有効期限などの署名内容を確認してください。
  • 同じエージェントに、出所の不明な Web ページやドキュメントを読ませながら注文ツールを持たせないでください。コンテンツに隠された指示によって、注文するよう誘導される可能性があります。
  • 注文が明確に成功したと言えるのは、"status": "completed"(成行注文、保護の追加)または limitOrderId(指値注文、利確・損切り注文)が返された場合だけです。timeout、failed、ネットワークエラーが返された場合でも、注文はすでに約定している可能性があります。まず list_orders と list_limit_orders で結果を確認してから、再注文するかどうかを判断してください。
  • 縮小したことのあるポジションは、close_position で決済した後に逆方向のポジションがオープンされる可能性があるため、Web 版で決済することをおすすめします。close_position で決済した後は、list_orders でポジションが決済されていること、逆方向の新しいポジションがオープンされていないことを確認してください。理由はコマンドラインで取引するの「ポジションの追加・縮小・決済」を参照してください。
  • 委任キーにできること・できないことはトレーダー向け連携の概要を参照してください。