Capital.com Public API MCP Server

Capital.com MCP Server

Model Context Protocol (MCP) sunucusu, Capital.com Open API için - LLM destekli Capital.com işlem hesabınıza erişimi etkinleştirir.

⚠️ Önemli Bildirim

Capital.com Public API'yi ve üçüncü taraf araçları (AI/LLM tabanlı araçlar dahil) kullanımınız tamamen kendi sorumluluğunuzdadır. Capital.com yalnızca işlem yürütme hizmeti sunar ve üçüncü taraf yazılımları veya bunların sonuçlarını onaylamaz veya sorumluluk kabul etmez. Buradaki hiçbir şey yatırım tavsiyesi değildir. İşlem kararlarınız, üçüncü taraf araçlarının neden olduğu gecikmeden kaynaklanan fiyat farklılıkları dahil olmak üzere, tamamen size aittir ve geçerli şartlara ve yasalara uymak zorundasınız.

Kripto Türevleri, Capital Com (UK) Ltd'ye kayıtlı Bireysel müşteriler için kullanılamaz.

• Canlı işlemlere geçmeden önce her zaman bir Demo hesabı ile başlayın
• İşlem yapma varsayılan olarak devre dışıdır ve açıkça yapılandırma gerektirir
• Tüm işlem işlemleri iki aşamalı yürütme gerektirir (önizleme → onay → yürütme)
• Yerleşik risk kontrolleri: izin listeleri, boyut limitleri, günlük emir sınırları
• Kendi sorumluluğunuzda kullanın - yazarlar işlem kayıplarından sorumlu değildir

Daha fazla soru/açıklama için lütfen SSS bölümüne bakın: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Hızlı Başlangıç Kılavuzu

Adım 1: Capital.com API Kimlik Bilgilerini Alın

1. Hesap Oluşturun: capital.com/trading/signup adresine gidin

   • Test için Demo hesabını seçin (önerilir)
   • E-postanızı doğrulayın

2. 2FA'yı Etkinleştirin: Ayarlar > Güvenlik > İki Faktörlü Kimlik Doğrulama

   • API anahtarları oluşturmadan önce gereklidir

3. API Anahtarı Oluşturun: Ayarlar > API entegrasyonları > Yeni anahtar oluştur

   • Bir etiket belirleyin (ör. "MCP Sunucusu")
   • Özel bir şifre belirleyin (bu platform şifreniz DEĞİLDİR)
   • Görüntülenen API anahtarını kaydedin (yalnızca bir kez gösterilir!)
   • Not: API anahtarları işlem yapma yeteneğine sahiptir; Capital.com salt okunur anahtarlar sunmaz

Adım 2: Kurulum ve Yapılandırma

AI Yönlendirmeli Kurulum: Bu proje klasörünü AI destekli bir düzenleyicide (Claude Code, Cursor, Windsurf) açın ve Capital.com MCP sunucusunu kurmasını isteyin — INSTALL.md dosyasını izleyerek size kurulumda rehberlik edecek ve ortamınız için en iyi yöntemi seçecektir.

Ayrıca aşağıdaki manuel kurulum seçenekleriniz de mevcuttur:

Seçenek A: MCPB Paketi ile Tek Tıkla Kurulum (Önerilir)

Depo, önceden oluşturulmuş bir capital-mcp.mcpb paketi içerir — Claude Desktop'ta açın, işlem tamam, manuel yapılandırma düzenlemesi gerekmez.

Adımlar:

1. Depoyu klonlayın:

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

2. capital-mcp.mcpb dosyasını Claude Desktop'ta açın (çift tıklayın veya uygulamaya sürükleyin).
3. Claude Desktop sizden kimlik bilgilerini (API anahtarı, tanımlayıcı, şifre) ve işlem kontrollerini isteyecektir. Bunları doldurun ve Yükle'ye tıklayın.
4. Claude Desktop'u yeniden başlatın ve şunu sorarak doğrulayın: "Hangi Capital.com araçları mevcut?"

Seçenek B: Betik ile Manuel Kurulum

Ön Koşullar: Python 3.10+ ve Git kurulu olmalıdır.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (kurulum sırasında "PATH'e Ekle" seçeneğini işaretleyin) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

Kurulum betiği bir sanal ortam oluşturacak, bağımlılıkları yükleyecek ve MCP istemci yapılandırmasını sizin için yazdıracaktır.

.env dosyasını kimlik bilgilerinizle düzenleyin:

# 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

Seçenek C: Docker

Ön Koşullar: Docker kurulu olmalıdır.

