運用モード

Axiory.ai MCP Server は、トレーディング活動のリスクレベルを制御できる 3 つの運用モードをサポートしています。モードはサーバーへの接続時に設定し、そのセッション内のすべてのトレーディング操作に適用されます。

モードの概要

モード	注文執行	リスクチェック	用途	次のステップ
readonly	なし（拒否）	スキップ	クエリのテスト、読み取り専用ツール	取引にはペーパーモードに切り替え
paper	シミュレート	完全（8 件）	戦略テスト、学習	ライブに移行する前に結果を確認
live	実行（ブローカーに送信）	完全（8 件）	実取引	ペーパーテスト後のみ

Readonly モード

readonly モードでは、市場データを読み取り、ポートフォリオを表示できますが、すべてのトレーディング操作はブロックされます。

許可されるツール:

• get_positions、get_orders、get_quote、get_quotes、get_symbols
• get_trade_history、check_health、subscribe_quotes
• get_knowledge（ドキュメントアクセス）

ブロックされるツール（エラー MODE_RESTRICTED）:

• すべての注文発注および執行ツール: place_order、modify_order、cancel_order
• すべてのポジションクローズツール: close_position、close_all_positions

ユースケース:

• リスクなしでシステムの動作を学ぶ
• ライブ価格とポジションを監視
• 過去のトレードと統計をレビュー
• ペーパーモードを有効にする前にトレーディングロジックをテスト

ペーパーモード

ペーパーモードでは、注文は検証されますがブローカーには送信されません。完全なリスクチェック、ポジション追跡、P&L 計算など、ライブモードで起こることを実執行なしで確認できます。

ペーパーモードの仕組み

ペーパーモードで注文を発注すると:

1. 検証 — 8 つのリスクチェックすべてがライブモードと同じように実行されます（キルスイッチ、ポジション制限、デイリーロス制限など）
2. シミュレーション — すべてのチェックが通過すれば注文は受け入れられますが、ブローカーには送信されません
3. レスポンス — 以下を含むシミュレートされたレスポンスを受け取ります:
   • mode: "paper"
   • status: "SIMULATED"
   • orderId: "PAPER_xxx"（シミュレートされた注文 ID）
   • MARKET 注文の場合: positionId: "PAPER_POS_xxx"（ストップロス/テイクプロフィットワークフローのテストに使用可能）

ペーパーモードでジャーナルに記録される内容

ペーパーモードは監査ジャーナルにすべてをキャプチャします:

• 正確なパラメーターを伴うツール呼び出し（place_order、close_position など）
• リスクチェック結果（成功/失敗理由）
• レスポンスデータを伴うシミュレートされた注文結果
• トレーシング用のタイムスタンプとリクエスト ID

つまり、注文が執行されていなくても、何をテストしたかの完全な記録があります。

見えるもの、見えないもの

見えるもの:

• ブローカーからの実際のポジションと注文（ライブモードまたは他のクライアントで開いたもの）
• FIX QUOTE セッションからの実際の市場クォート
• 実際のブローカーポジションに基づくリアルなリスクチェック結果

見えないもの:

• シミュレートされた約定やポジションクローズ（ペーパーポジションは作成されません）
• シミュレートされた P&L（架空の利益や損失はありません）
• ブローカーレスポンス（注文は送信されないため、執行レポートはありません）

ペーパーモードは市場状況のリアルなシミュレーションではありません — 検証レイヤーです。実際のトレーディング戦略のパフォーマンスをテストしたい場合は、小規模なライブアカウントまたはリアル執行を伴うデモアカウントを使用すべきです。

ペーパーモードワークフロー

1. 接続時に運用モードを "paper" に設定
2. get_positions / subscribe_quotes を呼び出して実データを表示
3. place_order、modify_order、cancel_order、close_position などを呼び出す
   → すべての操作は検証されますがブローカーには送信されません
   → PAPER_* ID を含むシミュレートされたレスポンスを受け取ります
4. ジャーナルをレビューして何が起こったかを確認
5. 自信が持てたら mode = "live" で再接続

ライブモード

ライブモードでは、注文はブローカーに直接送信され、市場価格で執行されます。8 つのリスクチェックはすべて引き続き適用され、注文は実物です。

動作:

• 注文は FIX プロトコル経由で cTrader に送信されます
• 執行レポートはブローカーから戻ってきます（約定、拒否、部分約定）
• ポジションと注文は実際のブローカーレスポンスから追跡されます
• P&L は実際の価格での実際の約定から計算されます

リスクコントロール: すべての注文の前に 8 つのリスクチェックが実行されます:

1. キルスイッチ — 有効化されている場合（デイリーロス制限超過）、すべての取引をブロック
2. レート制限 — 同一銘柄での連続注文を防止
3. 運用モードチェック — live または paper モードである必要（readonly ではない）
4. 銘柄ホワイトリスト — 設定されたブローカーサーバーで銘柄が取引可能である必要
5. 資産クラスごとのポジションサイズ — 単一ポジションが資産クラスの設定済み最大値を超過してはいけない
6. 最大建玉ポジション数 — 合計建玉ポジション数が設定済みカウントを超過してはいけない（リンクされた注文はカウントされない）
7. デイリーロス制限 — 確定 P&L 損失が設定済みデイリー制限を超過してはいけない（超過時にキルスイッチをトリガー）
8. 数量検証 — 数量は正で、銘柄に対して合理的である必要

各チェックの詳細な説明については、リスク管理を参照してください。

モードの切り替え

異なる設定で MCP コネクタを切断して再接続することでモードを変更できます:

1. 現在のコネクタセッションを切断
2. 新しいモードで再接続（OAuth フォームは readonly、paper、live のいずれかを選ぶよう尋ねます）
3. 19 のツールすべてが新しいモードで動作します

注: モードの切り替えは、ブローカー上の建玉ポジションや注文には影響しません — それらはそのまま残ります。モード切り替え後の新しい操作のみが、新しいモード設定に従います。

ペーパー対ライブのリスクチェック

ペーパーモードとライブモードの両方が同一のリスクチェックを実行します。唯一の違いは:

• ペーパー: チェック通過 → 注文受諾（シミュレート）、チェック失敗 → 注文拒否
• ライブ: チェック通過 → 注文をブローカーに送信、チェック失敗 → 注文拒否

つまり、両方のモードで同じリスク保護が得られます。ペーパーモードでは、実損失なしでリスクシステムの仕組みを学べます。

ベストプラクティス

1. readonly から始める — ツールとデータに慣れる
2. paper に移行する — 完全なリスクチェック有効でトレーディングロジックをテスト
3. ジャーナルをレビューする — 何が起こったかを正確に確認（ペーパーではシミュレート、ライブでは実物）
4. 慎重にライブへ移行する — 小さなポジションサイズから始め、その後スケール
5. デイリーロスを監視する — check_health を頻繁に呼び出して PnL の進行を確認
6. キルスイッチを尊重する — デイリーロス制限により有効化された場合、サーバーは再接続するまですべての取引をブロックします

重要な注意事項

• FIX セッションは常にアクティブ — 3 つのモードすべてで、ブローカーへのライブ接続があり、実データが見えます
• ペーパーモードは約定をシミュレートしません — “もしこの戦略を取引していたら？” の P&L は見えず、検証のみです
• 実ポジションは常に表示される — ペーパーモードでも、他のクライアントまたはライブモードで開かれたポジションが見えます
• モードシーリングなし — 一部のトレーディングシステムとは異なり、グローバルな “デモ” シーリングはありません。各ユーザーのモードは、そのセッションに対して個別です。