Twelve Data MCP Server

Twelve Data MCP Sunucusu

Claude, ChatGPT ve diğer yapay zeka asistanlarını Twelve Data finans API'sine bağlayın — gerçek zamanlı ve geçmiş fiyatlar, 60'tan fazla teknik gösterge, temel veriler, kazançlar, temettüler, ETF'ler, şirket haberleri, piyasa hareketlileri ve daha fazlası.

Bir Twelve Data hesabına ihtiyacınız var. twelvedata.com adresinden kaydolun.

Kullanmanın iki yolu var. Çoğu kişi bulut sunucusunu kullanmalıdır (Seçenek 1) — kurulum gerektirmez.

---

Seçenek 1 — Bulut sunucumuzu kullanın (önerilir)

Yapay zeka asistanınızı barındırılan sunucumuza bağlayın:

https://mcp.twelvedata.com/mcp

Hepsi bu kadar. Kurulum yok, kopyalayıp yapıştıracak API anahtarı yok. Bağlandığınızda bir tarayıcı penceresi açılır ve Twelve Data hesabınızla giriş yaparsınız — kişisel API anahtarınız otomatik olarak bağlanır ve hesabınıza bağlı kalır.

Nasıl eklenir

Claude (Masaüstü / Web) ve ChatGPT özel bağlayıcıları / MCP sunucularını destekler:

1. Asistanınızın Bağlayıcılar (veya Entegrasyonlar / MCP sunucuları) ayarlarını açın.
2. https://mcp.twelvedata.com/mcp URL'si ile yeni bir bağlayıcı ekleyin.
3. İstendiğinde, Bağlan / Giriş yap düğmesine tıklayın — tarayıcınızda bir Twelve Data giriş sayfası açılır.
4. Yetkilendirin ve işlem tamam. "AAPL için RSI nedir?" veya "Bana TSLA'nın son kazançlarını göster" gibi şeyler sorun.

Tam menü adları uygulamalar ve sürümler arasında farklılık gösterir, ancak akış her zaman aynıdır: URL'yi ekleyin, ardından tarayıcı açılır penceresi aracılığıyla giriş yapın.

---

Seçenek 2 — API anahtarınızla yerel olarak çalıştırın

Sunucuyu kendi makinenizde çalıştırmayı mı tercih ediyorsunuz (ör. stdio üzerinden Claude Desktop için)? Yalnızca Twelve Data API anahtarınıza ihtiyacınız var — OAuth kurulumu gerekmez.

1. API anahtarınızı alın

twelvedata.com adresinden giriş yapın → kontrol paneliniz → API Anahtarları. Anahtarınızı kopyalayın.

2. Kurulum

Python 3.10+ gerektirir (3.12 önerilir; macOS'te brew install [email protected] veya make python-install).

make install

3. API anahtarınızı ekleyin

Proje kök dizininde anahtarınızı içeren bir .env dosyası oluşturun:

TWELVE_DATA_API_KEY=your_api_key_here

4. Claude Desktop'a bağlanın

~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

.venv/bin/python yolunu kullanın (sistem Python'unu değil — macOS 3.9 ile gelir ve bu sunucu 3.10+ gerektirir). Yapılandırmayı düzenledikten sonra Claude Desktop'ı yeniden başlatın.

Hepsi bu kadar — sunucu API anahtarınızı .env dosyasından okur ve her istek onu kullanır. Giriş adımı gerekmez.

---

Neler sorabilirsiniz

• Fiyatlar — hisse senetleri, ETF'ler, forex, kripto, emtialar (gerçek zamanlı ve geçmiş)
• Teknik göstergeler — RSI, MACD, SMA, BBANDS, ATR ve 60'tan fazlası
• Temel veriler — finansal tablolar, kazançlar, temettüler, bölünmeler, şirket profilleri, piyasa değeri, temel istatistikler, halka arz takvimi
• Fonlar — ETF ve yatırım fonu profilleri, performans, varlıklar, risk
• Haberler — şirket haberleri ve basın bültenleri
• Piyasa istihbaratı — hareketliler, döviz kurları, analist derecelendirmeleri, fiyat hedefleri
• Düzenleyici — SEC/EDGAR dosyalamaları, içeriden öğrenen işlemleri, kurumsal varlıklar

Sembol formatları: hisse senetleri AAPL, kripto BTC/USD, forex EUR/USD.

---

Ortaklar

Kendi genel örneğinizi mi çalıştırıyorsunuz veya özel bir OAuth girişi mi kuruyorsunuz? Bu bir ortaklık düzenlemesidir — twelvedata.com adresinden bize ulaşın ve size kurulum kılavuzunu ve OAuth kimlik bilgilerini sağlayalım.