Capital.com Public API MCP Server

公式

Capital.com MCP Serverを使用すると、AIアシスタントが取引アカウントと直接対話できます。マーケットデータ、ポジション確認、トレードプレビューなど、すべてを平易な言葉で、AIツールから離れることなく実行できます。

GitHub

Capital Com Public API MCPで何ができますか？

セッションステータスの確認 — アシスタントに、capital-mcp.mcpb を介してCapital.comのデモ口座またはライブ口座にログインしているかどうかを確認してもらいます。
市場の検索 — アシスタントに、Bitcoinペアなどの取引可能な銘柄を検索してもらい、その詳細と現在価格を返してもらいます。
取引のプレビュー — リスクチェック済みの取引プレビューをリクエストします（例：「1.0 SILVERの買いをプレビュー」）。これにより、注文を出さずにサイズと制限を検証します。
確定済み取引の実行 — アシスタントに、以前プレビューしたポジションを、明示的な確認を伴う preview_id を使用して送信するよう指示します。
オープンポジションの一覧表示 — アシスタントに、Capital.comアカウントの現在のオープンポジションとその詳細を表示してもらいます。
ライブ価格の監視 — WebSocketストリーミングを介して、特定の市場のリアルタイム価格追跡とアラートを設定します。

ドキュメント

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認証情報を取得する

アカウント作成：capital.com/trading/signupにアクセス
- テスト用にデモ口座を選択（推奨）
- メールアドレスを確認
2FAを有効化：設定 > セキュリティ > 2段階認証
- APIキーを生成する前に必要です
APIキーを生成：設定 > API連携 > 新しいキーを生成
- ラベルを設定（例：「MCPサーバー」）
- カスタムパスワードを設定（これはプラットフォームのパスワードではありません）
- 表示されたAPIキーを保存（一度しか表示されません！）
- 注：APIキーは取引が可能です。Capital.comは読み取り専用キーを提供していません

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

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

手動インストールのオプションもあります：

オプションA：MCPBバンドルによるワンクリックインストール（推奨）

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

手順：

リポジトリをクローン：

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

Claude Desktopでcapital-mcp.mcpbを開きます（ダブルクリック、またはアプリにドラッグ＆ドロップ）。
Claude Desktopが認証情報（APIキー、識別子、パスワード）と取引管理について入力を求めます。入力して「インストール」をクリックします。
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
CAP_IDENTIFIER=your_email@example.com
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がインストールされている必要があります。

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

CAP_ENV=demo
CAP_API_KEY=your_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_password
CAP_ALLOW_TRADING=false

サーバーを実行：

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段階実行

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

プレビュー：ブローカーのルールとローカルのリスクポリシーに対して取引を検証
- 正規化されたリクエストとリスクチェックを含むpreview_idを返します
- 副作用なし、読み取り専用の検証
実行：preview_idを使用して取引を送信
- 重要なチェックを再実行
- CAP_REQUIRE_EXPLICIT_CONFIRM=trueの場合はconfirm=trueが必要
- ブローカーの確認をポーリング
- 1日の注文カウンターを増加

リスク管理

許可リスト：CAP_ALLOWED_EPICS内のEPICのみ取引可能。デフォルトのALLはすべての銘柄を許可
サイズ制限：最大ポジション/注文サイズを強制
ポジション制限：任意の時点での最大オープンポジション数
1日制限：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プライバシーポリシーを参照するか、support@capital.comまでお問い合わせください。

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

サードパーティ連携

このページでは、クライアントがCapital.com Public APIをサードパーティ製ソフトウェア、ツール、または連携（人工知能や大規模言語モデル（LLM）を利用したものを含む）に接続する方法について説明します。このようなサードパーティ製ソフトウェア、ツール、または連携はCapital.comから独立しており、Capital.comのサービスの一部を構成するものではありません。Capital.comは、サードパーティ製ソフトウェア、その機能、出力、またはその使用から生じる結果について、管理、開発、推奨、または責任を負いません。Capital.com Public APIに関連してサードパーティ製ツールや連携を使用する場合は、すべて自己責任で行ってください。選択したサードパーティ製ツールの利用規約、プライバシーポリシー、データ処理慣行を確認する責任はお客様にあります。

Public APIの使用

Capital.com Public APIの使用は、すべてお客様自身の判断と責任で行われます。Capital.comは、Public APIを情報提供および取引目的で利用可能にしますが、特定の使用、連携、または取引戦略を推奨、承認、または奨励するものではありません。APIへのアクセス方法と使用方法（送信される注文のパラメータ、接続されたツールやシステムの設定、受信したデータの解釈を含む）については、お客様が単独で責任を負います。Capital.comは、直接アクセスしたかサードパーティ製ツールを通じてアクセスしたかに関わらず、APIの使用から生じる損失や意図しない結果について責任を負いません。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は、これらのリスクまたは自社システムと第三者のツールとの相互作用から生じるいかなる損失に対しても責任を負いません。過去の実績および自動化ツールによって生成された出力は、将来の結果を示すものではありません。

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

禁止される使用

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

お客様の責任

お客様は、Capital.comプラットフォーム、Public API、および第三者のツールや統合の使用が、Capital.comの利用規約、電子取引規約、およびお客様の管轄区域のすべての適用される法律および規制に準拠していることを確認する責任があります。自動取引ツールを使用する前に、お客様の状況、経験、およびリスク許容度に適しているかどうかを慎重に検討する必要があります。Capital.comは、ライブ取引環境に接続する前に、デモ口座を使用して自動ツールや統合を徹底的にテストすることを強く推奨します。