ltp-rapidx-config

RapidX 設定

このスキルは、セットアップと統合のレビューにのみ使用してください。ポートフォリオ、市場、注文、ポジション、アルゴリズム、ライブ取引のワークフローには ltp-rapidx-trading を使用してください。

対象範囲

• 公開されている RapidX CLI パッケージを、唯一のランタイムエントリーポイントとして設定します。
• エージェント自身のワークスペースの MCP 設定から rapidx mcp serve を起動して、MCP を設定します。
• このエージェントホストが MCP_READY、CLI_ONLY_READY、NOT_VERIFIED のいずれに該当するかを判定します。
• 読み取り専用の呼び出しで、実際にツールが利用可能か確認します。
• マスキングした認証情報と実際の証拠を含む統合レビューを作成します。

このスキル自体のインストール方法は説明しないでください。エージェントホストにはすでにインストールされているものとします。

参考資料

• 期待される CLI コマンド、MCP ツール、機能名、またはエンドポイントの網羅範囲を確認する場合は、references/capability-overview.md を読んでください。
• RapidX Skills／CLI／MCP のセットアップ全体をレビューする場合、または推奨される外部ユーザーフローを説明する場合は、references/best-practices.md を読んでください。

ワークスペースを最初に確認

MCP 設定を変更する前に、RapidX を実行するエージェントホストのワークスペースを特定します。

1. セッション／ランタイムのコンテキストから、アクティブなエージェントのワークスペースパスを示します。
2. このエージェントホストが読み取る、ワークスペース内の MCP 設定ファイルを特定します。
3. MCP 設定ファイルのパスが曖昧な場合は、確認済みのワークスペースを調べ、既存の MCP 設定を確認します。
4. それでも曖昧な場合は、このエージェントが編集する MCP 設定ファイルをユーザーに尋ねます。
5. ワークスペースと設定ファイルのパスが判明してから、mcpServers.rapidx を追加または更新します。

ソースリポジトリのルート、ファイルシステムのルート、またはグローバルなホーム設定が適切な対象だと決めつけないでください。

認証情報の受け取り

ユーザー提供のチャットシークレットとして認証情報を提供するか、ユーザーに確認してください。これはプログラミングに詳しくないユーザー向けの標準的な方法ですが、先にリスクを伝えてください。保護されたチャットシークレットの仕組みであっても、エージェントホストが管理しており、そのホストの保持、アクセス、共同作業の設定の影響を受ける可能性があります。

エージェントホストに専用のチャットシークレット用 UI がある場合は、正確な名前 LTP_ACCESS_KEY、LTP_SECRET_KEY、LTP_API_HOST で3つのシークレットを作成するようユーザーに依頼してください。ホストにチャットシークレット用 UI がない場合は、マスクされた参照用プレースホルダーを MCP 設定に書き込むか、ローカル環境変数を手動で設定するか、ユーザーに確認してください。

より強い分離を希望する場合は、次の選択肢を提示してください。

• ローカルシェルの環境変数。
• MCP ホストから参照するエンタープライズまたは OS のシークレットマネージャー。

ルール：

• 必須の変数は LTP_ACCESS_KEY、LTP_SECRET_KEY、LTP_API_HOST です。
• LTP_API_HOST にデフォルト値はありません。現在の環境用に指定された API ホストを使用してください。
• LTP_BASE_URL、RAPIDX_BASE_URL、RAPIDX_PORTFOLIO_* は使用しないでください。
• チャットシークレットの仕組みが利用可能な場合、通常のチャットテキストで完全なキーを尋ねたり、表示したりしないでください。
• ログ、設定レビュー、テスト出力、証拠に完全なキーを決して出力しないでください。マスクした値のみを使用してください。

CLI のインストール

RapidX は公式 npm パッケージとして公開されています。CLI をインストールします。

npm install -g @liquiditytech/rapidx-cli

グローバルインストールが許可されていない場合は、確認済みのエージェントワークスペースにインストールし、MCP 設定ではワークスペース内の実行ファイルのパスを使用します。

npm install @liquiditytech/rapidx-cli
./node_modules/.bin/rapidx --version

インストールした CLI を確認します。

rapidx --version
rapidx schema --json
rapidx update check --json
rapidx self-check --json

rapidx schema --json と MCP rapidx/tools は、capabilities／ツールエントリと具体的な inputSchemas の両方を返す必要があります。

