Capital.com Public API MCP Server

Capital.com MCP Sunucusu

Capital.com Açık API için Model Context Protocol (MCP) sunucusu - Capital.com işlem hesabınıza LLM tabanlı erişim sağlar.

⚠️ Önemli Bildirim

Capital.com Genel API'sini ve yapay zeka/LLM tabanlı araçlar dahil üçüncü taraf araçları 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 sonuçlarını onaylamaz veya sorumluluğunu üstlenmez. Buradaki hiçbir şey yatırım tavsiyesi değildir. Üçüncü taraf araçların neden olduğu gecikmelerden kaynaklanan fiyat farkları dahil olmak üzere ticari kararlarınızdan yalnızca siz sorumlusunuz ve geçerli şartlara ve yasalara uymalısınız.

Kripto Türevleri, Capital Com (UK) Ltd'ye kayıtlı Perakende müşteriler için mevcut değildir.

• Canlı işlem yapmayı düşünmeden önce her zaman bir Demo hesabıyla başlayın
• İşlem yapma varsayılan olarak etkindir ve yapılandırmada devre dışı bırakılabilir
• 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 limitleri
• 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ıç Rehberi

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ı 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 (örn. "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

Yapay Zeka Destekli Kurulum: Bu proje klasörünü yapay zeka destekli bir düzenleyicide (Claude Code, Cursor, Windsurf) açın ve Capital.com MCP sunucusunu kurmasını isteyin — ortamınız için en iyi yöntemi seçerek kurulumda size rehberlik etmek için INSTALL.md dosyasını takip edecektir.

Ayrıca şu manuel kurulum seçeneklerine de sahipsiniz:

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

Depo, önceden oluşturulmuş bir capital-mcp.mcpb paketi içerir — Claude Desktop'ta açın ve işiniz biter, 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 Kur'a tıklayın.
4. Claude Desktop'u yeniden başlatın ve "Capital.com'da hangi araçlar mevcut?" diye sorarak doğrulayın.

Seçenek B: Komut Dosyasıyla 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 komut dosyası bir sanal ortam oluşturacak, bağımlılıkları yükleyecek ve MCP istemci yapılandırmasını sizin için yazdıracaktır.

Kimlik bilgilerinizle .env dosyasını 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
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

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ı

Zorunlu

• 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 - İşlem yapmayı etkinleştir (varsayılan: true)
• CAP_ALLOWED_EPICS - İşlem yapılmasına izin verilen araçlar (varsayılan: ALL, her araç). Virgülle ayrılmış bir listeyle kısıtlayın, örn. "SILVER,GOLD,BTCUSD". Boş, tüm işlemleri engeller
• CAP_MAX_POSITION_SIZE - Maksimum pozisyon boyutu (varsayılan: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Maksimum emir boyutu (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 sonra varsayılan hesap
• CAP_HTTP_TIMEOUT_S - HTTP zaman aşımı (varsayılan: 15)
• CAP_LOG_LEVEL - Günlük düzeyi: 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 Verileri	6	Arama, detaylar, fiyatlar, duyarlılık, gezinme
Hesap	6	Hesapları listele, tercihler, faaliyet/işlem geçmişi, demo bakiye yükleme
İşlem	13	Önizleme, yürütme, pozisyonları kapat; bekleyen emirleri listele/iptal et/değiştir; onaylar
İzleme Listeleri	6	İzleme listeleri 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	İşlem koşulları için bir izleme listesini tara
trade_proposal	Risk tabanlı boyutlandırma ile bir işlem planla (yalnızca önizleme)
execute_trade	Daha önce önizlenen bir işlemi yürüt
position_review	Açık pozisyonları ve maruziyeti analiz et (salt okunur)
live_price_monitor	Hareket uyarılarıyla gerçek zamanlı fiyat takibi (WebSocket)
real_time_alerts	Koşullu fiyat seviyesi uyarıları (WebSocket)
live_portfolio_monitor	Canlı portföy K/Z paneli (WebSocket)

Kaynak	Açıklama
cap://status	Sunucu sağlığı, oturum durumu, hız limitleri
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ı getirme)

Tam ayrıntılar, parametreler ve örnekler için bkz. USAGE.md.

İşlem Yürütme Süreci

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

Tüm yan etkili işlemler katı bir önizleme → yürütme akışı kullanır:

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

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

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

   • Kritik kontrolleri yeniden çalıştırır
   • CAP_REQUIRE_EXPLICIT_CONFIRM=true ise confirm=true gerektirir
   • Komisyoncu onayını yoklar
   • 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; varsayılan ALL her araca izin verir
• Boyut Limitleri: Maksimum pozisyon/emir boyutu uygulanır
• Pozisyon Limitleri: Herhangi bir zamanda maksimum açık pozisyon
• Günlük Limitler: Günlük maksimum emir sayısı
• Boyut Normalleştirme: Komisyoncu min/maks/artış değerlerine yuvarlar
• Kuru Çalıştırma Modu: Etkinleştirildiğinde tüm yürütmeleri engeller

Dokümantasyon

• Kullanım Rehberi: USAGE.md - Örneklerle kapsamlı kullanım rehberi
• 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 makinenizde yerel olarak çalışır ve sağladığınız kimlik bilgilerini kullanarak doğrudan Capital.com Genel API'si ile iletişim kurar. Barındırılan bir hizmet olarak çalışmaz ve kendi sunucuları yoktur.

Veri toplama

MCP sunucusu hiçbir veri toplamaz veya saklamaz. Yapay zeka istemciniz ile Capital.com Genel API'si 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: Yapay zeka istemciniz, kendi gizlilik politikasına uygun olarak kendisinden geçen verileri işleyebilir, kaydedebilir veya saklayabilir; bunu ayrıca incelemelisiniz.

Üçüncü taraf paylaşımı

MCP sunucusu verileri hiçbir üçüncü tarafla paylaşmaz. Veriler yalnızca yerel ortamınız ile Capital.com Genel API'si arasında akar ve Capital.com'un kendi Gizlilik Politikasına tabidir.

Veri saklama

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

API Kimlik Bilgileri

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

İletişim

Capital.com hesabınızla ilgili gizlilik sorularınız veya Capital.com'un verilerinizi nasıl işlediği hakkında sorularınız için Capital.com Gizlilik Politikası bölümüne bakın veya support@capital.com adresiyle iletişime geçin.

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

Üçüncü Taraf Entegrasyonu

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

Genel API'nin Kullanımı

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

Yalnızca İcra Hizmeti ve Yatırım Tavsiyesi Verilmemesi

Capital.com hizmetlerini yalnızca icra esaslı olarak sunmaktadır. Finansal araçların ticareti önemli kayıp riski içerir. Bu sayfada, Public API'de veya herhangi bir üçüncü taraf yazılımında ya da entegrasyonunda yer alan hiçbir içerik yatırım tavsiyesi, kişisel öneri veya herhangi bir finansal aracı satın alma ya da satma teklifi teşkil etmez. Bu, AI, LLM tabanlı veya diğer otomatik araçlar tarafından üretilen her türlü çıktı, sinyal, öneri veya analizi de kapsar. Tüm ticaret kararları, otomatik veya algoritmik faaliyetler dahil olmak üzere, tamamen kendi riskiniz altında alınır ve yalnızca sizin sorumluluğunuzdadır. 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 öneri olarak yorumlanabilecek içerik üretmeyeceğini garanti edemez. Bu tür çıktılar Capital.com tarafından veya onun adına sağlanmaz ve tavsiye olarak güvenilmemelidir.

Otomatik ve Algoritmik Ticaretin Riskleri

Public API'nin otomatik veya algoritmik ticaret 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.

AI veya LLM tabanlı araçların piyasa verileri veya fiyat bilgilerini almak için kullanıldığı durumlarda, 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 icrayı sağlamaya çalışır; kontrolü dışındaki üçüncü taraf araçlardan veya sistemlerden kaynaklanan gecikme nedeniyle oluşan fiyat farklılıkları için sorumluluk kabul etmeyiz.

Yasaklı Kullanım

Public API ve bağlı araçların kullanımı, Capital.com platformunu manipüle etmek, fiyat veya gecikmeden yararlanmak, piyasa suiistimaline girişmek veya 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ğinde 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ını veya entegrasyonunu kullanımınızın Capital.com'un Hüküm ve Koşullarına, Elektronik Ticaret Hükümlerine ve bulunduğunuz yargı bölgesindeki tüm geçerli yasa ve düzenlemelere uygun olduğundan emin olmak sizin sorumluluğunuzdadır. Otomatik ticaret araçlarını kullanmadan önce, bunların koşullarınıza, deneyiminize ve risk toleransınıza uygun olup olmadığını dikkatlice değerlendirmelisiniz. Capital.com, otomatik araçları veya entegrasyonları canlı ticaret ortamına bağlamadan önce bir Demo hesabı kullanarak kapsamlı bir şekilde test etmenizi şiddetle tavsiye eder.