Capital.com Public API MCP Server

Máy chủ MCP Capital.com

Máy chủ Giao thức Ngữ cảnh Mô hình (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 tự chịu rủi ro. Capital.com chỉ thực hiện lệnh và không xác nhận hay chịu trách nhiệm về phần mềm bên thứ ba hoặc kết quả của chúng. Không có gì ở đâ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 do độ trễ từ các công cụ bên thứ ba, và phải tuân thủ các điều khoản và luật 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 được bật theo mặc định và có thể tắt trong cấu hình
• Mọi thao tác giao dịch đều yêu cầu thực hiện hai giai đoạn (xem trước → xác nhận → thực hiện)
• Kiểm soát rủi ro tích hợp: danh sách cho phép, giới hạn kích thước, 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 về tổn thất giao dịch

Đối với các câu hỏi/làm rõ thêm, 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 tra (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 tốt nhất cho 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 vào ứng dụng).
3. Claude Desktop sẽ nhắc bạn nhập thông tin xác thực (khóa API, mã định danh, mật khẩu) và kiểm soát giao dịch. Điền vào 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 (chọn "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
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

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 cụ thể 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 hiện 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: true)
• CAP_ALLOWED_EPICS - Các công cụ được phép giao dịch (mặc định: ALL, mọi công cụ). Giới hạn bằng danh sách phân tách bằng dấu phẩy, ví dụ: "SILVER,GOLD,BTCUSD". Để trống sẽ chặn mọi giao dịch
• CAP_MAX_POSITION_SIZE - Kích thước vị thế tối đa (mặc định: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Kích thước 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 hiện 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 quy trình nhắc 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	Danh sách 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 hiện, đóng vị thế; danh sách/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

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 hiện giao dịch đã xem trước trước đó
position_review	Phân tích vị thế mở và mức độ tiếp xúc (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 (tìm nạp trực tiếp)

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

Quy trình thực hiện giao dịch

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

Mọi thao tác có tác dụng phụ đều sử dụng quy trình xem trước → thực hiện 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 dụng phụ, xác thực chỉ đọc

2. Thực hiện: 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
   • Thăm dò 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; ALL mặc định cho phép mọi công cụ
• Giới hạn kích thước: Kích thước vị thế/lệnh tối đa được thực thi
• 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 kích thước: Làm tròn theo tối thiểu/tối đa/bước tăng của môi giới
• Chế độ chạy thử: Chặn mọi thực hiện 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 với 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. Nó không hoạt động như một dịch vụ lưu trữ và không có máy chủ riêng.

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. Nó 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 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ỉ chảy 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 câu hỏi 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ô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 phải là một phần 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 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 chịu 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 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 kỳ lúc nào mà không cần thông 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 Hiện Lệnh 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 hiện lệnh. Giao dịch các công cụ tài chính tiềm ẩn rủi ro thua lỗ đá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 của 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 bất kỳ đầu ra, tín hiệu, gợi ý, hoặc phân tích nào được tạo ra bởi AI, các 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 bất kỳ hoạt động tự động hoặc thuật toán nào, đều được thực hiện với rủi ro của riêng bạn 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 của 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. Bất kỳ đầu ra nào như vậy không được cung cấp bởi hoặc thay mặt cho Capital.com và không nên được dựa vào như 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 mang lại 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, lỗi phần mềm, hoặc sự cố kết nối; thực hiện ở mức giá khác biệt đáng kể so với dự kiến; và các lệnh không mong muốn hoặc sai sót phát sinh từ các công cụ hoặc tham số được cấu hình sai. Capital.com không chịu trách nhiệm cho bất kỳ khoản thua lỗ nào phát sinh từ các rủi ro như vậ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ụ của bên thứ ba nào. Hiệu suất trong quá khứ và bất kỳ đầu ra nào được tạo ra bởi các công cụ tự động không phải là chỉ báo cho kết quả trong tương lai.

Trong trường hợp các công cụ 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á được truyền đạt bởi công cụ và giá mà bất kỳ lệnh kết quả nào được thực hiện. Tất cả các lệnh được đặt qua Public API đượ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 được hiển thị tại thời điểm yêu cầu. Capital.com tìm cách đạt đượ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 pháp lý cho sự chênh lệch giá phát sinh từ độ trễ do các công cụ hoặc hệ thống của bên thứ ba nằm 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 sử dụng để thao túng nền tảng Capital.com, khai thác giá hoặc độ trễ, tham gia vào 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 hợp lý cho rằng việc sử dụng sai như vậy đã 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 tùy ý đối với tài khoản của họ.

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 của bên thứ ba nào tuân thủ Điều khoản và Điều kiện, Điều khoản Giao dịch Điện tử của Capital.com, và tất cả luật và quy định hiện hành trong khu vực tài phán 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 bạn trước khi sử dụng chúng hay không. Capital.com khuyến nghị mạnh mẽ rằng bạn kiểm tra kỹ lưỡng bất kỳ công cụ hoặc tích hợp tự động nào 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.