Capital.com MCP

Capital.com MCP サーバー

Capital.com Open API 用の Model Context Protocol（MCP）サーバーです。LLM 主導で Capital.com の取引口座にアクセスできます。

⚠️ 重要なお知らせ

Capital.com Public API および AI／LLM ベースのツールを含むサードパーティ製ツールの使用は、お客様ご自身の責任で行ってください。Capital.com は執行のみを行うサービスであり、サードパーティ製ソフトウェアやその結果を推奨または保証するものではなく、責任も負いません。ここに記載されている内容は、投資助言ではありません。サードパーティ製ツールによる遅延から生じる価格差を含め、お客様の取引判断はすべてお客様自身の責任であり、適用される規約および法律を遵守する必要があります。

Capital Com (UK) Ltd に登録された個人顧客は、暗号資産デリバティブを利用できません。

• ライブ取引を検討する前に、必ずデモ口座で始めてください
• 取引機能はデフォルトで有効になっており、設定で無効にできます
• すべての取引操作には、2 段階の実行（プレビュー → 確認 → 実行）が必要です
• 組み込みのリスク管理機能：許可リスト、サイズ制限、1 日あたりの注文上限
• ご自身の責任でご利用ください — 作者は取引損失について一切責任を負いません

ご質問や確認事項については、FAQ をご覧ください：https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

クイックスタートガイド

ステップ 1：Capital.com API 認証情報を取得する

1. アカウントを作成する：capital.com/trading/signup にアクセスします

   • テストにはデモ口座を選択してください（推奨）
   • メールアドレスを認証します

2. 2FA を有効にする：Settings > Security > Two-Factor Authentication

   • API キーの生成前に有効にする必要があります

3. API キーを生成する：Settings > API integrations > Generate new key

   • ラベルを設定します（例：「MCP Server」）
   • カスタムパスワードを設定します（プラットフォームのパスワードとは異なります）
   • 表示された API キーを保存します（表示されるのは 1 回のみです！）
   • 注意：API キーでは取引が可能です。Capital.com は読み取り専用のキーを提供していません

ステップ 2：インストールと設定

AI ガイド付きインストール： このプロジェクトフォルダーを AI 搭載エディター（Claude Code、Cursor、Windsurf）で開き、Capital.com MCP サーバーのインストールを依頼してください。INSTALL.md に沿って設定を案内し、ご利用の環境に最適な方法を選択します。

手動でインストールする方法もあります。

オプション A：MCPB バンドルを使ったワンクリックインストール（推奨）

リポジトリにはビルド済みの capital-mcp.mcpb バンドルが含まれています。Claude Desktop で開くだけで完了し、設定ファイルを手動で編集する必要はありません。

手順：

1. リポジトリをクローンします：

   git clone https://github.com/capital-com-sv/capital-mcp.git
   cd capital-mcp
   

2. Claude Desktop で capital-mcp.mcpb を開きます（ダブルクリックするか、アプリにドラッグします）。
3. Claude Desktop から認証情報（API キー、識別子、パスワード）と取引管理設定を求められます。入力して Install をクリックします。
4. Claude Desktop を再起動し、「Capital.com で利用できるツールは何ですか？」と質問して確認します。

オプション B：スクリプトを使った手動インストール

前提条件： Python 3.10 以降と Git がインストールされている必要があります。

• macOS：brew install python3 git
• Ubuntu/Debian：sudo apt install python3 python3-venv git
• Windows：python.org（インストール時に「Add to PATH」にチェックを入れてください）＋ git-scm.com

Mac/Linux：

cd /path/to/capital-mcp
./install.sh

Windows（PowerShell）：

cd C:\path\to\capital-mcp
pwsh install.ps1

インストールスクリプトにより仮想環境が作成され、依存関係がインストールされます。また、MCP クライアントの設定が表示されます。

認証情報を使って .env を編集します：

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
[email protected]
CAP_API_PASSWORD=your_custom_api_password

# Trading controls
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=ALL

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# Narrow the allowlist to the instruments you actually trade
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

オプション C：Docker

