Claude Code CLI

Claude Code は Anthropic の Claude 用コマンドラインインターフェースです。ターミナルベースのワークフローを好む方におすすめです。

前提条件

• Claude Code CLI のインストール（npm install -g @anthropic-ai/claude-code）
• FIX 認証情報（始める前にを参照）

OAuth 方式 (推奨)

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

claude mcp add axiory-ai --transport http \
  https://mcp.axiory.ai/mcp

Step 2: OAuth ログイン

CLI が自動的にブラウザを開きます。OAuth フローを完了します:

1. ブローカーサーバーを選択（該当する場合）
2. SenderCompID と FIX API Password を入力
3. 取引モード（readonly/paper/live）を設定
4. Connect をクリック

Step 3: Claude Code で使う

これで取引ツールを利用できます:

claude

# Claude Code のプロンプト内で:
> Show me my open positions
> What's the current price of EURUSD?
> Buy 100,000 units of EURUSD at market

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

OAuth でブラウザが開かない場合（ヘッドレス環境など）:

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

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

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

1. ブローカーサーバーを選択
2. FIX 認証情報を入力
3. 取引モード（readonly/paper/live）を選択
4. Generate Token をクリック
5. トークンをコピー（一度しか表示されません）

Step 2: Claude Code を設定する

シェル環境でトークンを設定します:

export AXIORY_TOKEN="your-token-here"

トークン付きでサーバーを追加します:

claude mcp add axiory-ai --transport http \
  --header "Authorization: Bearer $AXIORY_TOKEN" \
  https://mcp.axiory.ai/mcp

Step 3: 使ってみる

claude

# Claude Code のプロンプト内で:
> What's my current account balance?
> Place a buy order for EURUSD, 50,000 units

最初の取引を行う

接続が完了したら:

claude

# Claude に尋ねる:
> Can you check that you're connected to cTrader and show me my current positions?

# 接続済みなら、取引を発注:
> I want to buy 100,000 units of EURUSD at the market price. Can you do that?

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

トークンローテーション

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

1. もう一度 Token Portal にアクセス
2. 新しいトークンを生成
3. 環境変数を更新:

   export AXIORY_TOKEN="new-token-here"

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

トラブルシューティング

「Server not found」または「Connection refused」

サーバーが正しく追加されているか確認します:

claude mcp list

リストに axiory-ai が表示されているはずです。表示されていない場合は、add コマンドを再実行してください。

「401 Unauthorized」(Portal Token)

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

1. トークンが設定されているか確認: echo $AXIORY_TOKEN
2. 空ならば設定: export AXIORY_TOKEN="your-token"
3. 無効ならば、Token Portal で新しいトークンを生成
4. 環境変数を更新して再試行

「Invalid credentials」

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

1. cTrader Settings > FIX API に移動
2. SenderCompID と FIX API Password（ログインパスワードではない）を確認
3. トークンを再生成するか、OAuth で再認証
4. 再試行

OAuth フローでブラウザが開かない

ヘッドレスサーバー（GUI なし）の場合:

1. 代わりに Portal Token 方式を使用
2. または DISPLAY=:0 claude mcp add ... を実行して X11 ディスプレイを強制
3. または OAuth authorize エンドポイントへ手動で移動（上級者向け）

次のステップ

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

まずは paper モードでテストし、自信がついたら live に切り替えてください。