Windsurf

Windsurf は Codeium の AI ファーストコードエディタです。AI を備えた最先端の IDE 統合を好む方におすすめです。

前提条件

• Windsurf IDE がインストール済み
• FIX 認証情報（始める前にを参照）

OAuth 方式

Step 1: Windsurf の設定を開く

Windsurf の MCP 設定は ~/.codeium/windsurf/mcp_config.json にあります。

ファイルが存在しない場合は作成します:

mkdir -p ~/.codeium/windsurf
touch ~/.codeium/windsurf/mcp_config.json

Step 2: サーバーを追加する

~/.codeium/windsurf/mcp_config.json を編集します:

{
  "mcpServers": {
    "axiory-ai": {
      "type": "streamable-http",
      "serverUrl": "https://mcp.axiory.ai/mcp"
    }
  }
}

Step 3: OAuth ログイン

Windsurf を再起動します。Axiory.ai のツールを初めて使うと、ブラウザが開き FIX 認証情報フォームが表示されます:

1. ブローカーサーバーを選択
2. SenderCompID を入力（cTrader Settings > FIX API から）
3. FIX API Password を入力（cTrader のログインパスワードではありません）
4. 取引モード（readonly/paper/live）を設定
5. Connect をクリック

「Connected Successfully」と表示されます。

Step 4: 接続をテストする

Windsurf チャットで次のように尋ねます:

“Are you connected to cTrader? Show me my positions.”

Windsurf がアカウントのステータスを返します。

Portal Token 方式 (フォールバック)

OAuth が動作しない場合:

Step 1: トークンを生成する

ブラウザで次の URL にアクセスします:

https://mcp.axiory.ai/token-portal

1. ブローカーサーバーを選択
2. FIX 認証情報を入力
3. 取引モードを選択
4. Generate Token をクリック
5. トークンをコピー

Step 2: トークンを保存する

環境変数にトークンを設定します:

export AXIORY_TOKEN="your-token-here"

永続化するには ~/.zshrc または ~/.bashrc に追加します:

echo 'export AXIORY_TOKEN="your-token-here"' >> ~/.zshrc
source ~/.zshrc

Step 3: Windsurf を設定する

~/.codeium/windsurf/mcp_config.json を編集します:

{
  "mcpServers": {
    "axiory-ai": {
      "type": "streamable-http",
      "serverUrl": "https://mcp.axiory.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AXIORY_TOKEN}"
      }
    }
  }
}

Step 4: Windsurf を再起動する

Windsurf を閉じて開き直し、新しい環境変数を読み込みます。

Windsurf での使い方

接続が完了したら:

@axiory-ai What's the current price of EURUSD?

@axiory-ai Buy 100,000 units of EURUSD at market price

Windsurf は Axiory.ai のツールを使ってクォートを取得し、リスク制限をチェックし、注文を実行します。

最初の取引を行う

Windsurf で:

“I want to buy 50,000 units of EURUSD. What’s the current price?”

Windsurf は次を実行します:

1. 現在のクォートを取得
2. リスク制限をチェック
3. 注文を発注（または paper モードでシミュレート）
4. 確認を表示

トークンローテーション

Portal トークンは 30 日で失効します。期限切れの前に:

1. Token Portal にアクセス
2. 新しいトークンを生成
3. 環境変数を更新: export AXIORY_TOKEN="new-token"
4. Windsurf を再起動

トークンが失効すると、「401 Unauthorized」が表示されます。新しいトークンを生成してください。

トラブルシューティング

「MCP server not found」または接続失敗

確認事項:

1. ファイルが存在: ~/.codeium/windsurf/mcp_config.json
2. JSON が有効（構文エラーなし）
3. サーバー URL が正確: https://mcp.axiory.ai/mcp
4. 編集後に Windsurf を再起動

OAuth フォームで「Invalid credentials」

FIX 認証情報が誤っています:

1. cTrader Settings > FIX API に移動
2. SenderCompID を完全に一致するようにコピー（すべてのドットと数字を含む）
3. FIX API Password を完全に一致するようにコピー（ログインパスワードではありません）
4. OAuth を再試行するか Portal Token を再生成

「401 Unauthorized」(Portal Token)

トークンが失効しているか無効です:

1. 確認: echo $AXIORY_TOKEN
2. 空ならば設定: export AXIORY_TOKEN="your-token"
3. 無効ならば、Token Portal で新しいトークンを生成
4. Windsurf を再起動

Windsurf が環境変数を見つけられない

以下を確認:

1. 変数を設定済み: export AXIORY_TOKEN="..."
2. Windsurf を再起動済み（設定の再読み込みではなく）
3. 変数の存在を確認: echo $AXIORY_TOKEN

次のステップ

• 運用モード — readonly、paper、live を理解する
• リスク制限 — ポジションサイズと日次損失制限
• エージェントの選び方 — 他の MCP クライアントとの比較

Windsurf はコードベースの取引戦略に優れています。まずは paper モードでテストしてください。