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