Cursor

Cursor は AI を搭載したコードエディタです。開発ワークフローに取引を統合したい方におすすめです。

前提条件

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

OAuth 方式

Step 1: Cursor の設定を開く

1. Cursor を開きます
2. Settings > Features > MCP に移動します
3. Add MCP Server をクリックします

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

1. Name: axiory-ai（または Axiory.ai）
2. Type: streamable-http
3. URL: https://mcp.axiory.ai/mcp
4. Save をクリック

Step 3: OAuth ログイン

Cursor がブラウザを開き、FIX 認証情報フォームを表示します:

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

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

Step 4: 接続をテストする

Cursor でチャットを開き、次のように尋ねます:

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

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

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: Cursor を設定する

Cursor の MCP 設定で次を追加します:

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

${env:AXIORY_TOKEN} 構文により、Cursor は環境変数を使用します。

Step 4: Cursor を再起動する

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

Cursor での使い方

接続が完了すると、次のことができます:

1. Cursor にリアルタイム市場データを取得させる
2. 注文を発注させる
3. Axiory.ai と連携するトレーディングボットやスクリプトを構築する
4. 戦略をバックテストする

例:

@axiory-ai Show me the current EURUSD price

@axiory-ai I want to build a simple moving average crossover bot. Here's my idea:
- Buy when the 20-period MA crosses above the 50-period MA
- Sell when it crosses below
- Position size: 100,000 units

Can you implement this?

Cursor は Axiory.ai のツールを使用してクォート取得やポジション管理などを行います。

最初の取引を行う

Cursor チャットで:

“Buy 50,000 units of EURUSD at the current market price”

Cursor は次を実行します:

1. 現在の価格を取得
2. 注文を発注
3. 確認を表示

paper モードではシミュレーション、live モードでは実行されます。

トークンローテーション

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

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

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

トラブルシューティング

「MCP server not found」または「Connection refused」

確認事項:

1. Cursor の MCP 設定の URL が正しい: https://mcp.axiory.ai/mcp
2. 設定が保存されている（編集モードではない）
3. 保存後に Cursor を再起動

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. 環境変数を更新して Cursor を再起動

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

以下を確認:

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

それでも動作しない場合、一時的にトークンをハードコードできます（本番環境では非推奨）:

{
  "headers": {
    "Authorization": "Bearer actual-token-here"
  }
}

次のステップ

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

Cursor はカスタム取引スクリプトの構築に最適です。まずは paper モードでテストしてください。