サービスモデル
サービスモデルとトラブルシューティング
Section titled “サービスモデルとトラブルシューティング”このサービスとは何か
Section titled “このサービスとは何か”これはクラウドホスト型のリモート MCP サービスです。OAuth または Bearer トークン経由で HTTPS で接続します。サービスはマネージドクラウドインフラストラクチャ上で動作します — サーバーへのアクセスはありません。
重要な事実:
- サーバーはマルチテナントクラウドサービスです — 多くのユーザーが同時に接続し、それぞれ分離されたセッションを持ちます
- FIX トレーディングセッションはサーバーサイドで動作します — MCP ツール経由でのみやり取りします
- セッションは認証時にオンデマンドで作成され、30 分間非アクティブの場合アイドルタイムアウトします
- 状態（ポジション、注文、リスクカウンタ）は新しいセッションごとにブローカーから自動的に再構築されます
すべてのやり取りは MCP ツールを通じて行われます:
| アクション | ツール |
|---|---|
| 接続性とステータスの確認 | check_health |
| TRADE FIX セッションの再接続 | reconnect_trade_session |
| QUOTE FIX セッションの再接続 | reconnect_quote_session |
| 設定の変更（モード、リスク、アカウント） | reset_session |
| ポジション、注文、クォートの表示 | get_positions、get_orders、get_quote |
| 注文の発注/変更/取消 | place_order、modify_order、cancel_order |
| ドキュメントへのアクセス | get_knowledge |
できないこと
Section titled “できないこと”ユーザーはサーバーインフラストラクチャにアクセスできません。以下を提案してはいけません:
- ❌ サーバーへの SSH
- ❌ プロセスの再起動（PM2、systemd、Docker など）
- ❌ 環境変数の確認または編集
- ❌ サーバーログやファイルの読み取り
- ❌ サーバー設定ファイルの変更
- ❌ Docker コンテナへのアクセス
- ❌ サーバーでのシェルコマンド実行
- ❌ サーバーのメモリ、CPU、ディスク使用量の確認
- ❌ データベースへの直接アクセス
ユーザーには URL しかありません。 それがサービスへの唯一のインターフェースです。
トラブルシューティングガイド
Section titled “トラブルシューティングガイド”何か問題が発生した場合、利用可能な MCP ツールのみを使用してこのエスカレーションパスに従ってください:
ステップ 1: check_health で診断
Section titled “ステップ 1: check_health で診断”常にここから始めてください。レスポンスは以下を示します:
fixState: TRADE セッションのステータス（“ACTIVE” = 接続済み、それ以外は問題）quoteSession.state: QUOTE セッションのステータスoperatingMode: paper/live/readonlyriskLimits: 現在のリスク設定killSwitch: 取引が停止されているかどうか
ステップ 2: 必要に応じて再接続
Section titled “ステップ 2: 必要に応じて再接続”| 症状 | アクション |
|---|---|
fixState != “ACTIVE” | reconnect_trade_session を呼び出す |
quoteSession.state != “ACTIVE” | reconnect_quote_session を呼び出す |
| 両セッションがダウン | まずトレード、次にクォートを再接続 |
切断の一般的な原因:
- 週末の市場クローズ（金曜夜 → 日曜夜）
- ブローカーメンテナンス期間
- ネットワーク中断（ユーザーには透過的）
- セッションアイドルタイムアウト（MCP リクエストなしで 30 分）
ステップ 3: 再接続が失敗した場合
Section titled “ステップ 3: 再接続が失敗した場合”reconnect_trade_session または reconnect_quote_session がエラーを返した場合:
- 10〜30 秒待って再試行（ブローカーが一時的に到達不能の可能性）
check_healthを呼び出して現在の状態を確認- 問題が続く場合、ブローカー側の問題である可能性が高いです（メンテナンス、停止）
ユーザーに伝えること:
- “ブローカーの FIX サーバーに到達できないようです。これは通常一時的なものです。”
- “市場がクローズしている可能性があります（週末: 金曜夜から日曜夜まで）。”
- “数分後に再試行してください。問題が続く場合は、ブローカーに確認してください。“
ステップ 4: 設定変更
Section titled “ステップ 4: 設定変更”ユーザーがトレーディングモード、リスク制限、ブローカーサーバー、またはアカウントを変更する必要がある場合:
reset_sessionを呼び出す- リセット後、ユーザーに Settings → Connectors → Disconnect → Reconnect に進むよう指示
- ブラウザが新しい設定のための設定フォームを開きます
ステップ 5: 何も機能しないとき
Section titled “ステップ 5: 何も機能しないとき”すべてのリカバリツールが失敗し問題が続く場合:
- インフラストラクチャアクションを提案しない — ユーザーはサーバーにアクセスできません
- ユーザーに伝える: “クラウドサービスに問題が発生している可能性があります。MCP コネクタを切断して再接続してください。”
- それでも機能しない場合: “後で再試行してください。問題が続く場合は、submit_feedback を使用して報告してください。“
一般的なシナリオ
Section titled “一般的なシナリオ””サーバーが応答しない”
Section titled “”サーバーが応答しない””→ check_health を呼び出す。失敗した場合、MCP セッションが期限切れになっている可能性があります。ユーザーにコネクタを切断して再接続するよう伝えてください。
“FIX セッションがダウン”
Section titled ““FIX セッションがダウン””→ reconnect_trade_session を呼び出す。週末またはアイドル期間後は通常の動作です。
“クォートが古いか欠落している”
Section titled ““クォートが古いか欠落している””→ reconnect_quote_session を呼び出し、その後 subscribe_quotes または get_quote でリフレッシュ。
“キルスイッチが起動した”
Section titled ““キルスイッチが起動した””→ check_health を呼び出して確認。ユーザーは異なるリスクパラメーターで reset_session して再設定するか、キルスイッチをリセットする必要があります。
“モードまたはリスク制限が間違っている”
Section titled ““モードまたはリスク制限が間違っている””→ reset_session を呼び出して新しい設定での再認証をトリガーします。
“ツール呼び出しが認証エラーを返す”
Section titled ““ツール呼び出しが認証エラーを返す””→ トークンが期限切れになっている可能性があります。ユーザーに MCP コネクタを切断して再接続し、再認証するよう伝えてください。