1. Kimlik bilgilerinizle bir .env dosyası oluşturun (bkz. .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. Sunucuyu çalıştırın:

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

Sorun Giderme: Günlükleri Kontrol Edin

MCP sunucusunu Claude Desktop veya diğer istemcilerle kullanırken sorunlarla karşılaşırsanız, günlük dosyalarını kontrol edin:

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

---

İstemci Entegrasyonu

İstemciye özel yapılandırma için (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, özel istemciler) bkz. USAGE.md — İstemci Entegrasyonu.

Kullanım Örnekleri

Claude Desktop ile Örnek Konuşma

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

İşlem Yürütme İş Akışı (İşlem Etkinleştirildiğinde)

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"

Ortam Değişkenleri Referansı

Gerekli

• CAP_ENV - Ortam: demo veya live (varsayılan: demo)
• CAP_API_KEY - Capital.com'dan API anahtarı
• CAP_IDENTIFIER - Giriş e-postası
• CAP_API_PASSWORD - API anahtarı özel şifresi

Risk Kontrolleri (Önerilen)

• CAP_ALLOW_TRADING - İşlemi etkinleştir (varsayılan: false)
• CAP_ALLOWED_EPICS - Virgülle ayrılmış izin listesi (ör. "SILVER,GOLD,BTCUSD") veya sınırsız için "ALL"
• CAP_MAX_POSITION_SIZE - Maksimum pozisyon büyüklüğü (varsayılan: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Maksimum emir büyüklüğü (varsayılan: 1.0)
• CAP_MAX_OPEN_POSITIONS - Maksimum eşzamanlı pozisyon (varsayılan: 3)
• CAP_MAX_ORDERS_PER_DAY - Günlük emir limiti (varsayılan: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - confirm=true gerektir (varsayılan: true)
• CAP_DRY_RUN - Tüm işlem yürütmelerini engelle (varsayılan: false)

İsteğe Bağlı

• CAP_DEFAULT_ACCOUNT_ID - Girişten sonraki varsayılan hesap
• CAP_HTTP_TIMEOUT_S - HTTP zaman aşımı (varsayılan: 15)
• CAP_LOG_LEVEL - Günlük seviyesi: DEBUG, INFO, WARNING, ERROR (varsayılan: INFO)

MCP Yetenekleri

6 kategoride 38 araç, 7 iş akışı istemi ve 4 salt okunur kaynak.

Kategori	Araçlar	Açıklama
Oturum	4	Giriş, çıkış, durum, canlı tutma
Piyasa Verisi	6	Arama, detaylar, fiyatlar, duyarlılık, navigasyon
Hesap	6	Hesapları listele, tercihler, aktivite/işlem geçmişi, demo yükleme
İşlem	13	Önizle, yürüt, pozisyonları kapat; çalışan emirleri listele/iptal/değiştir; onaylar
İzleme Listeleri	6	Oluştur, listele, al, sil; piyasaları ekle/kaldır
Akış	3	WebSocket ile gerçek zamanlı fiyatlar, uyarılar, portföy K/Z

İstem	Açıklama
market_scan	Bir izleme listesini işlem koşulları için tarayın
trade_proposal	Risk bazlı boyutlandırma ile bir işlem planlayın (yalnızca önizleme)
execute_trade	Daha önce önizlenen bir işlemi yürütün
position_review	Açık pozisyonları ve maruziyeti analiz edin (salt okunur)
live_price_monitor	Hareket uyarıları ile gerçek zamanlı fiyat takibi (WebSocket)
real_time_alerts	Koşullu fiyat seviyesi uyarıları (WebSocket)
live_portfolio_monitor	Canlı portföy K/Z panosu (WebSocket)

Kaynak	Açıklama
cap://status	Sunucu sağlığı, oturum durumu, hız sınırları
cap://risk-policy	Risk yönetimi yapılandırması ve doğrulama katmanları
cap://allowed-epics	İşlem izin listesi yapılandırması
cap://market-cache/{epic}	Önbelleğe alınmış piyasa detayları (canlı çekme)

Tam detaylar, parametreler ve örnekler için bkz. USAGE.md.

İşlem Yürütme Süreci

Zorunlu İki Adımlı Yürütme

Tüm yan etki işlemleri sıkı bir önizleme → yürütme akışı kullanır:

1. Önizleme: İşlemi komisyoncu kurallarına + yerel risk politikasına göre doğrulayın

   • Normalleştirilmiş istek + risk kontrolleri ile preview_id döndürür
   • Yan etki yok, salt okunur doğrulama

2. Yürütme: preview_id kullanarak işlemi gönderin

   • Kritik kontrolleri yeniden çalıştırır
   • CAP_REQUIRE_EXPLICIT_CONFIRM=true ise confirm=true gerektirir
   • Komisyoncu onayını sorgular
   • Günlük emir sayacını artırır

Risk Kontrolleri

• İzin Listesi: Yalnızca CAP_ALLOWED_EPICS içindeki EPIC'ler işlem görebilir
• Boyut Limitleri: Maksimum pozisyon/emir boyutu uygulanır
• Pozisyon Limitleri: Herhangi bir zamanda maksimum açık pozisyon
• Günlük Limitler: Günde maksimum emir
• Boyut Normalleştirme: Komisyoncu min/maks/artış değerine yuvarlar
• Kuru Çalışma Modu: Etkinleştirildiğinde tüm yürütmeleri engeller

Dokümantasyon

• Kullanım Kılavuzu: USAGE.md - Örneklerle kapsamlı kullanım kılavuzu
• Capital.com API Referansı: https://open-api.capital.com/
• Capital.com API Postman Koleksiyonu: https://github.com/capital-com-sv/capital-api-postman

Lisans

MIT

Gizlilik Politikası

Capital.com MCP sunucusu, yerel makinenizde çalışır ve sağladığınız kimlik bilgilerini kullanarak doğrudan Capital.com Public API ile iletişim kurar. Barındırılan bir hizmet olarak çalışmaz ve kendi sunucuları yoktur.

Veri toplama

MCP sunucusu herhangi bir veri toplamaz veya saklamaz. AI istemciniz ile Capital.com Public API arasında yerel bir köprü görevi görür.

Veri kullanımı ve depolama

Bir oturum sırasında değiştirilen tüm veriler, yerel makinenizde bellekte işlenir ve oturum sona erdiğinde atılır. MCP sunucusu tarafından diske hiçbir veri yazılmaz. Not: AI istemciniz, kendisinden geçen verileri kendi gizlilik politikasına uygun olarak işleyebilir, günlüğe kaydedebilir veya saklayabilir; bunu ayrıca incelemelisiniz.

Üçüncü taraf paylaşımı

MCP sunucusu herhangi bir veriyi üçüncü bir tarafla paylaşmaz. Veri yalnızca yerel ortamınız ile Capital.com Public API arasında akar ve Capital.com'un kendi Gizlilik Politikasına tabidir.

Veri saklama

MCP sunucusu hiçbir veriyi saklamaz. Oturum verileri yalnızca oturum süresince bellekte bulunur.

API Kimlik Bilgileri

Sağladığınız API kimlik bilgileri, yerel ortamınızda depolanır ve yönetilir. Bunları uygun şekilde güvence altına almak sizin sorumluluğunuzdadır.

İletişim

Capital.com hesabınız veya Capital.com'un verilerinizi nasıl işlediğiyle ilgili gizlilik soruları için Capital.com Gizlilik Politikası sayfasına bakın veya support@capital.com adresine başvurun.

Sorumluluk Reddi – Capital.com Public API'nin Üçüncü Taraf Araçlarla Kullanımı

Üçüncü Taraf Entegrasyonu

Bu sayfa, müşterilerin Capital.com Public API'yi yapay zeka veya büyük dil modelleri ('LLM'ler) tarafından desteklenenler de dahil olmak üzere üçüncü taraf yazılımlara, araçlara veya entegrasyonlara nasıl bağlayabileceğini açıklar. Bu tür herhangi bir üçüncü taraf yazılım, araç veya entegrasyon Capital.com'dan bağımsızdır ve Capital.com'un hizmetlerinin bir parçasını oluşturmaz. Capital.com, herhangi bir üçüncü taraf yazılımı, işlevselliğini, çıktılarını veya kullanımından kaynaklanan herhangi bir sonucu kontrol etmez, geliştirmez, onaylamaz veya bunlarla ilgili herhangi bir sorumluluk kabul etmez. Capital.com Public API ile bağlantılı olarak üçüncü taraf araçların veya entegrasyonların herhangi bir şekilde kullanımı tamamen kendi sorumluluğunuzdadır. Kullanmayı seçtiğiniz herhangi bir üçüncü taraf aracının şartlarını, gizlilik politikalarını ve veri işleme uygulamalarını incelemek sizin sorumluluğunuzdadır.

Public API Kullanımı

Capital.com Public API'yi kullanımınız tamamen kendi takdirinize ve riskinize bağlıdır. Capital.com, Public API'yi bilgilendirme ve işlem amaçları için kullanıma sunar, ancak belirli bir kullanımı, entegrasyonu veya işlem stratejisini tavsiye etmez, onaylamaz veya teşvik etmez. API'ye nasıl eriştiğiniz ve onu nasıl kullandığınız, gönderilen emirlerin parametreleri, bağlı araçların veya sistemlerin yapılandırması ve alınan herhangi bir verinin yorumlanması dahil olmak üzere tamamen siz sorumlusunuz. Capital.com, ister doğrudan ister üçüncü taraf araçlar aracılığıyla erişilsin, API kullanımınızdan kaynaklanan kayıplar veya istenmeyen sonuçlar için hiçbir sorumluluk kabul etmez. API kullanılabilirliği, işlevselliği ve özellikleri önceden haber verilmeksizin herhangi bir zamanda değiştirilebilir, hız sınırlamasına tabi tutulabilir, askıya alınabilir veya durdurulabilir. Public API kullanımınız, API'yi kullanmadan önce dikkatlice okumanız gereken Capital.com'un Şart ve Koşullarına ve Elektronik İşlem Şartlarına tabidir.

Yalnızca Yürütme Hizmeti ve Yatırım Tavsiyesi Yok

Capital.com hizmetlerini yalnızca yürütme esasına göre sağlar. Finansal araçlarla işlem yapmak önemli kayıp riski içerir. Bu sayfada, Public API'de veya herhangi bir üçüncü taraf yazılım veya entegrasyonda yer alan hiçbir şey yatırım tavsiyesi, kişisel bir tavsiye veya herhangi bir finansal aracı satın alma veya satma teşviki teşkil etmez. Bu, AI, LLM tabanlı veya diğer otomatik araçlar tarafından oluşturulan herhangi bir çıktı, sinyal, öneri veya analizi içerir. Otomatik veya algoritmik faaliyetler de dahil olmak üzere tüm işlem kararları kendi riskinize aittir ve tek sorumluluğunuz olmaya devam eder. Capital.com, Public API'ye bağlı üçüncü taraf AI veya LLM tabanlı araçların çıktılarını kontrol etmez ve bu tür araçların yatırım tavsiyesi veya kişisel bir tavsiye olarak yorumlanabilecek içerikler üretmeyeceğini garanti edemez. Bu tür herhangi bir çıktı Capital.com tarafından veya onun adına sağlanmaz ve tavsiye olarak güvenilmemelidir.

Otomatik ve Algoritmik İşlem Riskleri

Public API'nin otomatik veya algoritmik işlem araçlarıyla birlikte kullanımı, aşağıdakilerle sınırlı olmamak üzere ek riskler taşır: insan incelemesi veya müdahalesi olmadan emirlerin hızlı bir şekilde gerçekleştirilmesi; sistem hataları, yazılım arızaları veya bağlantı sorunları; beklenenden önemli ölçüde farklı fiyatlardan gerçekleştirme; ve yanlış yapılandırılmış araçlar veya parametrelerden kaynaklanan istenmeyen veya hatalı emirler. Capital.com, bu tür risklerden veya sistemlerinin herhangi bir üçüncü taraf aracıyla etkileşiminden kaynaklanan kayıplardan sorumlu değildir. Geçmiş performans ve otomatik araçlar tarafından üretilen çıktılar gelecekteki sonuçların göstergesi değildir.

Piyasa verilerini veya fiyat bilgilerini almak için yapay zeka veya LLM tabanlı araçlar kullanıldığında, aracın ilettiği fiyat ile sonuçta gerçekleştirilen emrin fiyatı arasında gecikme olabilir. Public API üzerinden verilen tüm emirler piyasa emri olarak gerçekleştirilir. Bu nedenle, gerçekleştirme fiyatı, talep anında görüntülenen herhangi bir fiyattan farklı olabilir. Capital.com, yükümlülüklerine uygun olarak en iyi gerçekleştirmeyi sağlamayı hedefler; kontrolü dışındaki üçüncü taraf araçlara veya sistemlere atfedilebilen gecikmeden kaynaklanan fiyat farklılıkları için sorumluluk kabul etmeyiz.

Yasaklı Kullanım

Public API'nin ve bağlı araçların kullanımı, Capital.com platformunu manipüle etmek, fiyatlandırma veya gecikmeden yararlanmak, piyasa suiistimalinde bulunmak veya herhangi bir haksız avantaj elde etmek için kullanılmamalıdır. Capital.com, bu tür bir kötüye kullanımın gerçekleştiğini veya gerçekleşmesinin muhtemel olduğunu makul şekilde değerlendirdiği durumlarda API erişimini ve/veya hesabınızı kısıtlama, askıya alma veya sonlandırma hakkını saklı tutar. Müşteriler, üçüncü bir tarafın hesapları üzerinde takdir yetkisi kullanmasına izin vermemelidir.

Sorumluluklarınız

Capital.com platformunu, Public API'yi ve herhangi bir üçüncü taraf aracı veya entegrasyonu kullanımınızın Capital.com'un Hüküm ve Koşullarına, Elektronik İşlem Koşullarına ve bulunduğunuz yargı bölgesindeki tüm geçerli yasa ve düzenlemelere uygun olmasını sağlamak sizin sorumluluğunuzdadır. Otomatik işlem araçlarını kullanmadan önce, bunların koşullarınıza, deneyiminize ve risk toleransınıza uygun olup olmadığını dikkatle değerlendirmelisiniz. Capital.com, otomatik araçları veya entegrasyonları canlı işlem ortamına bağlamadan önce bunları bir Demo hesabı kullanarak kapsamlı şekilde test etmenizi şiddetle tavsiye eder.