MCPでAIアシスタントを接続する
Claude、ChatGPT、Cursorにスコープが限定されたAlgoVestaアカウントへの接続を与えることで、ご自身のリスクルールのもとでポートフォリオを読み取り、注文を出せるようになります。
始める前に
- AlgoVestaアカウント。7日間トライアルで十分です — これを試すのに有料プランは必要ありません。
- MCPクライアント: ウェブ・デスクトップ・モバイルのClaude、Claude Code、Cursor、有料プランのChatGPT、Gemini CLI、またはModel Context Protocolに対応するその他のもの。
- キー。始めるのに接続済みの取引所は不要です: paperキーは5,000ドルの仮想残高に対して全ツールセットを実行するため、実際の口座が関わる前にすべてを設定して練習できます。
1. MCPリンクを作成する
- AlgoVestaパネルを開き、MCP接続タブに移動します
- キーを作成をクリックし、どこで使うか分かるラベルを付けます(例:
claude-desktopやcursor-laptop) - スコープを選びます: ポートフォリオの照会だけなら
read、5,000ドルの仮想残高で全ツールを使うならpaper、実際の注文を出すならlive - 表示されたアドレスをコピーします。次のような形式です:
https://api.algovesta.com/u/avmcp_<your-key>/mcp
liveスコープを選択すると、二要素認証が求められます — 認証アプリのTOTPコード、またはメールで届くコードです。この確認はお客様本人がパネルで行います。アシスタントが自らこの昇格を要求することは決してありません。2. Claudeに追加する
- Claudeで設定 → コネクタを開きます
- カスタムコネクタを追加をクリックします
- 名前を付け(
AlgoVesta)、URLフィールドにMCPリンクを貼り付けます - 保存し、新しい会話を開始します — 会話のツール一覧に表示されます
このコネクタはウェブ、デスクトップ、モバイルのClaude間で同期されるため、一度追加すればスマートフォンでも利用できます。シークレットアドレスを貼り付けたくない場合、AlgoVestaはPKCE(S256)と動的クライアント登録に対応した標準のOAuth 2.1エンドポイントもhttps://api.algovesta.com/mcpで提供しています — コネクタをそちらに向ければ、通常のブラウザ同意画面に進みます。
3. Claude Codeに追加する
1つのコマンドでストリーマブルHTTP経由のサーバーを登録します:
claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp
その後claude mcp listを実行し、サーバーが登録され接続可能であることを確認してください。
4. CursorまたはChatGPTに追加する
CursorはJSON設定ファイルを読み込みます。mcp.jsonに1つエントリーを追加します:
{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}
Gemini CLIは同じエントリーを使いますが、フィールド名はurlではなくhttpUrlです。それ以外はすべて同一です。
ChatGPTは、設定で開発者モードを有効にした有料プランでカスタムMCPコネクタに対応しています。そこでコネクタを追加し、同じリンクを貼り付けてください。
5. 接続を確認する
- クライアントで新しい会話を開始します
- 次のように尋ねます:
How is my portfolio? - アシスタントは
get_portfolio_contextツールを呼び出し、実際の残高とオープンポジションで答えるはずです — paperキーの場合は5,000ドルの仮想残高に基づきます
ツールを呼び出さずに一般論で答える場合、サーバーが接続されていません: アシスタントはお客様の口座ではなく取引一般について話しています。リンクを再確認し、クライアントを再起動してください。
接続後にアシスタントができること
20個のツールが公開されています。そのうち14個は読み取りやリハーサルを行うだけで何も変更しません: get_portfolio_context、get_market_price、get_trade_history、compare_venues、simulate_order、list_open_orders、list_strategies、verify_receipt、replay_channel、compile_policy。6個は書き込みを行います: place_order、close_position、modify_position、cancel_order、create_strategy、update_strategy。
これらを名前で直接呼び出す必要はありません。「今何を保有していますか?」「今0.1 BTCを買うといくらかかりますか?」「ETHポジションの半分を決済して」のように平易な言葉で尋ねれば、アシスタントがツールを選び、つなぎ合わせて使います。アシスタントが開くすべてのポジションにはストップロスが必須で、後からそれを取り除くツールは存在しません。各ツールの完全なスキーマは開発者ドキュメントにあります。
トラブルシューティング
401 unauthorized
キーが取り消された、削除された、またはアドレスの入力ミスがある場合です。リンクを手入力で貼り付けたり、末尾に余分な空白が入った状態でコピーしたりしたときに最もよく起こるエラーです。MCP接続タブにキーがまだ存在するか確認してください。存在する場合は、文字列を修復しようとせず削除して新しく作成してください。
insufficient_scope
アシスタントが呼び出そうとしたツールが、そのキーが持つスコープよりも高いスコープを必要としています。readキーはplace_orderを呼び出せず、paperキーは実際の口座にアクセスできません。スコープには階層があるため、paperが必要なツールはreadキーを拒否します。この制限を受け入れるか、実際に必要なスコープで新しいキーを発行してください — liveへの移行には二要素認証が必要です。
user_frozen
アカウントでキルスイッチが有効になっており、すべてのキーが一斉に停止しています。これは意図的な動作で、緊急停止ボタンです。取引を再開したい場合はパネルで凍結を解除してください。1つのクライアントだけを遮断したかった場合は、そのキー1つだけを取り消してください — 他のキーは引き続き動作します。
rate_limited
そのキーで分間60リクエストの上限を超えました。負荷の大きいツールにはより厳しい上限が適用されます: place_orderは分間10回、replay_channelは時間あたり5回に制限されます。しばらく待ってから再試行してください。この状態が繰り返し発生する場合、多くはエージェントがループに陥っているだけで、実際に高速取引しているわけではありません — リクエスト頻度を上げる前に、アシスタントが実際に何をしているか確認する価値があります。
よくある質問
paperスコープのキーは、全ツールセットを使って5,000ドルの仮想残高に対して動作します。注文はペーパーエンジンがリアルタイムの市場価格で約定させ、応答は実取引と同じように見えるため、アシスタントは実際の資金がかかっているかのように振る舞います。すべての新規キーはここから始まります。最初の1週間を過ごすのに妥当な場所です。