CLI のみを使用するエージェントでは、rapidx ... --json コマンドを直接使用してください。MCP アクセスのために、一時的なブリッジスクリプト、ディレクトリを変更するシェルの連結、またはシェルコマンドの連結を作成しないでください。

既存のインストールをアップグレードする

バージョン確認の唯一のエントリーポイントとして CLI を使用してください。すでに rapidx が利用可能な場合は、次を実行します。

rapidx update check --json

次のフィールドを確認します。

• CLI：currentVersion、latestVersion、status、updateAvailable、writeAllowed、upgrade.global、upgrade.workspace。
• スキル：skillsVersion、currentSkillsVersion、skillsUpdateRecommended、upgrade.skills。

currentSkillsVersion は CLI にバンドルされた想定スキルバージョンであり、エージェントにインストール済みのローカルスキルの証明ではありません。インストール済み、または読み込まれた ltp-rapidx-config と ltp-rapidx-trading のフロントマターを確認してください。各スキルには version の宣言が必要です。ローカルバージョンがわかっている場合は、確認時に渡します。

rapidx update check --input '{"installedSkillsVersion":"<local-skill-version>"}' --json

アップグレードのレビューでは、リモートマニフェストを強制的に更新します。

rapidx update check --input '{"installedSkillsVersion":"<local-skill-version>","force":true}' --json

ローカルの version を、rapidx update check --json の latestSkillsVersion または旧形式の skillsVersion と比較します。ローカルバージョンがない場合、最新スキルバージョンより古い場合、または読み取れない場合は、エージェントホストの通常のスキルインストーラーを使用して RapidX スキルを両方とも更新または再インストールし、新しいスキルの内容が読み込まれるようにエージェントを再起動または再読み込みします。

アップグレードの順序：

1. ローカルの version が古い、存在しない、または不明な場合は、RapidX スキルを両方とも更新または再インストールします。
2. 新しいスキルを有効にするため、エージェントを再起動または再読み込みします。
3. updateAvailable=true、status=UPGRADE_REQUIRED、または status=WRITE_BLOCKED の場合は CLI をアップグレードします。
4. MCP が設定されている場合は、MCP ホストを再起動または再読み込みします。
5. rapidx --version、rapidx update check --json、rapidx self-check --json を実行します。
6. MCP がサポートされている場合は、rapidx/tools、rapidx/update/check、rapidx/self-check を検証します。

公式 npm CLI のアップグレード：

npm install -g @liquiditytech/rapidx-cli@latest

ワークスペースローカル CLI のアップグレード：

npm install @liquiditytech/rapidx-cli@latest
./node_modules/.bin/rapidx --version

ランタイムパスの選択

CLI のインストール後、MCP の設定が可能な場合はその設定後に、エージェントを分類します。エージェントの製品名や設定ファイルの存在だけで分類しないでください。

インストール前は、候補となるパスのみを選択します。

• ホストがワークスペースの MCP 設定と、ネイティブなツール検出／呼び出し機能を提供している場合は、MCP パスを試します。
• ホストがシェル、exec、またはターミナルコマンドのみを提供している場合は、CLI のみのパスを使用します。
• 判断できない場合は、まず CLI をインストールして CLI のセルフチェックを実行し、MCP ツールを実際に呼び出せるようになるまでは MCP を NOT_VERIFIED のままにします。

インストール／設定後、次のいずれかのステータスを設定します。

• CLI_READY：rapidx --version と rapidx schema --json が成功します。
• MCP_READY：CLI_READY であり、initialize が serverInfo.name=rapidx を返し、tools/list に 46 個の rapidx/... ツールが表示され、さらに rapidx/tools、rapidx/update/check、rapidx/self-check を MCP ツールとして呼び出せます。
• CLI_ONLY_READY：CLI_READY ですが、ホストで MCP ツールの設定、検出、または呼び出しができません。
• NOT_VERIFIED：実際の呼び出しを示す証拠がない場合、または設定ファイルを編集しただけの場合です。

mcpServers.rapidx の記述は、MCP の設定を試みたことを示すだけです。MCP の準備が完了した証明ではありません。MCP が MCP_READY でない場合は、MCP を NOT_VERIFIED とし、直接 rapidx ... --json コマンドを使用します。

MCP 設定

MCP は CLI によって起動します。このサーバーをエージェントのワークスペース MCP 設定に追加してください。

