如何設定 Capital.com AI MCP 伺服器

Capital.com MCP 伺服器可讓您將 AI 助手（例如 Claude Code、Codex、Claude Desktop、Cursor 或 Windsurf）連接至您的交易帳戶。完成設定後，您可以使用自然語言分析市場、查看帳戶資料、檢視未平倉持倉和掛單，並透過 AI 助手預覽交易及下單。

本指南會逐步引導您完成每個步驟，從建立 API 憑證和安裝伺服器，到連接您選擇的 AI 助手，以及在執行每筆交易前檢視和確認交易。您不需要是開發人員，但應能夠輕鬆按照技術說明操作。我們建議您先使用模擬帳戶模式，然後再切換至真實帳戶。

什麼是 Capital.com MCP 伺服器？

Capital.com MCP（Model Context Protocol）伺服器是一款免費的開源工具，可讓您使用 Capital.com API 憑證和雙重認證 (2FA)，將 AI 助手連接至您的交易帳戶。 它會在您的帳戶與 AI 之間充當橋樑，讓助手能夠存取市場和帳戶數據，並即時回應您的指示。 

連接後，您的 AI 助手可以： 

• 搜尋可用市場（例如外匯、股票、大宗商品和指數）。
• 顯示您的未平倉持倉、掛單和帳戶資料。
• 擷取歷史價格和客戶情緒數據。
• 預覽並執行交易；執行前必須獲得您的明確確認。 

您仍須對透過 MCP 伺服器作出的任何交易決定承擔全部責任。確認前，請務必仔細檢視交易預覽。

我可以使用哪些 AI 智能助手？

本指南涵蓋 Claude Code、Codex、Claude Desktop、Cursor 和 Windsurf 的設定方法。 

如果您不確定應從哪裡開始，而您又熟悉終端機，Claude Code 可能是一個實用選項。 如果您較傾向編輯設定檔，Claude Desktop 可能更適合您。

步驟 1. 建立您的 API 憑證

首先，請在您的 Capital.com 帳戶內產生 API 憑證。此流程大約需時兩分鐘。

1. 登入您的 Capital.com 帳戶。
2. 啟用雙重認證 (2FA)。
3. 前往「設定 (Settings)」→「API 整合 (API Integrations)」→「產生新金鑰 (Generate New Key)」。
4. 為您的金鑰新增標籤，例如：MCP Server。
5. 建立自訂 API 密碼。此密碼與您平常使用的 Capital.com 登入密碼不同。
6. 輸入您的 2FA 代碼並產生金鑰。
7. 立即複製 API 金鑰。之後將不會再次顯示。

您在後續步驟中需要以下值：

*進行真實交易前，請先使用模擬帳戶練習。

重要提示：這些憑證可用於存取您的交易帳戶。請妥善保管。切勿與他人分享，亦不要貼到聊天介面或儲存在公開文件中。任何取得這些資料的人都可能透過 API 存取您的帳戶。

步驟 2. 安裝 Capital.com MCP 伺服器

這是一次性安裝。您有兩個選項，建議大多數用戶使用選項 A。

選項 A. 快速安裝（建議）

MCP 伺服器包含一個 bundle 檔案，可讓 Claude Desktop 為您處理安裝，無需使用終端機或編輯設定檔。

開始前：請確保已安裝 uv（例如在 Mac 上透過 brew install uv 安裝），並已安裝 Node.js 以使用 pack 指令。

1. 在您的終端機中，複製程式碼庫並建立 bundle：

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

cd capital-mcp

npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

2. 連按兩下 capital-mcp.mcpb 將其開啟，或將其拖入 Claude Desktop。
3. Claude Desktop 會提示您輸入 API 憑證。請輸入憑證，然後按一下「安裝 (Install)」。
4. 重新啟動 Claude Desktop，並透過提問以下內容驗證連接：'What Capital.com tools are available?'

選項 B. 手動安裝

如果您不想使用 bundle，或正在連接 Codex、Cursor 或 Windsurf，請使用此選項。

終端機 (Mac)

1. 下載伺服器檔案

