Capital.com MCP 伺服器讓您的 AI 助手可直接連接您的交易帳戶。市場數據、倉位檢查、交易預覽——全部都能以簡明語言完成，而且無需離開您的 AI 工具。
您需要準備什麼
- Capital.com 帳戶
- 您的 Capital.com API 金鑰
- 您的自訂 API 密碼
- 已啟用 2FA
注意：您可以在帳戶設定中管理以上項目。
目前不支援流動裝置。
什麼是 Capital.com MCP 伺服器？
MCP 伺服器是在您的電腦背景中運行的軟件。它會作為您的 AI 助手與 Capital.com 帳戶之間的安全橋樑。
連接後，您的 AI 助手可以：
- 搜尋外匯、股票、大宗商品和指數等可用市場
- 顯示您的未平倉倉位、掛單和帳戶結餘
- 擷取歷史價格和其他市場數據
- 預覽並下單交易——每次都需要您確認
您仍須對透過 MCP 伺服器作出的任何交易決定承擔全部責任。確認前，請務必仔細檢視交易預覽。
開始前需要檢查的事項
請確認您已安裝所有所需項目。如果以下任何問題的答案為「否」，您需要先按照提供的連結完成相關步驟，然後再繼續。
| 檢查 | 是 | 否 |
|---|---|---|
| 您是否擁有 Capital.com 帳戶？ | 繼續 | 建立帳戶 |
| 您是否已安裝偏好的 AI 工具？ | 繼續 | 建議工具包括： Claude Code、 Claude Desktop、 Codex、 Cursor、 Windsurf. |
| 您使用的是 Mac 還是 Windows？ | 繼續 | 目前不支援流動裝置 |
Claude Desktop：快速設定指南
如果您不需要詳細說明，以下是在桌面版 Claude Chat 上設定的簡短版本。
- 取得您的 API 憑證
- 登入您的 Capital.com 帳戶設定頁面，並取得您的 API 密碼。
- 從 GitHub 下載 MCP
- 開啟 MCPB 套件
- 按兩下套件即可啟動，或直接將檔案拖入 Claude Desktop 視窗。
- 輸入您的 API 憑證
- Claude Desktop 會要求您輸入 API 詳細資料。輸入資料後，選擇「Install」（安裝）。請不要忘記啟用 MCP。
- 重新啟動 Claude
- 完全關閉並重新開啟應用程式，然後詢問「List my accounts」（列出我的帳戶）以測試連接。
完整設置指南
步驟 1 – 建立您的 API 憑證
在您的 Capital.com 帳戶內：
- 如果尚未啟用 2FA，請先啟用。設定 (Settings) → 雙重認證 (Two-Factor Authentication)。.
- 產生新的 API 金鑰。前往「設定 (Settings)」→「API 整合 (API Integrations)」→「產生 API 金鑰 (Generate API Key)」。
- 為您的金鑰新增標籤，例如：MCP Server。
- 設定您的 API 密碼。
輸入任何內容前，請先閱讀：您正在建立一組全新的密碼，專門用於 API 存取。這組密碼不會與您的 Capital.com 登入密碼關聯。建議選擇一組您記得住的密碼，並妥善記錄下來。請勿在此重用您的登入密碼。將登入密碼與 API 密碼混淆，是常見的設定錯誤。
- 輸入您的 2FA 代碼，然後按一下「Generate」（產生）。
- 複製您的 API 金鑰，並重新確認您的 API 密碼。 兩者只會顯示一次。稍後您會需要用到它們。關閉此畫面後，它們將不再顯示。
請妥善保管。 切勿將它們貼到聊天介面、與他人分享，或儲存在共享文件中。任何取得這些資料的人，都可以透過 API 存取您的交易帳戶。
步驟 2 – 下載 MCP
Capital.com MCP 伺服器是開源軟件，存放於公開 GitHub 儲存庫中。您的 AI 工具使用 MCP 前，您需要先將一份程式碼複本下載到本機。
從 https://github.com/capital-com-sv/capital-mcp 將 MCP 程式碼下載到您的本機電腦
步驟 3 – 將 MCP 連接到您的 AI 工具
每款 AI 工具連接 MCP 的方式略有不同。我們在此說明如何連接 Claude Desktop；如需了解連接其他平台的方式，請參閱此處。
如使用 Claude Desktop，請按兩下 mcpb 檔案啟動，或直接將檔案拖入 Claude Desktop 視窗。
您會在 Claude Desktop 應用程式中看到以下彈出視窗。安裝 MCP 並將其啟用。
步驟 4 – 輸入您的憑證並設定環境
將您在步驟 1 取得的憑證輸入設定欄位
| 值 | 來源 |
|---|---|
| API 金鑰 | 您在步驟 1 取得的 API 金鑰 |
| CAP_IDENTIFIER | 您的 Capital.com 電郵地址 |
| CAP_API_PASSWORD | 您在步驟 1 建立的自訂 API 密碼 |
步驟 5 – 重新啟動您的 AI 工具並測試連接
重新啟動您的 AI 工具，然後逐一嘗試以下提示，以確認連接正常運作
Login to my Capital.com account（登入我的 Capital.com 帳戶）
List my accounts（列出我的帳戶）
Search for bitcoin markets（搜尋比特幣市場）
如何下單交易
每一筆透過 MCP 伺服器進行的交易，都必須遵循 3 個步驟。伺服器會強制執行此流程——您不能跳過任何步驟。
1. 預覽
請要求您的 AI 助手預覽一筆交易：
Preview buying 1.5 SILVER with stop at 24.50（預覽買入 1.5 SILVER，止蝕設於 24.50）
助手會返回完整的交易提案和一個唯一的 preview_id。繼續前，請仔細閱讀每項詳情。
2. 檢視
確認前，請檢查：
- 金融工具是否正確？（代碼區分大小寫：應為 SILVER，而不是 silver）
- 倉位規模是否符合您的原意？
- 止損和限價水平是否正確？
- 相對於您的帳戶規模，風險是否合理？
如有任何內容看起來不正確，請停止。請以修正後的參數要求新的預覽。
3. 確認
只有在您對預覽內容滿意時，才傳送以下內容：
Execute position with preview_id abc123 confirm=true（使用 preview_id abc123 執行倉位，confirm=true）
沒有有效的 preview_id，便無法下單。每個 ID 只能使用一次，並會在執行後失效。
切換至真實帳戶前
請先完成以下檢查清單：
- 步驟 5 中的 3 個測試提示均已返回有效數據
- 您已在模擬模式中成功預覽並確認至少一筆交易
- 您了解交易預覽中每個欄位的含義
- 您已確認是有意將 CAP_ENV 更改為 live，並將 CAP_ALLOW_TRADING 更改為 true
- 您已閱讀 Capital.com 的條款及細則和電子交易條款
如要限制伺服器可交易的市場，請在 CAP_ALLOWED_EPICS 中新增金融工具代碼，例如：SILVER,GOLD,EURUSD。如留空，則允許交易您帳戶中的所有可用市場。
我可以向 AI 助手提出什麼要求？
查看您的帳戶
登入我的帳戶
列出我的帳戶
檢查我的 Capital.com 連接健康狀態
研究市場
搜尋比特幣市場
顯示 EURUSD 市場詳情
取得 GOLD 的 1 小時歷史價格
檢視您的投資組合
顯示我的未平倉倉位
列出我的掛單
檢視我的投資組合風險敞口
下單交易（請先使用模擬模式）
預覽買入 1.5 SILVER，止蝕設於 24.50
為 GOLD 建立一份風險為 1% 的交易提案
使用 preview_id abc-123 執行倉位，confirm=true
平掉 DEAL_ID 倉位，confirm=true
疑難排解
請先執行健康狀態檢查。請詢問您的 AI 助手：Check my Capital.com connection health（檢查我的 Capital.com 連接健康狀態）。回覆通常會指出問題所在。
| 您看到的內容 | 最可能的原因 | 修正方法 |
|---|---|---|
| "Authentication failed"（驗證失敗）或 "Session expired"（工作階段已過期） | CAP_API_PASSWORD 設定為您的登入密碼，而不是您在步驟 1 建立的自訂 API 密碼 | 請使用您在產生 API 金鑰時建立的密碼，而不是網站登入密碼 |
| "Rate limit exceeded"（超出速率限制） | 短時間內傳送太多請求 | 等待 30–60 秒後重試。 |
| zsh: event not found（找不到事件，僅限 Mac） | 您的 API 密碼包含感嘆號 (!) | 請在設定中以單引號包住密碼值：'yourPassword!Here' |
| "Server not responding"（伺服器沒有回應）/ server won't start（伺服器無法啟動） | Python 路徑錯誤，或伺服器未正確安裝 | 開啟 Terminal，直接執行 python -m capital_mcp.server——錯誤訊息會較易閱讀 |
| 顯示少於 36 個工具 | 伺服器已啟動，但設定存在錯誤 | 檢查：(1) 所有佔位符均已替換為真實值；(2) 沒有遺漏 " { }或 , 個字元；(3) Python 路徑指向 venv 資料夾，而不是系統 Python |
| 任何提示都沒有回應 | 設定檔未儲存，或 AI 助手未完全重新啟動 | 完全關閉並重新開啟您的 AI 助手——不要只是關閉視窗 |
| "401 Unauthorized"（401 未授權） | API 金鑰已過期或被撤銷 | 前往 Capital.com 的「設定 (Settings)」→「API 整合 (API Integrations)」，並產生新的金鑰。 |
| "Environment mismatch"（環境不一致） | CAP_ENV 設為 live，但憑證屬於模擬帳戶 | 更新設定檔中的 CAP_ENV，使其與您的帳戶類型一致 |
仍然無法解決？提交支援請求，並包括：您使用的 AI 助手、您的作業系統，以及完整錯誤訊息。
常見問題
我需要付費 AI 助手計劃嗎？ 部分 AI 助手需要付費訂閱，才能使用 MCP 功能。例如，Claude Desktop 需要付費計劃才能啟用 MCP 連接器。Capital.com MCP 伺服器本身免費。
我需要真實交易帳戶嗎？ 不需要。伺服器可配合模擬帳戶使用，我們亦建議您先從模擬帳戶開始。
我的 Capital.com 登入密碼是否與 CAP_API_PASSWORD 相同？ 不是。兩者是分開的。 CAP_API_PASSWORD 是您在產生 API 金鑰時專門建立的新密碼。在此使用登入密碼會導致驗證失敗。
AI 是否可以在我不知情的情況下下單交易？不可以。每筆交易都需要先完成預覽步驟，再透過包含 confirm=true 的獨立確認訊息確認。 如缺少其中任何一步，伺服器都無法執行交易。預覽 ID 只能使用一次，並會在執行後立即失效。
什麼是 CAP_ALLOW_TRADING，我應否更改它？它是一個安全開關。當設為 false 時，伺服器可以向您顯示市場數據和帳戶資料，但不能下單交易。只有在您已於模擬模式中完成所有測試，並準備好使用真實資金交易時，才將其更改為 true。
CAP_ALLOWED_EPICS 有什麼作用？ 它會限制伺服器可交易的金融工具。如留空，則允許交易您帳戶中的所有可用市場。新增以逗號分隔的清單（例如：SILVER,GOLD,EURUSD）即可作出限制。
我的 AI 助手顯示少於 36 個工具。問題在哪裡？請詢問您的 AI 助手：Check my Capital.com connection health（檢查我的 Capital.com 連接健康狀態）。最常見原因是 JSON 設定中存在格式錯誤，或 Python 路徑指向系統 Python，而不是 venv 資料夾。
我的交易數據安全嗎？ 伺服器會在您的本機電腦上運行。您的憑證只會儲存在本機設定檔中，絕不會傳送給第三方。與 Capital.com 的所有通訊均使用 HTTPS 加密。
我可以在兩部電腦上使用嗎？ 可以。請在第二部電腦上重複步驟 2，並使用步驟 1 中相同的 API 憑證。
我可以連接多個 Capital.com 帳戶嗎？伺服器一次只會連接一個帳戶。如要切換，請更新設定檔中的 4 個 CAP_ 值，然後重新啟動您的 AI 助手。
免責聲明 — 將 Public API 與第三方工具配合使用
第三方整合
本頁說明客戶如何將 Public API 連接至第三方軟件、工具或整合，包括由人工智能或大型語言模型（「LLM」）驅動的軟件、工具或整合。任何此類第三方軟件、工具或整合均獨立於 Capital.com，並不構成 Capital.com 服務的一部分。Capital.com 不控制、開發、認可任何第三方軟件，亦不對其功能、輸出或因使用該軟件而產生的任何結果承擔任何責任。您將第三方工具或整合與 Public API 配合使用，完全由您自行承擔風險。您有責任檢視您選擇使用的任何第三方工具的條款、私隱政策和資料處理做法。
Public API 的使用
您使用 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 保留限制、暫停或終止 API 存取權及/或您帳戶的權利。客戶不得允許任何第三方對其帳戶行使酌情控制權。
您的責任
您有責任確保您使用平台、Public API 以及任何第三方工具或整合時，均遵守 Capital.com 的條款及細則，以及您所在司法管轄區的所有適用法律和法規。使用自動化交易工具前，您應仔細考慮這些工具是否適合您的情況、經驗和風險承受能力。Capital.com 強烈建議您先使用模擬帳戶充分測試任何自動化工具或整合，然後再將其連接至真實交易環境。