{
  "mcpServers": {
    "rapidx": {
      "command": "rapidx",
      "args": ["mcp", "serve"],
      "env": {
        "LTP_ACCESS_KEY": "<user-provided-secret-or-env-reference>",
        "LTP_SECRET_KEY": "<user-provided-secret-or-env-reference>",
        "LTP_API_HOST": "<user-provided-secret-or-env-reference>"
      }
    }
  }
}

MCP ホストの PATH に rapidx がある場合、MCP サーバーのコマンドは rapidx、引数は ["mcp", "serve"] にしてください。PATH が保証されていない場合は、インストール済みの rapidx 実行ファイルへの絶対パスを command に指定し、引数は ["mcp", "serve"] のままにしてください。MCP ツールの参照先に一時的な CLI コマンドを指定したり、シェルスクリプトのラッパーを追加したりしないでください。

ホストごとの設定例：

Codex:
  codex mcp add rapidx -- rapidx mcp serve

Claude Code:
  claude mcp add --transport stdio rapidx -- rapidx mcp serve

Cursor:
  Add to mcp.json:
  {"mcpServers":{"rapidx":{"command":"rapidx","args":["mcp","serve"],"env":{"LTP_ACCESS_KEY":"<secret>","LTP_SECRET_KEY":"<secret>","LTP_API_HOST":"<secret>"}}}}

Gemini CLI:
  gemini mcp add rapidx rapidx -- mcp serve

OpenCode:
  Add to opencode.jsonc:
  {"mcp":{"rapidx":{"type":"local","command":["rapidx","mcp","serve"],"enabled":true}}}

OpenClaw:
  openclaw mcp add rapidx --command rapidx --arg mcp --arg serve
  openclaw mcp doctor rapidx --probe

Hermes:
  hermes mcp add rapidx --command rapidx --args mcp serve

OpenClaw では、--arg を複数回指定してください。--args は使わないでください。

Hermes では、--args を1回だけ指定し、その後に mcp serve を記述してください。Hermes は最初の --args を子コマンドの引数の開始として扱うため、--args を繰り返し指定しないでください。

ホストの CLI が対話型の mcp add フローを実行しようとして、すべてのツールを有効にするかどうかなどのプロンプトで停止した場合、非対話型ターミナルで再試行を続けないでください。確認済みのワークスペース MCP 設定をホストのネイティブ形式で編集し、エージェントホストを再起動または再読み込みして、実際の MCP ツール検出で検証してください。JSON 設定では通常 mcpServers.rapidx、YAML 設定では通常 mcp_servers.rapidx を使います。

MCP 環境変数の反映に関するフォールバック

まず、hermes mcp add、codex mcp add、claude mcp add、openclaw mcp add など、ホストの公式 MCP 設定方法か、ホストで文書化されている mcp.json／YAML 設定を使ってください。

MCP が読み込まれて rapidx/tools が表示される一方、rapidx/self-check が Invalid URL、credential-auth: FAIL、RapidX 認証情報の欠落などの認証情報／認証エラーを報告する場合は、rapidx MCP サーバーの環境変数ブロックだけを調べてください。次のリテラルのプレースホルダー値は、実際の値に反映されていないものとして扱ってください。

${LTP_ACCESS_KEY}
$LTP_ACCESS_KEY
${LTP_SECRET_KEY}
$LTP_SECRET_KEY
${LTP_API_HOST}
$LTP_API_HOST
<secret>
<secret-ref>
<provided-api-host>
""

修復ルール：

1. エージェントが読み取れるシークレットソースから実際の値を読み取ります。ユーザーから提供されたチャット内のシークレット、.env、OS 環境変数、エージェントのシークレットストア、またはユーザーが使用を許可したワークスペースのシークレットファイルが該当します。
2. 構造化パーサーを使って MCP 設定を更新します。YAML には yaml.safe_load／safe_dump、JSON には json.load／json.dump を使ってください。
3. mcp_servers.rapidx、mcpServers.rapidx、またはホストにおける同等の MCP サーバーマップ内の rapidx サーバーブロックだけを置き換えます。
4. mcp_servers:.* のような広範な正規表現で設定を削除しないでください。
5. 既存の rapidx ブロックがある場合、2つ目のブロックを追加しないでください。
6. 認証情報の値全体を、チャット、ログ、レビューの概要、証跡に表示しないでください。