前提条件： Docker がインストールされている必要があります。

1. 認証情報を記載した .env ファイルを作成します（.env.example を参照）：

   CAP_ENV=demo
   CAP_API_KEY=your_api_key_here
   [email protected]
   CAP_API_PASSWORD=your_custom_password
   CAP_ALLOW_TRADING=false
   

2. サーバーを実行します：

   docker run -i --rm --env-file .env ghcr.io/capital-com-sv/capital-mcp:latest
   

トラブルシューティング：ログを確認する

Claude Desktop やその他のクライアントで MCP サーバーを使用中に問題が発生した場合は、ログファイルを確認してください。

macOS：

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux：

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

Windows：

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

---

クライアント統合

クライアントごとの設定（Claude Desktop、Claude Code、Cursor、Windsurf、Codex、Docker、カスタムクライアント）については、USAGE.md — クライアント統合をご覧ください。

使用例

Claude Desktop との会話例

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

取引実行ワークフロー（取引が有効な場合）

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

環境変数リファレンス

必須

• CAP_ENV - 環境：demo または live（デフォルト：demo）
• CAP_API_KEY - Capital.com の API キー
• CAP_IDENTIFIER - ログイン用メールアドレス
• CAP_API_PASSWORD - API キー用のカスタムパスワード

リスク管理（推奨）

• CAP_ALLOW_TRADING - 取引を有効にする（デフォルト：true）
• CAP_ALLOWED_EPICS - 取引を許可する銘柄（デフォルト：ALL、すべての銘柄）。「SILVER,GOLD,BTCUSD」のようにカンマ区切りのリストで制限できます。空の場合、すべての取引がブロックされます
• CAP_MAX_POSITION_SIZE - 最大ポジションサイズ（デフォルト：1.0）
• CAP_MAX_WORKING_ORDER_SIZE - 最大注文サイズ（デフォルト：1.0）
• CAP_MAX_OPEN_POSITIONS - 同時に保有できる最大ポジション数（デフォルト：3）
• CAP_MAX_ORDERS_PER_DAY - 1日の注文上限（デフォルト：20）
• CAP_REQUIRE_EXPLICIT_CONFIRM - confirm=true を必須にする（デフォルト：true）
• CAP_DRY_RUN - すべての取引実行をブロックする（デフォルト：false）

任意

• CAP_DEFAULT_ACCOUNT_ID - ログイン後のデフォルトアカウント
• CAP_HTTP_TIMEOUT_S - HTTP タイムアウト（デフォルト：15）
• CAP_LOG_LEVEL - ログレベル：DEBUG、INFO、WARNING、ERROR（デフォルト：INFO）

MCP の機能

6 カテゴリにわたる38 個のツール、7 個のワークフロープロンプト、4 個の読み取り専用リソースを備えています。

カテゴリ	ツール数	説明
セッション	4	ログイン、ログアウト、ステータス、キープアライブ
市場データ	6	検索、詳細、価格、センチメント、ナビゲーション
アカウント	6	アカウント一覧、設定、アクティビティ／取引履歴、デモ口座への入金
取引	13	プレビュー、実行、ポジション決済、未約定注文の一覧表示／キャンセル／変更、確認
ウォッチリスト	6	ウォッチリストの作成、一覧表示、取得、削除、市場の追加／削除
ストリーミング	3	WebSocket によるリアルタイム価格、アラート、ポートフォリオの損益

プロンプト	説明
market_scan	ウォッチリストをスキャンして取引条件を確認します
trade_proposal	リスクに基づくサイズ設定で取引を計画します（プレビューのみ）
execute_trade	以前にプレビューした取引を実行します
position_review	オープンポジションとエクスポージャーを分析します（読み取り専用）
live_price_monitor	価格変動アラート付きでリアルタイムの価格を追跡します（WebSocket）
real_time_alerts	条件付きの価格水準アラートを設定します（WebSocket）
live_portfolio_monitor	リアルタイムのポートフォリオ損益ダッシュボード（WebSocket）

