Belgeler Veri
Harici veri kullanımı
Hazır veride olmayan bir veri (ör. VİOP, takas, derinlik ya da anlık kotasyon) gerektiğinde Claude bu veriyi Claude Code oturumuna bağlı başka bir kaynaktan alır ve köken bilgisiyle analyze_external_data aracına gönderir. BorsaMCP bu kendi verini doğrular, normalize eder ve deterministik olarak analiz eder; veri sağlayıcına kendisi bağlanmaz.
Veri nasıl girer?
- Sen Claude'a sorarsın.
- Claude oturumdaki bağlı araçlara ve veri kaynaklarına bakar.
- Kaynak veriyi ve kökenini (kaynak, zaman, nitelik) verir.
- Claude uygun veriyi köken bilgisiyle BorsaMCP'ye gönderir.
- BorsaMCP doğrular ve normalize eder.
- Deterministik araştırma çekirdeği kendi verinin analizini (baz, hacim, yoğunlaşma gibi) hesaplar.
- Sonuç, kabul edilen zaman seviyesi ve sınırlarla döner.
Claude “veri yok” demeden önce oturumdaki bağlı kaynaklara bakmalıdır. Uygun kaynak yoksa doğru cevap, verinin erişilebilir olmadığıdır.
SINIRBorsaMCP harici kaynaklara bağlanmaz ve sağlayıcı kimlik bilgilerini yönetmez. Kaynağın doğruluğunu da doğrulayamaz: yalnız biçimi, kökeni ve zamanı kontrol eder.
Desteklenen veri aileleri
| Veri türü | Aile | Örnek içerik |
|---|---|---|
EQUITY_BARS | Hisse barları | Tarihli fiyat ve hacim serisi |
EQUITY_QUOTE | Hisse kotasyonu | Anlık ya da gecikmeli fiyat, alış/satış |
DERIVATIVES | Türev / VİOP | Kontrat fiyatı, açık pozisyon, dayanak fiyatı |
BROKER_FLOW | Aracı kurum / takas akışı | Aracı kurum bazında alış, satış, net |
ORDER_BOOK | Emir defteri | Fiyat kademeleri ve miktarlar |
FX | Kur | Kur, alış/satış, forward, swap puanı |
Bu aileler veri biçimini tanımlar; belirli bir aracı kurum ya da veri sağlayıcıyla doğrulanmış bir entegrasyon anlamına gelmez. Lisanslı piyasa verisi, kaynağın ve senin o veriyi kullanma yetkin varsa aynı yoldan girer.
Hazır veri ve bağlı kaynak
| Veri | Hazır veri | Bağlı kaynak |
|---|---|---|
| Günlük kamu piyasa ve finansal verisi | Var (bkz. Hazır veri) | Kaynak sağlıyorsa |
| Gerçek zamanlı piyasa verisi | Yok | Kaynak sağlayıcı zaman damgasıyla veriyorsa |
| Lisanslı ya da özel veri | Genel bir hak yok | Sen ve kaynak yetkiliyseniz |
| Sağlayıcı kimlik bilgileri | Kabul edilmez | Kaynakta ve istemcide kalır |
Kimlik bilgilerini gönderme
Kimlik bilgilerini BorsaMCP'ye göndermeyin. Sistem yaygın kimlik bilgisi alanlarını reddeder, ancak bu kontrol bilinçli veri minimizasyonunun yerine geçmez.
Harici veri içinde, iç içe alanlar dahil, adı password, token, apiKey, secret, cookie, session, authorization ya da credential gibi kalıpları taşıyan bir alan varsa istek SECRET_FIELD_REJECTED ile reddedilir.
SINIRKontrol alan adına göre çalışır. Masum adlı bir alanın değerine yazılmış bir sırrı ayırt edemez. Sağlayıcı kullanıcı adını, parolasını, API anahtarını ya da oturum çerezini asistana veri olarak verme.
Aracı kurum ve takas: kimlik sınırı
Aracı kurum akışında kayıt yalnız BROKER (aracı kurum) ya da CUSTODIAN (saklamacı) düzeyinde olabilir. Nihai faydalanıcı, aynı kişi, aynı yatırımcı ya da nihai kontrol eden gibi kimlik düzeyleri kabul edilmez; bu tür bir kayıt gönderilirse istek reddedilir. Yoğunlaşma sonucu “aynı kişi alıyor” ya da “kurumsal alım var” anlamına gelmez.
Arbitraj
BorsaMCP'de arbitraj motoru yoktur. Sert arbitraj değerlendirmesi eş zamanlı doğrudan fiyatlar, alış/satış, işlem maliyeti, fonlama ve taşıma gibi bilgileri gerektirir; harici veri sözleşmesi bunları taşımaz. Bu analiz istenirse sonuç her zaman HARD_ARBITRAGE_NOT_EVALUABLE olur ve kotadan düşmez.
Örnek istekler
“Bağlı veri kaynağından güncel VİOP verisini al ve BorsaMCP ile analiz et.”
“Bu analizde kullanılan verilerin zamanlamasını ve doğrudan mı vekil mi olduğunu da belirt.”
“Bağlı kaynaktaki takas dağılımı yoğun mu? Yalnız aracı kurum düzeyinde yorumla.”
Alan listesi, köken alanları, sınırlar ve hata kodları: analyze_external_data başvurusu.