Capital.com Public API MCP Server

公式

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

GitHub
5
このMCPを試すスポンサー

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

  • セッション状態の確認 — 取引前に、cap_session_status を使用してアシスタントにログイン状態と環境を確認させます。
  • 市場の検索 — cap_market_search を使用して「Bitcoin」などの取引可能な銘柄を検索し、EPICコードを取得します。
  • 取引のプレビュー — 実行前に、cap_trade_preview_position でリスクチェック済みの取引プレビューをリクエストし、サイズと制限を検証します。
  • 確認済み取引の実行 — 事前にプレビューしたポジションを、明示的な確認を伴う cap_trade_execute を使用して送信します。許可リストとサイズ上限の対象となります。
  • オープンポジションの一覧表示 — cap_trade_positions_list で現在の保有を取得し、エクスポージャーを確認してポートフォリオを管理します。
  • ライブ価格の監視 — 選択した市場について、live_price_monitor プロンプトを介してリアルタイムの価格追跡とアラートを設定します。

ドキュメント

Capital.com MCP Server

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 を有効化: 設定 > セキュリティ > 2段階認証

    • API キーを生成する前に必要

  3. API キーを生成: 設定 > API 連携 > 新しいキーを生成

    • ラベルを設定（例: "MCP Server"）
    • カスタムパスワードを設定（プラットフォームのパスワードとは異なります）
    • 表示された API キーを保存（一度しか表示されません！）
    • 注: 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 キー、識別子、パスワード）と取引制御の入力を求めます。入力してインストールをクリック。
  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
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Trading controls (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

オプション C: Docker

前提条件: Docker がインストールされていること。

  1. 認証情報を記載した .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

  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 - 取引を有効化（デフォルト: false）
  • CAP_ALLOWED_EPICS - カンマ区切りの許可リスト（例: "SILVER,GOLD,BTCUSD"）または無制限の場合は "ALL"
  • 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ウォッチリストの作成、一覧、取得、削除、マーケットの追加/削除
ストリーミング3WebSocket によるリアルタイム価格、アラート、ポートフォリオ損益
プロンプト説明
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 のみ取引可能
  • サイズ制限: 最大ポジション/注文サイズを強制
  • ポジション制限: 任意の時点での最大オープンポジション数
  • 1日制限: 1日の最大注文数
  • サイズ正規化: ブローカーの最小/最大/増分に丸め
  • ドライラン モード: 有効時はすべての実行をブロック

ドキュメント

ライセンス

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は、自動ツールまたは統合をライブ取引環境に接続する前に、デモアカウントを使用して徹底的にテストすることを強く推奨します。