Hermes で hermes mcp add を実行した際に、未解決の ${VAR} 値を含む設定が作成された場合は、通常は次の場所にあるアクティブなプロファイル設定を編集してください。

~/.hermes/profiles/<profile>/config.yaml

修復後の rapidx ブロックでは、実際の値を反映するか、Hermes が実行時に実際に展開できるシークレットの仕組みを使ってください。例のプレースホルダーをそのままコピーしないでください。

mcp_servers:
  rapidx:
    command: rapidx
    args:
      - mcp
      - serve
    env:
      LTP_ACCESS_KEY: "actual-access-key-or-host-supported-secret-reference"
      LTP_SECRET_KEY: "actual-secret-key-or-host-supported-secret-reference"
      LTP_API_HOST: "actual-api-host"

修復後、MCP ホストを再読み込みしてください。Hermes では、利用可能な場合は /reload-mcp を実行してください。ホストが MCP のホットリロードに対応していない場合は、エージェントのセッションまたはゲートウェイを再起動してください。

再読み込み後の検証：

rapidx/tools
rapidx/update/check
rapidx/self-check

ホストを MCP_READY と判定する前に、rapidx/self-check で credential-auth が PASS と報告されている必要があります。

MCP ツールの一覧

正常な MCP ツール検出では、46 個のツールが公開されます。

Discovery: rapidx/tools, rapidx/self-check, rapidx/update/check
Market:    rapidx/market/get-ticker, rapidx/market/get-orderbook, rapidx/market/get-klines,
           rapidx/market/get-funding-rate, rapidx/market/get-mark-price,
           rapidx/market/get-symbol-info, rapidx/market/get-open-interest
Portfolio: rapidx/portfolio/overview, rapidx/portfolio/assets,
           rapidx/portfolio/statement, rapidx/portfolio/user-fee-rate,
           rapidx/portfolio/position-bracket, rapidx/portfolio/set-position-mode
Trade:     rapidx/trade/preview, rapidx/trade/verify-live
Automation:
           rapidx/automation/start, rapidx/automation/list,
           rapidx/automation/status, rapidx/automation/extend,
           rapidx/automation/stop
Order:     rapidx/order/place-preview, rapidx/order/replace-preview,
           rapidx/order/cancel-preview,
           rapidx/order/place, rapidx/order/replace, rapidx/order/cancel,
           rapidx/order/cancel-all, rapidx/order/query,
           rapidx/order/open-orders, rapidx/order/history
Transactions:
           rapidx/transaction/executions
Position:  rapidx/position/query, rapidx/position/history,
           rapidx/position/get-leverage, rapidx/position/close,
           rapidx/position/close-all, rapidx/position/set-leverage
Algo:      rapidx/algo/place, rapidx/algo/replace, rapidx/algo/cancel,
           rapidx/algo/open-orders, rapidx/algo/history, rapidx/algo/query

open-orders は「注文を開く」ではなく、現在の非終端状態の注文を指します。これらの注文は、引き続き約定、置換、またはキャンセルが可能な場合があります。algo/open-orders は、条件付き注文や TPSL 注文など、まだトリガーされておらず、キャンセルもその他の終了もしていない、現在の非終端状態のアルゴ注文を指します。

get_ticker、place_order、list_positions などの古い snake_case 名は、統合が古いことを示しており、使用しないでください。

読み取り専用セルフチェック

セルフチェックでは、設定されたランタイムが実際に動作していることを確認します。結果をシミュレートしたり、残高を捏造したり、ドキュメントだけを根拠に成功を主張したりしないでください。

クイックチェックを実行します。

1. rapidx --version と rapidx schema --json を実行して CLI_READY を確認し、読み取り可能な inputSchemas も確認します。
2. セットアップ時またはレビュー時に rapidx update check --json を実行します。GitHub のリリースマニフェストを読み取り、その結果をローカルにキャッシュする場合があります。
3. MCP を試す場合は、MCP ホストを通じてツールを検出し、46 個のツールの一覧を確認します。
4. ホストが MCP ツールの呼び出しに対応している場合は、rapidx/update/check を呼び出します。
5. ホストが MCP ツールの呼び出しに対応している場合は、rapidx/self-check を呼び出します。
6. 公開マーケットのルートを 1 つ呼び出します。できれば BINANCE_PERP_BTC_USDT に対して rapidx/market/get-ticker を呼び出します。ユーザーから Binance ネイティブシンボルが提供された場合は、RapidX を呼び出す前に正規化します。BTCUSDT は BINANCE_PERP_BTC_USDT に、中国語のベース資産である 币安人生USDT は BINANCE_PERP_币安人生_USDT になります。
7. ポートフォリオ概要、ポートフォリオ資産、オープン注文、ポジション、アルゴ注文の読み取りルートを呼び出します。

