AlvestMCP

Claude Desktop'a portföyünü bağla

Anthropic Model Context Protocol (MCP) ile Alvest'in tool'larını Claude Desktop, Cursor, Windsurf veya herhangi MCP-uyumlu IDE'de kullan. Doğal dilde sor - anında cevap.

ÖRNEK SORULAR
  • "Portföyümün özetini ver"
  • "Bu hafta hangi sembolde en çok kaybettim?"
  • "Son 30 günde aldığım kripto işlemleri listele"
  • "ASELS'in güncel fiyatı ne?"
  • "Bu haftaki AI içgörümü göster"

Kurulum (3 adım)

1

API key oluştur

Alvest'e Pro/Premium hesabınla giriş yap → Ayarlar → MCP → "Yeni Key Oluştur".
Key bir kez gösterilir - güvenli yere kaydet.

2

Claude Desktop'a ekle

Claude Desktop → Settings → Developer → Edit Config. claude_desktop_config.json:

{
  "mcpServers": {
    "alvest": {
      "url": "https://alvest.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer alv_mcp_xxxx_xxxx_xxxx_xxxx"
      }
    }
  }
}

alv_mcp_… kısmını 1. adımda aldığın key ile değiştir. Claude Desktop'ı yeniden başlat.

3

Test et

Claude Desktop'ta yeni sohbet aç. Tool ikonunda "alvest" görünecek.
"Alvest portföyümün özetini ver" yaz - Claude tool'u çağırır + cevaplar.

Mevcut Tool'lar (11)

get_portfolio_summary
Portföy özeti: toplam değer, K/Z, top 5 pozisyon
get_transactions
İşlem geçmişi (ticker / type / tarih filtresi)
get_market_data
Sembol için canlı fiyat (crypto/us/bist/eu/etf/tefas)
search_universe
Asset Universe içinde sembol/ad araması (~22k)
get_weekly_insight
Son AI haftalık içgörü
get_tax_summary
Yıl bazlı FIFO + Yİ-ÜFE + GVK 103 vergi tahmini
analyze_tax_strategy
AI Tax Assistant - kişiselleştirilmiş öneriler
get_predictions
Reel kahin tahminleri + başarı oranı
create_prediction
Yeni kahin tahmini oluştur (write scope)
get_cashback_balance
Cashback bakiyesi + son itfalar
get_real_return
Reel getiri (TÜFE/altın/USD karşısında)

Resources (5)

URI-addressable veri kaynakları (otomatik fetch için):

portfolio://current
Anlık portföy özeti
portfolio://positions
Tüm açık pozisyonlar
tax://current-year
Mevcut yıl vergi raporu
cashback://balance
Cashback bakiyesi
social://profile
Reel sosyal profili

Slash Komutlar (5)

Claude Desktop'ta hızlı tetik için önceden hazır şablonlar:

/portfolio_health
Sağlık taraması - sektör konsantrasyonu + riskler
/tax_optimization
Vergi optimizasyon önerileri (year arg)
/week_brief
Bu haftaki portföy hareketi özeti
/symbol_deep_dive
Bir sembolün derin analizi (symbol arg)
/find_tlh_candidates
Tax-Loss Harvesting adayları

Güvenlik & KVKK

  • Her key kullanıcıya bağlı - kendi verisinden başka bir şey görmez.
  • API key hash'li saklanır - DB'de sadece sha256(key); ham key tek seferlik gösterilir.
  • Her çağrı audit log'a yazılır - Ayarlar'dan tarihsel kullanım görebilirsin.
  • Plan downgrade key'i devre dışı bırakır - Pro/Premium/SMM gerektirir.
  • İstediğin zaman iptal edebilirsin - soft-delete, anında etkili.
Uygulamaya dön →
MCP Server v1.0 · https://alvest.app/api/mcp
Anthropic Model Context Protocol · Streamable HTTP transport