cd ~/Desktop

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

cd capital-mcp

2. 建立獨立的 Python 環境並安裝依賴項

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. 找到您的 Python 路徑

下一步需要使用此路徑：

which python

這應會傳回類似以下的檔案路徑：

/Users/you/Desktop/capital-mcp/venv/bin/python

複製並儲存此路徑。您會在步驟 3 中將其貼到 AI 智能助手設定內。

提示：在 Mac 上，您可以將 Finder 中的檔案拖入終端機視窗，以顯示其完整路徑。

4. 檢查伺服器是否能正確啟動

python -m capital_mcp.server

如果沒有出現錯誤，表示安裝已完成。如果您看到錯誤，請先解決；在此階段，錯誤訊息通常比在 AI 助手介面中更容易診斷。

命令提示字元 (Windows)

1. 下載伺服器檔案

cd %USERPROFILE%\Desktop

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

cd capital.com-public-api-mcp

這會將程式碼庫下載至您的桌面，並開啟專案資料夾。

2. 建立虛擬環境並安裝依賴項

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

這會建立一個虛擬環境，讓專案依賴項與系統其他部分分開。啟用該環境後，可確保套件安裝在該環境中。

3. 找到您的 Python 路徑

下一步需要使用此路徑：

where python

您應會看到類似以下的內容：

C:\Users\you\Desktop\capital.com-public-api-mcp\venv\Scripts\python.exe

複製並儲存此路徑。您會在步驟 3 中將其貼到 AI 助手設定內。

4. 檢查伺服器是否能正確啟動

python -m capital_mcp.server

如果沒有出現錯誤，表示安裝已完成。如果您看到錯誤，請先解決再繼續。

步驟 3. 連接您的 AI 智能助手

所有 AI 助手都需要相同的核心資料。開始前，請準備以下內容：

Claude Code 設定 

在您的終端機中執行：

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

請將 /path/to/capital-mcp/venv/bin/python 替換為您在步驟 2 中複製的 Python 路徑。

如要確認連接，請向 Claude 提問：'What Capital.com tools are available?' 您應會看到列出 36 個工具。

Codex 設定 

前往「Codex」→「設定 (Settings)」→「MCP 伺服器 (MCP Servers)」→「新增伺服器 (Add Server)」，並填寫以下欄位。

指令 (Command)

貼上您的 venv Python 路徑，例如：

/Users/you/Desktop/capital.com-public-api-mcp/venv/bin/python

引數 (Arguments)

將以下內容新增為兩個獨立項目，請勿合併：

1. -m
2. capital_mcp.server

環境變數 (Environment variables)

逐一新增每個變數：

工作目錄 (Working directory)

將工作目錄設定為 ~/code。

儲存設定並重新啟動 Codex。

在聊天中輸入 /mcp，您應會看到列出 capital-com。

如要確認連接，請傳送以下三則訊息：

Check my Capital.com session status

Login to my Capital.com account

List my accounts

如果三者均傳回有效回覆，表示伺服器已正確連接。

Claude Desktop 設定

終端機 (Mac)

開啟終端機並執行以下指令以建立設定檔：

mkdir -p ~/Library/Application\ Support/Claude

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

命令提示字元 (Windows)

開啟命令提示字元 (CMD) 並執行：

mkdir "%APPDATA%\Claude"

notepad "%APPDATA%\Claude\claude_desktop_config.json"

終端機 (Mac) 和命令提示字元 (Windows)

將以下範本貼到檔案中，並將每個 ALL CAPS 預留位置替換為您的實際值：

{

  "mcpServers": {

"capital-com": {

   "command": "/PASTE/YOUR/VENV/PYTHON/PATH",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "PASTE_API_KEY",

     "CAP_IDENTIFIER": "PASTE_YOUR_EMAIL",

     "CAP_API_PASSWORD": "PASTE_API_PASSWORD",

     "CAP_ALLOW_TRADING": "false",

     "CAP_ALLOWED_EPICS": ""

   }

    }

  }

}

