Capital.com Public API MCP Server

공식

Capital.com MCP 서버를 사용하면 AI 어시스턴트가 거래 계정과 직접 대화할 수 있습니다. 시장 데이터, 포지션 확인, 거래 미리보기 등 모든 것을 AI 도구를 떠나지 않고 일반 언어로 처리할 수 있습니다.

GitHub

이 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 서버

Capital.com Open API용 Model Context Protocol (MCP) 서버 - LLM 기반으로 Capital.com 거래 계정에 접근할 수 있게 해줍니다.

⚠️ 중요 공지

Capital.com Public API 및 AI/LLM 기반 도구를 포함한 모든 타사 도구의 사용은 전적으로 본인의 책임입니다. Capital.com은 실행 전용(execution-only) 서비스를 제공하며, 타사 소프트웨어나 그 결과에 대해 보증하거나 책임을 지지 않습니다. 여기의 어떤 내용도 투자 조언이 아닙니다. 거래 결정, 타사 도구로 인한 지연으로 발생하는 가격 차이를 포함한 모든 책임은 본인에게 있으며, 적용 가능한 약관과 법률을 준수해야 합니다.

암호화폐 파생상품(Crypto Derivatives)은 Capital Com (UK) Ltd에 등록된 Retail 고객에게 제공되지 않습니다.

라이브 거래를 고려하기 전에 항상 데모 계정으로 시작하세요
거래는 기본적으로 비활성화되어 있으며 명시적 구성이 필요합니다
모든 거래 작업은 2단계 실행(미리보기 → 확인 → 실행)이 필요합니다
내장된 위험 통제 기능: 허용 목록, 크기 제한, 일일 주문 상한
사용에 따른 책임은 본인에게 있습니다 - 작성자는 거래 손실에 대해 어떠한 책임도 지지 않습니다

추가 질문/확인이 필요한 경우 FAQ를 참조하세요: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

빠른 시작 가이드

1단계: Capital.com API 자격 증명 얻기

계정 생성: capital.com/trading/signup으로 이동
- 테스트용으로 데모 계정을 선택하세요 (권장)
- 이메일을 인증하세요
2FA 활성화: 설정 > 보안 > 2단계 인증(Two-Factor Authentication)
- API 키 생성 전에 필수입니다
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에서 열면 끝입니다. 수동 구성 편집이 필요 없습니다.

단계:

리포지토리 클론:

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

Claude Desktop에서 capital-mcp.mcpb을 엽니다 (더블클릭하거나 앱으로 드래그).
Claude Desktop이 자격 증명(API 키, 식별자, 비밀번호)과 거래 통제 설정을 요청합니다. 입력하고 설치를 클릭하세요.
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가 설치되어 있어야 합니다.

자격 증명으로 .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