ホストがまだ MCP ツールを呼び出せない場合は、同等の読み取り専用 CLI チェックを実行し、MCP ツールの呼び出しを NOT_VERIFIED として記録します。CLI の成功を MCP の成功として扱わないでください。

統合レビューまたはセルフ検証を求められた場合は、より詳細なレビューを実行します。

1. rapidx/tools
2. rapidx/update/check
3. rapidx/self-check
4. rapidx/market/get-ticker
5. rapidx/market/get-orderbook
6. rapidx/market/get-klines
7. rapidx/market/get-funding-rate
8. rapidx/market/get-mark-price
9. rapidx/market/get-symbol-info
10. rapidx/market/get-open-interest
11. rapidx/portfolio/overview
12. rapidx/portfolio/assets
13. rapidx/order/open-orders
14. rapidx/order/history
15. rapidx/order/query with a deliberately nonexistent self-check order id
16. rapidx/position/query
17. rapidx/position/history
18. rapidx/algo/open-orders
19. rapidx/algo/history
20. rapidx/algo/query with a deliberately nonexistent self-check algo order id

セットアップ中に削除済みの mode="account" ポートフォリオ資産チェックを呼び出さないでください。ポートフォリオの認証情報では、rapidx/portfolio/assets がサポート対象の残高／資産読み取りルートです。

結果の分類

• PASS：実際のツールまたはコマンドから、実際の成功レスポンスが返されました。
• EXPECTED_ERROR：ルートは稼働しており、実際のビジネスエラー、権限エラー、非対応モードエラー、または意図的な未検出エラーが返されました。
• INVALID_INPUT：送信前にスキーマまたはローカル入力の検証でリクエストが拒否されました。
• NOT_FOUND：構文上有効なリソースが存在しません。たとえば、形式が有効な注文 ID を RapidX が見つけられない場合です。
• PERMISSION_SCOPE_ERROR：認証情報は有効ですが、要求されたルートまたはポートフォリオのスコープに対応していません。
• BUSINESS_ERROR：RapidX または取引所によって、ビジネスルール上の理由で拒否されました。
• FAIL：ツールが見つからない、起動／認証／ネットワークに失敗した、レスポンスの形式が不正、または必須の呼び出しがタイムアウトしました。
• NOT_VERIFIED：エージェントがツールを呼び出せなかった、またはユーザーが認証情報の提供を断りました。

更新チェックで WRITE_BLOCKED、UPGRADE_REQUIRED、または skillsUpdateRecommended=true が返された場合は、レビューで報告してください。WRITE_BLOCKED または UPGRADE_REQUIRED の CLI をアップグレードし、MCP ホストを再起動するまでは、取引の書き込み操作を実行しないでください。

すべての行に、toolOrCommandEvidence または観測されたコード／メッセージと同等の証拠を含める必要があります。実際の整形式レスポンスが返された場合、注文、ポジション、履歴のリストが空でも PASS です。

統合レビューの出力

セットアップのレビューを求められた場合は、次の構造を返します。

# RapidX Integration Review

## Verdict
- status: PASS / PARTIAL / FAIL / NOT_VERIFIED
- runtime path: MCP_READY / CLI_ONLY_READY / NOT_VERIFIED
- main issues:

## Workspace And Config
- agent workspace:
- MCP config path:
- MCP command: rapidx mcp serve
- CLI package:
- host:
- credentials: configured and masked / missing / not verified

## Tool Discovery
- expected MCP tools: 46
- actual MCP tools:
- missing tools:
- legacy tools found:

## Version And Upgrade
- current CLI:
- latest CLI:
- minimum write version:
- update status:
- skills update recommended:

## Read-Only Checks
| check | result | evidence |
| --- | --- | --- |

## Required Fixes
- ...

書き込み操作の検証または実取引テストを行う場合は、ltp-rapidx-trading に切り替えてください。