儲存檔案：按 Ctrl + O，然後按 Enter，再按 Ctrl + X。重新啟動 Claude Desktop。

如要確認連接，請向 Claude 提問：‘What Capital.com tools are available?’’

您應會看到列出 36 個工具。如果顯示的工具少於 36 個，請查看下方的疑難排解部分。

Cursor 設定

前往「設定 (Settings)」→「工具與 MCP (Tools & MCPs)」，然後新增：

{

  "capital-com": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "capital_mcp.server"],

"env": {

   "CAP_ENV": "demo",

   "CAP_API_KEY": "your_api_key",

   "CAP_IDENTIFIER": "your_email",

   "CAP_API_PASSWORD": "your_password",

   "CAP_ALLOW_TRADING": "false"

}

  }

}

重新啟動 Cursor，並使用以下內容測試連接：

List my accounts

如果指令傳回您的帳戶資料，表示整合已正常運作。

Windsurf 設定

建立或編輯 ~/.windsurf/mcp/servers.json 檔案，並新增：

{

  "mcpServers": {

"capital-com": {

   "command": "/path/to/capital-mcp/venv/bin/python",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "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"

   }

    }

  }

}

重新啟動 Windsurf，並使用以下內容測試連接：‘List my accounts’。

重新啟動風帆衝浪並測試連接：‘列出我的帳戶’。

如何使用 MCP 伺服器交易

每一筆通過 MCP 伺服器進行的交易都遵循一個強制性的三步驟過程。透過 MCP 伺服器進行的每筆交易都必須遵循三步流程。

步驟 1 – 預覽您的交易

請要求 AI 智能助手預覽一筆交易。它會傳回一項提案和一個唯一的 preview_id。

範例：

Preview buying 1.5[instrument] with stop at 24.50

步驟 2 – 檢視提案

採取任何進一步操作前，請仔細閱讀 AI 傳回的詳情。請檢查金融工具、數量、方向和風險參數，確保它們符合您的意圖。

如果您要求的數量低於該金融工具的經紀商最低要求，或高於經紀商最高限制，伺服器會傳回錯誤。請調整數量並建立新的預覽。

步驟 3 – 確認執行

如果您想繼續，請傳送第二則訊息進行確認：

Execute position with preview_id abc123 confirm=true

沒有已完成預覽所產生的有效 preview_id，便無法下單。伺服器要求在執行前完成這兩個步驟。

每個預覽 ID 只能使用一次。交易確認並執行後，該預覽會立即失效。如要進行另一筆交易，請開始新的預覽。

切換至真實帳戶前

請確認以下所有事項：

• 所有測試均已在模擬模式中完成（CAP_ENV = demo）。
• 整個設定過程中，CAP_ALLOW_TRADING 一直保持為 false。
• 工作階段登入、帳戶列表和市場數據均正常運作
• 已在模擬帳戶中成功測試完整的預覽和執行流程。
• 您已慎重決定將 CAP_ENV 切換至 live，並將 CAP_ALLOW_TRADING 切換至 true。

如要限制伺服器可交易的市場，請在 CAP_ALLOWED_EPICS 中新增以逗號分隔的金融工具代碼清單。如留空，則允許存取您帳戶中所有可用市場。

