はじめに

Axiory.ai を始める

概要

この MCP サーバーは、AI エージェントを cTrader の FIX 4.4 トレーディングゲートウェイに TLS/TCP 経由で接続します。 10 のトレーディングツール、12 のリソース（4 つのコア + 8 つのナレッジベース）、および 3 つのプロンプトを提供し、 組み込みのリスク管理と、専用 QUOTE セッション経由のオプションのリアルタイム市場データを備えています。

ステップ 1: FIX API 認証情報を取得する

cTrader デスクトップまたは Web プラットフォームを開きます:

1. 左下の Cog（設定）アイコンをクリックします
2. 設定メニューから FIX API を選択します
3. 2 つの接続タイプ（Price と Trade）が表示されます
4. このサーバーは両方の接続を使用します: 注文/ポジションには Trade、リアルタイムクォートには Price
5. Copy ボタンを使用して各認証情報をコピーします

参考: https://help.ctrader.com/fix/getting-credentials/

必須の認証情報（4 フィールド）

フィールド	例
Host	uat-demo1.p.c-trader.com
Trade Port	5212
SenderCompID	demo.axioryuat.3008144
Password	（ブローカーの FIX API 設定から）

自動派生フィールド

• Username: SenderCompID から自動的に抽出されます（最後のドット以降のセグメント）。 例: demo.axioryuat.3008144 → 3008144
• TargetCompID: デフォルトは cServer
• SenderSubID: デフォルトは TRADE

ブローカーが異なる値を要求する場合のみ、これらを上書きする必要があります。

ステップ 2: FIX Symbol ID を見つける

各銘柄には FIX メッセージに必要な一意の数値 ID があります:

1. cTrader で Active Symbol Panel を開きます
2. Symbol info ドロップダウンまでスクロールします
3. Symbol info の一番下に FIX symbol ID があります

重要: FIX Symbol ID はブローカーによって異なる場合があります。必ずご自身のブローカーで確認してください。

ステップ 3: AI エージェントクライアントを接続する

接続方法は 2 つあります。お使いのクライアントで動作する方を使用してください。

方法 A: OAuth（推奨）

ほとんどの MCP クライアントは OAuth をネイティブにサポートしています。サーバー URL を追加すると、クライアントは ブラウザウィンドウを開き、そこで FIX 認証情報を入力します。トークンは自動更新されます。

1. お使いの MCP クライアントで: Settings → MCP Servers → Add Server
2. コネクタ URL を入力します: https://mcp.axiory.ai/mcp
3. ブラウザウィンドウが開き、FIX 認証情報フォームが表示されます
4. ドロップダウンからブローカーサーバーを選択します（trade/quote ポートは自動入力）
5. FIX 認証情報を入力します（SenderCompID、Password）
6. オプションで “Advanced Settings” でモードとリスク制限を設定します
7. “Connect” をクリック — ブラウザがリダイレクトされ、接続完了です！

サポートされているクライアント: Claude Desktop、claude.ai、Cursor、Windsurf、Cline、Claude Code CLI、 OpenAI/ChatGPT、Google Gemini、Perplexity など。

方法 B: Portal Token（フォールバック）

クライアントが OAuth ブラウザフローを完了できない場合:

1. ブラウザでトークンポータルにアクセス: https://mcp.axiory.ai/token-portal
2. ブローカーサーバーを選択し、FIX 認証情報を入力します
3. トレーディングモードを選択します（readonly / paper / live）
4. “Generate Token” をクリックします
5. トークンをすぐにコピーしてください — 一度しか表示されません
6. クライアント設定に Bearer トークンとして追加します

ポータルトークンは 30 日後に期限切れになります。トークンを環境変数に保存し、ハードコードしないでください。

例（Cursor の ~/.cursor/mcp.json）:

{ "mcpServers": { "axiory-ai": { "url": "https://mcp.axiory.ai/mcp",
  "headers": { "Authorization": "Bearer ${env:AXIORY_TOKEN}" } } } }

認証情報はサーバー側で暗号化されます。生の認証情報がログに記録されたり平文で保存されることはありません。

QUOTE セッション（リアルタイム市場データ用）

QUOTE セッションはデフォルトで有効です。通常 TRADE と同じホストおよび認証情報を使用しますが、 異なるポート（例: 5212 ではなく 5211）を使用します。

OAuth 認証情報フォームで “Advanced Settings” を展開して以下を設定します:

フィールド	デフォルト
Quote Host	Trade Host と同じ
Quote Port	Trade Port と同じ
Quote Password	Password と同じ

ステップ 3: 運用モードを選択する

モード	動作	ユースケース
readonly	ポジション/注文の閲覧のみ	モニタリング
paper	検証 + ログ、執行なし	テスト（デフォルト）
live	実注文執行	プロダクション取引

ライブに切り替える前にすべてが動作することを確認するため、paper モードから開始してください。 モードは OAuth セットアップ中またはトークンポータルフォームで選択します。

ステップ 4: 最初のテスト

1. お好みの AI エージェントクライアントから接続します
2. get_positions を使用して FIX 接続を確認します
3. get_orders を使用して保留中の注文を確認します
4. 接続ステータスを確認するために ctrader://health リソースを読みます
5. place_order でテスト注文を試します（ペーパーモードでは執行されません）
6. ジャーナルの監査ログエントリを確認します

サポートされているクライアント

このサーバーは、任意の MCP 互換 AI エージェントクライアントで動作します:

• Claude Desktop / claude.ai — OAuth（組み込み）
• Claude Code CLI — OAuth または --header 経由の Bearer トークン
• Cursor — OAuth または ~/.cursor/mcp.json 経由の Bearer トークン
• Windsurf — OAuth または ~/.codeium/windsurf/mcp_config.json 経由の Bearer トークン
• Cline — OAuth または UI 経由の Bearer トークン
• Continue — ~/.continue/config.yaml 経由の Bearer トークン
• OpenAI / ChatGPT — OAuth または Developer Mode 経由の Bearer トークン
• Google Gemini CLI — OAuth または Bearer トークン
• Perplexity — OAuth または API キー
• Manus — OAuth または Connector UI 経由の Bearer トークン

正確な設定スニペット付きのクライアントごとの詳細セットアップ手順については、“agent client setup” についてお問い合わせください。