서버 실행:

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 - 일일 주문 한도 (기본값: 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	관심 목록 생성, 목록, 조회, 삭제, 시장 추가/제거
스트리밍	3	WebSocket을 통한 실시간 가격, 알림, 포트폴리오 손익

프롬프트	설명
`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단계 실행

모든 부수 효과 작업은 엄격한 미리보기 → 실행 흐름을 사용합니다:

미리보기: 브로커 규칙 + 로컬 위험 정책에 대해 거래 검증
- 정규화된 요청 + 위험 검사가 포함된 preview_id 반환
- 부수 효과 없음, 읽기 전용 검증
실행: preview_id을 사용하여 거래 제출
- 중요 검사 재실행
- CAP_REQUIRE_EXPLICIT_CONFIRM=true인 경우 confirm=true 필요
- 브로커 확인 폴링
- 일일 주문 카운터 증가

위험 통제

허용 목록: CAP_ALLOWED_EPICS의 EPIC만 거래 가능
크기 제한: 최대 포지션/주문 크기 적용
포지션 제한: 언제든지 최대 열린 포지션 수
일일 제한: 일일 최대 주문 수
크기 정규화: 브로커 최소/최대/증분 단위로 반올림
드라이런 모드: 활성화 시 모든 실행 차단

문서

사용 가이드: USAGE.md - 예시가 포함된 종합 사용 가이드
Capital.com API 참조: https://open-api.capital.com/
Capital.com API Postman 컬렉션: https://github.com/capital-com-sv/capital-api-postman

라이선스

MIT

개인정보 처리방침

Capital.com MCP 서버는 사용자 컴퓨터에서 로컬로 실행되며, 사용자가 제공한 자격 증명을 사용하여 Capital.com Public API와 직접 통신합니다. 호스팅 서비스로 운영되지 않으며 자체 서버가 없습니다.

데이터 수집

MCP 서버는 데이터를 수집하거나 저장하지 않습니다. AI 클라이언트와 Capital.com Public API 사이의 로컬 브리지 역할만 합니다.

데이터 사용 및 저장

세션 중 교환되는 모든 데이터는 로컬 컴퓨터의 메모리에서 처리되며 세션이 종료되면 폐기됩니다. MCP 서버는 데이터를 디스크에 기록하지 않습니다. 참고: AI 클라이언트는 자체 개인정보 처리방침에 따라 이를 통과하는 데이터를 처리, 기록 또는 저장할 수 있으므로 별도로 검토해야 합니다.

제3자 공유

MCP 서버는 데이터를 제3자와 공유하지 않습니다. 데이터는 Capital.com 자체 개인정보 처리방침에 따라 로컬 환경과 Capital.com Public API 사이에서만 흐릅니다.

데이터 보존

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은 실행 전용(execution-only) 기준으로 서비스를 제공합니다. 금융 상품 거래는 상당한 손실 위험을 수반합니다. 이 페이지, Public API 또는 타사 소프트웨어나 통합의 어떤 내용도 투자 조언, 개인 추천 또는 금융 상품 매수/매도 권유를 구성하지 않습니다. 여기에는 AI, LLM 기반 또는 기타 자동화 도구가 생성한 출력, 신호, 제안 또는 분석이 포함됩니다. 자동화 또는 알고리즘 활동을 포함한 모든 거래 결정은 사용자 자신의 책임으로 이루어지며 전적으로 사용자의 책임입니다. Capital.com은 Public API에 연결된 타사 AI 또는 LLM 기반 도구의 출력을 통제하지 않으며, 이러한 도구가 투자 조언이나 개인 추천으로 해석될 수 있는 콘텐츠를 생성하지 않을 것이라고 보장할 수 없습니다. 그러한 출력은 Capital.com이 제공하거나 Capital.com을 대신하여 제공되는 것이 아니며 조언으로 신뢰해서는 안 됩니다.

자동 및 알고리즘 트레이딩의 위험

퍼블릭 API를 자동 또는 알고리즘 트레이딩 도구와 함께 사용하는 경우 추가적인 위험이 수반되며, 여기에는 다음이 포함되지만 이에 국한되지는 않습니다: 인간의 검토나 개입 없이 주문이 신속하게 체결됨; 시스템 오류, 소프트웨어 장애 또는 연결 문제; 예상과 실질적으로 다른 가격으로 체결됨; 또는 잘못 구성된 도구나 매개변수로 인한 의도하지 않거나 잘못된 주문. Capital.com은 이러한 위험 또는 자사 시스템과 제3자 도구 간의 상호작용으로 인해 발생하는 손실에 대해 책임을 지지 않습니다. 과거 실적 및 자동 도구가 생성한 모든 출력은 미래 결과를 나타내는 지표가 아닙니다.

AI 또는 LLM 기반 도구를 사용하여 시장 데이터나 가격 정보를 조회하는 경우, 도구가 전달하는 가격과 그에 따른 주문이 체결되는 가격 사이에 지연이 발생할 수 있습니다. 퍼블릭 API를 통해 제출된 모든 주문은 시장가 주문으로 체결됩니다. 따라서 체결 가격은 요청 시점에 표시된 가격과 다를 수 있습니다. Capital.com은 자사의 의무에 따라 최선의 체결을 추구합니다. 당사는 당사 통제 범위 밖의 제3자 도구나 시스템의 지연으로 인해 발생하는 가격 차이에 대해 책임을 지지 않습니다.

금지된 사용

퍼블릭 API 및 연결된 도구는 Capital.com 플랫폼을 조작하거나, 가격 또는 지연 시간을 악용하거나, 시장 남용에 관여하거나, 부당한 이점을 얻기 위해 사용되어서는 안 됩니다. Capital.com은 이러한 오용이 발생했거나 발생할 가능성이 있다고 합리적으로 판단하는 경우 API 접근 및/또는 귀하의 계정을 제한, 정지 또는 종료할 권리를 보유합니다. 고객은 제3자가 자신의 계정에 대한 재량적 통제권을 행사하도록 허용해서는 안 됩니다.

귀하의 책임

귀하는 Capital.com 플랫폼, 퍼블릭 API 및 모든 제3자 도구나 통합의 사용이 Capital.com의 이용약관, 전자 거래 약관 및 귀하의 관할권에서 적용되는 모든 법률과 규정을 준수하도록 할 책임이 있습니다. 자동 트레이딩 도구를 사용하기 전에 해당 도구가 귀하의 상황, 경험 및 위험 허용 범위에 적합한지 신중히 검토해야 합니다. Capital.com은 자동 도구나 통합을 실거래 환경에 연결하기 전에 데모 계정을 사용하여 철저히 테스트할 것을 강력히 권장합니다.