リソース	説明
cap://status	サーバーの健全性、セッション状態、レート制限
cap://risk-policy	リスク管理設定と検証レイヤー
cap://allowed-epics	取引許可リストの設定
cap://market-cache/{epic}	キャッシュされた市場の詳細（ライブ取得）

詳細、パラメーター、例については、USAGE.mdをご覧ください。

取引実行プロセス

必須の 2 段階実行

副作用を伴うすべての操作では、プレビュー → 実行の厳格なフローを使用します。

1. プレビュー：ブローカーのルールとローカルのリスクポリシーに照らして取引を検証します

   • 正規化されたリクエストとリスクチェックを含む preview_id を返します
   • 副作用のない読み取り専用の検証です

2. 実行：preview_id を使用して取引を送信します

   • 重要なチェックを再実行します
   • CAP_REQUIRE_EXPLICIT_CONFIRM=true の場合は confirm=true が必要です
   • ブローカーからの確認をポーリングします
   • 1日の注文カウンターを増やします

リスク管理

• 許可リスト：CAP_ALLOWED_EPICS に含まれる EPIC のみ取引できます。デフォルトの ALL ではすべての銘柄が許可されます
• サイズ制限：ポジション／注文の最大サイズを適用します
• ポジション制限：同時に保有できるオープンポジション数を制限します
• 日次制限：1日の注文数を制限します
• サイズの正規化：ブローカーの最小値／最大値／増分に合わせて丸めます
• ドライランモード：有効にすると、すべての実行をブロックします

ドキュメント

• 使用ガイド：USAGE.md - 例を含む包括的な使用ガイド
• Capital.com API リファレンス：https://open-api.capital.com/
• Capital.com API Postman コレクション：https://github.com/capital-com-sv/capital-api-postman

ライセンス

MIT

プライバシーポリシー

Capital.com MCP サーバーはお使いのマシン上でローカルに実行され、ユーザーが提供する認証情報を使用して Capital.com Public API と直接通信します。ホスト型サービスとして運営されておらず、独自のサーバーもありません。

データ収集

MCP サーバーはデータを収集または保存しません。AI クライアントと Capital.com Public API の間をつなぐローカルブリッジとして機能します。

データの使用と保存

セッション中にやり取りされるすべてのデータは、お使いのローカルマシン上でメモリ内処理され、セッション終了時に破棄されます。MCP サーバーによってディスクにデータが書き込まれることはありません。注：AI クライアントは、独自のプライバシーポリシーに従って、経由するデータを処理、記録、または保存する場合があります。別途、そのポリシーをご確認ください。

第三者との共有

MCP サーバーは第三者とデータを共有しません。データは、お使いのローカル環境と Capital.com Public API の間でのみやり取りされ、Capital.com 独自のプライバシーポリシーが適用されます。

データの保持

MCP サーバーはデータを保持しません。セッションデータは、セッション中のみメモリ内に存在します。

API 認証情報

提供された API 認証情報は、お使いのローカル環境に保存され、管理されます。適切に保護する責任はユーザーにあります。

お問い合わせ

Capital.com アカウントのプライバシー、または Capital.com によるデータの取り扱いに関するお問い合わせは、Capital.com プライバシーポリシーをご覧いただくか、[email protected] までご連絡ください。

免責事項 – Capital.com Public API とサードパーティツールの利用

サードパーティとの連携

このページでは、AI や大規模言語モデル（「LLM」）を活用したものを含め、クライアントが Capital.com Public API をサードパーティのソフトウェア、ツール、または連携機能に接続する方法について説明します。このようなサードパーティのソフトウェア、ツール、または連携機能は、いずれも Capital.com から独立しており、Capital.com のサービスの一部ではありません。Capital.com は、サードパーティのソフトウェア、その機能、出力、またはその使用によって生じる結果について、管理、開発、推奨を行わず、いかなる責任も負いません。Capital.com Public API に関連してサードパーティのツールや連携機能を使用する場合は、すべて自己責任となります。利用するサードパーティツールの利用規約、プライバシーポリシー、およびデータ取り扱いの方針を確認する責任はユーザーにあります。

