Capital.com Public API MCP Server

Máy chủ MCP Capital.com

Máy chủ Model Context Protocol (MCP) cho Capital.com Open API – cho phép truy cập tài khoản giao dịch Capital.com của bạn thông qua LLM.

⚠️ Thông báo quan trọng

Việc bạn sử dụng Capital.com Public API và bất kỳ công cụ bên thứ ba nào, bao gồm các công cụ dựa trên AI/LLM, là hoàn toàn do bạn tự chịu rủi ro. Capital.com chỉ cung cấp dịch vụ thực thi và không xác nhận cũng như không chịu trách nhiệm đối với phần mềm bên thứ ba hoặc kết quả của chúng. Không có nội dung nào ở đây là lời khuyên đầu tư. Bạn hoàn toàn chịu trách nhiệm về các quyết định giao dịch của mình, bao gồm mọi chênh lệch giá phát sinh từ độ trễ do các công cụ bên thứ ba gây ra, đồng thời phải tuân thủ các điều khoản và luật pháp hiện hành.

Các sản phẩm phái sinh tiền điện tử không khả dụng cho khách hàng bán lẻ đăng ký với Capital Com (UK) Ltd.

• Luôn bắt đầu với tài khoản Demo trước khi cân nhắc giao dịch thực
• Giao dịch bị tắt theo mặc định và yêu cầu cấu hình tường minh
• Mọi thao tác giao dịch đều yêu cầu thực thi hai giai đoạn (xem trước → xác nhận → thực thi)
• Các biện pháp kiểm soát rủi ro tích hợp: danh sách cho phép, giới hạn quy mô, giới hạn lệnh hàng ngày
• Tự chịu rủi ro khi sử dụng – các tác giả không chịu trách nhiệm pháp lý về tổn thất giao dịch

Nếu có thêm câu hỏi/cần làm rõ, vui lòng tham khảo FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Hướng dẫn bắt đầu nhanh

Bước 1: Lấy thông tin xác thực API Capital.com

1. Tạo tài khoản: Truy cập capital.com/trading/signup

   • Chọn tài khoản Demo để kiểm thử (khuyến nghị)
   • Xác minh email của bạn

2. Bật xác thực hai yếu tố (2FA): Cài đặt > Bảo mật > Xác thực hai yếu tố

   • Bắt buộc trước khi tạo khóa API

3. Tạo khóa API: Cài đặt > Tích hợp API > Tạo khóa mới

   • Đặt nhãn (ví dụ: "MCP Server")
   • Đặt mật khẩu tùy chỉnh (đây KHÔNG phải mật khẩu nền tảng của bạn)
   • Lưu khóa API được hiển thị (chỉ hiển thị một lần!)
   • Lưu ý: Khóa API có khả năng giao dịch; Capital.com không cung cấp khóa chỉ đọc

Bước 2: Cài đặt & Cấu hình

Cài đặt có hướng dẫn bằng AI: Mở thư mục dự án này trong trình soạn thảo hỗ trợ AI (Claude Code, Cursor, Windsurf) và yêu cầu nó cài đặt máy chủ MCP Capital.com — nó sẽ làm theo INSTALL.md để hướng dẫn bạn thiết lập, chọn phương pháp phù hợp nhất với môi trường của bạn.

Bạn cũng có các tùy chọn cài đặt thủ công sau:

Tùy chọn A: Cài đặt một cú nhấp chuột qua gói MCPB (Khuyến nghị)

Kho lưu trữ bao gồm gói capital-mcp.mcpb được xây dựng sẵn — mở nó trong Claude Desktop là xong, không cần chỉnh sửa cấu hình thủ công.

Các bước:

1. Sao chép kho lưu trữ:

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

2. Mở capital-mcp.mcpb trong Claude Desktop (nhấp đúp hoặc kéo tệp vào ứng dụng).
3. Claude Desktop sẽ yêu cầu bạn nhập thông tin xác thực (khóa API, mã định danh, mật khẩu) và các kiểm soát giao dịch. Điền thông tin và nhấp Cài đặt.
4. Khởi động lại Claude Desktop và xác minh bằng cách hỏi: "Những công cụ Capital.com nào có sẵn?"