疑難排解：常見錯誤和修正方法 {#errors}

我可以向 AI 智能助手提出什麼要求？ 

連接後，您可以從以下提示詞範例開始：

查看您的帳戶

Check my session status

Login to my account

List my accounts

研究市場

Search for bitcoin markets

Show me [instrument] market details

Get 1-hour historical prices for [instrument]

What is client sentiment on [instrument]?

檢視您的投資組合

Show my open positions

List my working orders

Review my portfolio exposure

下單交易（請先從模擬模式開始）

Create a trade proposal for [instrument] with 1% risk

Preview buying 1.5 [instrument] with stop at 24.50

Execute position with preview_id abc-123 confirm=true

Close position DEAL_ID confirm=true

金融工具代碼區分大小寫。請使用大寫 epic（例如 SILVER，而非 silver）以避免錯誤。

確認執行前，請務必仔細檢視交易預覽。AI 生成的輸出是支援您分析的工具。它們不能取代您的判斷，也不能消除差價合約交易相關風險。

常見問題

我是否需要真實 Capital.com 帳戶才能使用 MCP 伺服器？

不需要。MCP 伺服器可與模擬帳戶配合使用。您可以先在模擬模式中完成設定和測試，然後再連接真實帳戶。

我的 Capital.com 登入密碼是否與 CAP_API_PASSWORD 相同？

不是。兩者是不同的密碼。CAP_API_PASSWORD 是您在產生 API 金鑰時建立的自訂密碼。在此欄位使用登入密碼是常見的設定錯誤，會導致認證失敗。

AI 是否可以未經我許可便下單交易？

不可以。每筆交易都需要先完成預覽步驟，再透過包含 confirm=true 的獨立明確確認訊息確認。若未完成這兩個步驟，伺服器不會執行交易。您必須明確確認每筆交易，交易才會執行。

什麼是 CAP_ALLOW_TRADING，我應該開啟它嗎？

CAP_ALLOW_TRADING 是一項設定，用於控制伺服器是否可以執行交易。設定和測試期間，請將其保持為 false。只有在您已於模擬模式中完全驗證連接，並了解真實差價合約交易風險後，才應將其改為 true。

CAP_ALLOWED_EPICS 有什麼作用？

它會限制伺服器只能交易特定金融工具。如果留空，則可存取您帳戶中所有可用市場。新增以逗號分隔的金融工具 epic 代碼清單，即可將交易限制為所選市場。

我已完成所有設定，但 Claude 顯示的工具少於 36 個。問題在哪裡？

伺服器未能正確啟動。請執行 tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log 查看記錄輸出。常見原因包括設定檔中有 JSON 語法錯誤，或 Python 路徑指向系統 Python，而非虛擬環境。

免責聲明 – 將 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，還是透過第三方工具存取 API。API 的可用性、功能和規格可能會在不事先通知的情況下隨時修改、受速率限制、暫停或終止。您使用 Public API 須受 Capital.com 的條款及細則和電子交易條款約束，您應在使用 API 前仔細閱讀。

僅執行交易服務及不提供投資建議 

Capital.com 以僅執行交易的方式提供服務。交易金融工具涉及重大虧損風險。本頁、Public API 或任何第三方軟件或整合中的任何內容，均不構成投資建議、個人推薦，亦不構成買入或賣出任何金融工具的招攬。這包括由 AI、基於 LLM 的工具或其他自動化工具生成的任何輸出、訊號、建議或分析。所有交易決定，包括任何自動化或演算法活動，均由您自行承擔風險，並由您全權負責。

自動化和演算法交易的風險

將 Public API 與自動化或演算法交易工具配合使用會帶來額外風險，包括但不限於：訂單在未經人工檢視或干預的情況下快速執行；系統錯誤、軟件故障或連接問題；以與預期存在重大差異的價格執行；以及因工具或參數設定錯誤而產生非預期或錯誤訂單。Capital.com 不對此類風險，或其系統與任何第三方工具之間互動所產生的任何損失承擔責任。過往表現以及自動化工具生成的任何輸出，均不代表未來結果。

禁止用途

Public API 及任何已連接工具不得用於操縱 Capital.com 平台、利用定價或延遲差異、從事市場濫用行為，或取得任何不公平優勢。如 Capital.com 合理認為已發生或可能發生此類濫用行為，Capital.com 保留限制、暫停或終止 API 存取權及/或您帳戶的權利。客戶不得允許任何第三方對其帳戶行使酌情控制權。

您的責任

您有責任確保您使用 Capital.com 平台、Public API 以及任何第三方工具或整合時，均遵守 Capital.com 的條款及細則、電子交易條款，以及您所在司法管轄區的所有適用法律和法規。使用自動化交易工具前，您應仔細考慮這些工具是否適合您的情況、經驗和風險承受能力。Capital.com 強烈建議您先使用模擬帳戶充分測試任何自動化工具或整合，然後再將其連接至真實交易環境。