Public API の利用

Capital.com Public API の利用は、すべてユーザー自身の判断とリスクにおいて行うものとします。Capital.com は情報提供および取引を目的として Public API を提供しますが、特定の利用方法、連携機能、または取引戦略を推奨、支持、奨励するものではありません。API へのアクセス方法および利用方法については、送信する注文のパラメーター、接続するツールやシステムの設定、受信したデータの解釈を含め、すべてユーザーが単独で責任を負います。API に直接アクセスする場合も、サードパーティツールを介してアクセスする場合も、API の利用によって生じる損失または意図しない結果について、Capital.com は一切責任を負いません。API の可用性、機能、および仕様は、事前の通知なくいつでも変更、レート制限、一時停止、または終了される場合があります。Public API の利用には Capital.com の利用規約および電子取引規約が適用されます。API を利用する前に、これらをよくお読みください。

執行専用サービスおよび投資助言の禁止

Capital.comは、執行専用の形でサービスを提供しています。金融商品取引には、重大な損失が生じるリスクが伴います。このページ、Public API、またはサードパーティ製ソフトウェアや連携機能に含まれる内容は、投資助言、個人的な推奨、または金融商品の売買の勧誘を構成するものではありません。これには、AI、LLMベース、その他の自動化ツールが生成する出力、シグナル、提案、分析が含まれます。自動化またはアルゴリズムによる取引を含むすべての取引判断は、お客様ご自身のリスクで行われ、お客様ご自身の責任となります。Capital.comは、Public APIに接続されたサードパーティ製AIまたはLLMベースのツールの出力を管理しておらず、それらのツールが投資助言または個人的な推奨と解釈される可能性のある内容を生成しないことを保証できません。そのような出力は、Capital.comによって、またはCapital.comを代表して提供されるものではなく、助言として依拠すべきではありません。

自動取引およびアルゴリズム取引のリスク

自動取引またはアルゴリズム取引ツールに関連してPublic APIを使用する場合、人による確認や介入なしに注文が迅速に執行されること、システムエラー、ソフトウェア障害、接続の問題、予想と大きく異なる価格での執行、設定ミスのあるツールやパラメーターに起因する意図しない注文や誤った注文などを含む追加のリスクが伴います。Capital.comは、こうしたリスク、またはCapital.comのシステムとサードパーティ製ツールとの相互作用から生じる損失について責任を負いません。過去の実績や自動化ツールが生成する出力は、将来の結果を示すものではありません。

AIまたはLLMベースのツールを使用して市場データや価格情報を取得する場合、ツールが通知する価格と、その結果として注文が執行される価格との間に遅延が生じる可能性があります。Public APIを通じて発注されるすべての注文は、成行注文として執行されます。そのため、執行価格は、リクエスト時に表示された価格と異なる場合があります。Capital.comは、義務に従って最良執行の実現に努めますが、Capital.comの管理外にあるサードパーティ製ツールまたはシステムに起因する遅延から生じる価格差について、責任を負いません。

禁止されている使用

Public APIおよび接続されたツールを、Capital.comのプラットフォームの操作、価格や遅延の悪用、市場濫用、不当な優位性の獲得に使用してはなりません。Capital.comは、そのような不正使用があった、または発生する可能性があると合理的に判断した場合、APIアクセスおよび／またはお客様のアカウントを制限、一時停止、または終了する権利を留保します。クライアントは、第三者に自分のアカウントの裁量権を行使させてはなりません。

お客様の責任

Capital.comのプラットフォーム、Public API、およびサードパーティ製ツールや連携機能の使用が、Capital.comの利用規約、電子取引規約、およびお客様の管轄区域で適用されるすべての法律や規制に準拠していることを確認する責任は、お客様にあります。自動取引ツールを使用する前に、ご自身の状況、経験、リスク許容度に照らして、それらのツールが適切かどうかを慎重に検討してください。Capital.comは、自動化ツールや連携機能をライブ取引環境に接続する前に、デモ口座を使用して十分にテストすることを強く推奨します。