Tùy chọn B: Cài đặt thủ công qua tập lệnh

Điều kiện tiên quyết: Python 3.10+ và Git phải được cài đặt.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (đánh dấu "Add to PATH" khi cài đặt) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

Tập lệnh cài đặt sẽ tạo môi trường ảo, cài đặt các phụ thuộc và in cấu hình máy khách MCP cho bạn.

Chỉnh sửa .env với thông tin xác thực của bạn:

# 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

Tùy chọn C: Docker

Điều kiện tiên quyết: Docker phải được cài đặt.

1. Tạo tệp .env với thông tin xác thực của bạn (xem .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. Chạy máy chủ:

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

Khắc phục sự cố: Kiểm tra nhật ký

Nếu bạn gặp sự cố khi sử dụng máy chủ MCP với Claude Desktop hoặc các máy khách khác, hãy kiểm tra các tệp nhật ký:

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

---

Tích hợp máy khách

Để biết cấu hình dành riêng cho từng máy khách (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, máy khách tùy chỉnh), xem USAGE.md — Tích hợp máy khách.

Ví dụ sử dụng

Ví dụ hội thoại với 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

Quy trình thực thi giao dịch (Khi giao dịch được bật)

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"

Tham chiếu biến môi trường

Bắt buộc

• CAP_ENV - Môi trường: demo hoặc live (mặc định: demo)
• CAP_API_KEY - Khóa API từ Capital.com
• CAP_IDENTIFIER - Email đăng nhập
• CAP_API_PASSWORD - Mật khẩu tùy chỉnh của khóa API

Kiểm soát rủi ro (Khuyến nghị)

• CAP_ALLOW_TRADING - Bật giao dịch (mặc định: false)
• CAP_ALLOWED_EPICS - Danh sách cho phép phân tách bằng dấu phẩy (ví dụ: "SILVER,GOLD,BTCUSD") hoặc "ALL" để không giới hạn
• CAP_MAX_POSITION_SIZE - Quy mô vị thế tối đa (mặc định: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Quy mô lệnh tối đa (mặc định: 1.0)
• CAP_MAX_OPEN_POSITIONS - Số vị thế đồng thời tối đa (mặc định: 3)
• CAP_MAX_ORDERS_PER_DAY - Giới hạn lệnh hàng ngày (mặc định: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Yêu cầu confirm=true (mặc định: true)
• CAP_DRY_RUN - Chặn mọi thực thi giao dịch (mặc định: false)

Tùy chọn

• CAP_DEFAULT_ACCOUNT_ID - Tài khoản mặc định sau khi đăng nhập
• CAP_HTTP_TIMEOUT_S - Thời gian chờ HTTP (mặc định: 15)
• CAP_LOG_LEVEL - Mức nhật ký: DEBUG, INFO, WARNING, ERROR (mặc định: INFO)

Khả năng MCP

38 công cụ trong 6 danh mục, 7 lời nhắc quy trình, và 4 tài nguyên chỉ đọc.

Danh mục	Công cụ	Mô tả
Phiên	4	Đăng nhập, đăng xuất, trạng thái, giữ kết nối
Dữ liệu thị trường	6	Tìm kiếm, chi tiết, giá, tâm lý, điều hướng
Tài khoản	6	Liệt kê tài khoản, tùy chọn, lịch sử hoạt động/giao dịch, nạp tiền demo
Giao dịch	13	Xem trước, thực thi, đóng vị thế; liệt kê/hủy/sửa lệnh chờ; xác nhận
Danh sách theo dõi	6	Tạo, liệt kê, lấy, xóa danh sách theo dõi; thêm/xóa thị trường
Truyền phát	3	Giá thời gian thực, cảnh báo, P&L danh mục qua WebSocket

Lời nhắc	Mô tả
market_scan	Quét danh sách theo dõi để tìm điều kiện giao dịch
trade_proposal	Lập kế hoạch giao dịch với định cỡ dựa trên rủi ro (chỉ xem trước)
execute_trade	Thực thi giao dịch đã xem trước trước đó
position_review	Phân tích vị thế mở và mức độ rủi ro (chỉ đọc)
live_price_monitor	Theo dõi giá thời gian thực với cảnh báo biến động (WebSocket)
real_time_alerts	Cảnh báo mức giá có điều kiện (WebSocket)
live_portfolio_monitor	Bảng điều khiển P&L danh mục trực tiếp (WebSocket)

Tài nguyên	Mô tả
cap://status	Tình trạng máy chủ, trạng thái phiên, giới hạn tốc độ
cap://risk-policy	Cấu hình quản lý rủi ro và các lớp xác thực
cap://allowed-epics	Cấu hình danh sách cho phép giao dịch
cap://market-cache/{epic}	Chi tiết thị trường được lưu trong bộ nhớ đệm (truy xuất trực tiếp)

Để biết chi tiết đầy đủ, tham số và ví dụ, xem USAGE.md.

Quy trình thực thi giao dịch

Quy trình hai bước bắt buộc

Mọi thao tác có tác động phụ đều sử dụng quy trình xem trước → thực thi nghiêm ngặt:

1. Xem trước: Xác thực giao dịch theo quy tắc môi giới + chính sách rủi ro cục bộ

   • Trả về preview_id với yêu cầu đã chuẩn hóa + kiểm tra rủi ro
   • Không có tác động phụ, xác thực chỉ đọc

2. Thực thi: Gửi giao dịch bằng preview_id

   • Chạy lại các kiểm tra quan trọng
   • Yêu cầu confirm=true nếu CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Chờ xác nhận từ môi giới
   • Tăng bộ đếm lệnh hàng ngày

Kiểm soát rủi ro

• Danh sách cho phép: Chỉ các EPIC trong CAP_ALLOWED_EPICS mới có thể giao dịch
• Giới hạn quy mô: Áp dụng quy mô vị thế/lệnh tối đa
• Giới hạn vị thế: Số vị thế mở tối đa tại bất kỳ thời điểm nào
• Giới hạn hàng ngày: Số lệnh tối đa mỗi ngày
• Chuẩn hóa quy mô: Làm tròn theo mức tối thiểu/tối đa/bước nhảy của môi giới
• Chế độ chạy thử: Chặn mọi thực thi khi được bật

Tài liệu

• Hướng dẫn sử dụng: USAGE.md - Hướng dẫn sử dụng toàn diện kèm ví dụ
• Tài liệu tham khảo API Capital.com: https://open-api.capital.com/
• Bộ sưu tập Postman API Capital.com: https://github.com/capital-com-sv/capital-api-postman

Giấy phép

MIT

Chính sách quyền riêng tư

Máy chủ MCP Capital.com chạy cục bộ trên máy của bạn và giao tiếp trực tiếp với Capital.com Public API bằng thông tin xác thực bạn cung cấp. Máy chủ không hoạt động như một dịch vụ lưu trữ và không có máy chủ riêng của mình.

Thu thập dữ liệu

Máy chủ MCP không thu thập hoặc lưu trữ bất kỳ dữ liệu nào. Máy chủ hoạt động như một cầu nối cục bộ giữa máy khách AI của bạn và Capital.com Public API.

Sử dụng và lưu trữ dữ liệu

Mọi dữ liệu trao đổi trong phiên được xử lý trong bộ nhớ trên máy cục bộ của bạn và bị loại bỏ khi phiên kết thúc. Máy chủ MCP không ghi bất kỳ dữ liệu nào vào đĩa. Lưu ý: Máy khách AI của bạn có thể xử lý, ghi nhật ký hoặc lưu trữ dữ liệu truyền qua nó theo chính sách quyền riêng tư của riêng nó, bạn nên xem xét riêng.

Chia sẻ với bên thứ ba

Máy chủ MCP không chia sẻ dữ liệu với bất kỳ bên thứ ba nào. Dữ liệu chỉ lưu chuyển giữa môi trường cục bộ của bạn và Capital.com Public API, tuân theo Chính sách quyền riêng tư của riêng Capital.com.

Lưu giữ dữ liệu

Máy chủ MCP không lưu giữ dữ liệu. Dữ liệu phiên chỉ tồn tại trong bộ nhớ trong suốt thời gian phiên.

Thông tin xác thực API

Thông tin xác thực API bạn cung cấp được lưu trữ và quản lý trong môi trường cục bộ của bạn. Bạn chịu trách nhiệm bảo mật chúng một cách phù hợp.

Liên hệ

Đối với các thắc mắc liên quan đến quyền riêng tư về tài khoản Capital.com của bạn hoặc cách Capital.com xử lý dữ liệu của bạn, hãy tham khảo Chính sách quyền riêng tư của Capital.com hoặc liên hệ support@capital.com.

Tuyên bố miễn trừ trách nhiệm – Sử dụng Capital.com Public API với các công cụ bên thứ ba

Tích hợp bên thứ ba

Trang này mô tả cách khách hàng có thể kết nối Capital.com Public API với phần mềm, công cụ hoặc tích hợp bên thứ ba, bao gồm cả những công cụ được hỗ trợ bởi trí tuệ nhân tạo hoặc mô hình ngôn ngữ lớn ('LLM'). Bất kỳ phần mềm, công cụ hoặc tích hợp bên thứ ba nào như vậy đều độc lập với Capital.com và không thuộc dịch vụ của Capital.com. Capital.com không kiểm soát, phát triển, xác nhận hoặc chịu bất kỳ trách nhiệm pháp lý nào đối với bất kỳ phần mềm bên thứ ba nào, chức năng, đầu ra của nó hoặc bất kỳ kết quả nào phát sinh từ việc sử dụng nó. Mọi việc sử dụng công cụ hoặc tích hợp bên thứ ba liên quan đến Capital.com Public API đều hoàn toàn do bạn tự chịu rủi ro. Bạn có trách nhiệm xem xét các điều khoản, chính sách quyền riêng tư và phương thức xử lý dữ liệu của bất kỳ công cụ bên thứ ba nào bạn chọn sử dụng.

Sử dụng Public API

Việc bạn sử dụng Capital.com Public API hoàn toàn do bạn tự quyết định và tự chịu rủi ro. Capital.com cung cấp Public API cho mục đích thông tin và giao dịch nhưng không khuyến nghị, xác nhận hoặc khuyến khích bất kỳ cách sử dụng, tích hợp hoặc chiến lược giao dịch cụ thể nào. Bạn hoàn toàn chịu trách nhiệm về cách bạn truy cập và sử dụng API, bao gồm các tham số của mọi lệnh được gửi, cấu hình của mọi công cụ hoặc hệ thống được kết nối và việc diễn giải mọi dữ liệu nhận được. Capital.com không chịu trách nhiệm pháp lý về tổn thất hoặc kết quả ngoài ý muốn phát sinh từ việc bạn sử dụng API, dù truy cập trực tiếp hay qua công cụ bên thứ ba. Tính khả dụng, chức năng và thông số kỹ thuật của API có thể bị sửa đổi, giới hạn tốc độ, tạm ngưng hoặc ngừng cung cấp bất cứ lúc nào mà không cần báo trước. Việc bạn sử dụng Public API tuân theo Điều khoản và Điều kiện cũng như Điều khoản giao dịch điện tử của Capital.com, bạn nên đọc kỹ trước khi sử dụng API.

Dịch vụ chỉ thực thi và không có lời khuyên đầu tư

Capital.com cung cấp dịch vụ của mình trên cơ sở chỉ thực thi. Giao dịch các công cụ tài chính tiềm ẩn rủi ro tổn thất đáng kể. Không có nội dung nào trên trang này, trong Public API hoặc trong bất kỳ phần mềm hoặc tích hợp bên thứ ba nào cấu thành lời khuyên đầu tư, khuyến nghị cá nhân hoặc lời mời mua hoặc bán bất kỳ công cụ tài chính nào. Điều này bao gồm mọi đầu ra, tín hiệu, gợi ý hoặc phân tích được tạo ra bởi AI, công cụ dựa trên LLM hoặc các công cụ tự động khác. Mọi quyết định giao dịch, bao gồm mọi hoạt động tự động hoặc thuật toán, đều do bạn tự chịu rủi ro và vẫn là trách nhiệm duy nhất của bạn. Capital.com không kiểm soát đầu ra của các công cụ AI hoặc LLM bên thứ ba được kết nối với Public API và không thể đảm bảo rằng các công cụ đó sẽ không tạo ra nội dung có thể bị hiểu là lời khuyên đầu tư hoặc khuyến nghị cá nhân. Mọi đầu ra như vậy không phải do Capital.com cung cấp hoặc thay mặt Capital.com cung cấp và không nên được coi là lời khuyên.

Rủi ro của Giao dịch Tự động và Thuật toán

Việc sử dụng Public API kết hợp với các công cụ giao dịch tự động hoặc thuật toán tiềm ẩn các rủi ro bổ sung, bao gồm nhưng không giới hạn ở: thực hiện lệnh nhanh chóng mà không có sự xem xét hoặc can thiệp của con người; lỗi hệ thống, sự cố phần mềm hoặc vấn đề kết nối; thực hiện lệnh ở mức giá khác biệt đáng kể so với dự kiến; và các lệnh ngoài ý muốn hoặc sai sót do cấu hình công cụ hoặc tham số không đúng. Capital.com không chịu trách nhiệm cho bất kỳ tổn thất nào phát sinh từ các rủi ro này hoặc từ sự tương tác giữa hệ thống của mình và bất kỳ công cụ bên thứ ba nào. Hiệu suất trong quá khứ và bất kỳ kết quả đầu ra nào do các công cụ tự động tạo ra không phải là chỉ báo cho kết quả trong tương lai.

Khi các công cụ dựa trên AI hoặc LLM được sử dụng để truy xuất dữ liệu thị trường hoặc thông tin giá, có thể có độ trễ giữa giá do công cụ truyền đạt và giá thực hiện của bất kỳ lệnh nào phát sinh. Tất cả các lệnh đặt qua Public API đều được thực hiện dưới dạng lệnh thị trường. Do đó, giá thực hiện có thể khác với bất kỳ giá nào hiển thị tại thời điểm yêu cầu. Capital.com tìm cách đạt được mức thực hiện tốt nhất theo các nghĩa vụ của mình; chúng tôi không chấp nhận trách nhiệm đối với chênh lệch giá phát sinh từ độ trễ do các công cụ hoặc hệ thống bên thứ ba ngoài tầm kiểm soát của mình.

Sử dụng Bị Cấm

Việc sử dụng Public API và bất kỳ công cụ kết nối nào không được dùng để thao túng nền tảng Capital.com, khai thác giá hoặc độ trễ, tham gia lạm dụng thị trường hoặc đạt được bất kỳ lợi thế không công bằng nào. Capital.com bảo lưu quyền hạn chế, đình chỉ hoặc chấm dứt quyền truy cập API và/hoặc tài khoản của bạn khi công ty xét thấy hợp lý rằng hành vi sử dụng sai mục đích đó đã xảy ra hoặc có khả năng xảy ra. Khách hàng không được phép cho phép bất kỳ bên thứ ba nào kiểm soát theo quyết định đối với tài khoản của mình.

Trách Nhiệm của Bạn

Bạn có trách nhiệm đảm bảo rằng việc sử dụng nền tảng Capital.com, Public API và bất kỳ công cụ hoặc tích hợp bên thứ ba nào của bạn tuân thủ Điều khoản và Điều kiện của Capital.com, Điều khoản Giao dịch Điện tử và tất cả luật pháp cũng như quy định hiện hành tại khu vực pháp lý của bạn. Bạn nên cân nhắc kỹ lưỡng liệu các công cụ giao dịch tự động có phù hợp với hoàn cảnh, kinh nghiệm và mức độ chấp nhận rủi ro của mình hay không trước khi sử dụng chúng. Capital.com khuyến nghị mạnh mẽ rằng bạn nên kiểm tra kỹ lưỡng mọi công cụ hoặc tích hợp tự động bằng tài khoản Demo trước khi kết nối chúng với môi trường giao dịch trực tiếp.