Twelve Data

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+ teknik gösterge, temel veriler, kazançlar, temettüler, ETF'ler, şirket haberleri, piyasa hareketlileri ve daha fazlası.

Bir Twelve Data hesabınız olması gerekir. twelvedata.com adresinden kaydolun.

Bunu kullanmanın iki yolu vardır. Çoğu kişi bulut sunucusunu kullanmalıdır (Seçenek 1) — kurulacak bir şey yoktur.

---

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

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'a tıklayın — tarayıcınızda bir Twelve Data giriş sayfası açılır.
4. Yetki verin ve işiniz bitti. "AAPL için RSI nedir?" veya "Bana TSLA'nın son kazançlarını göster" gibi şeyler sorun.

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 penceresiyle giriş yapın.

MCP ana bilgisayarı belirteç yayınlamaz. Bağlayıcı URL'si https://mcp.twelvedata.com/mcp'dır. İstemci, korunan kaynak meta verilerinde adı geçen yetkilendirme sunucusuna bu URL'nin korunan kaynak meta verilerini izlemelidir. Bir bağlayıcıyı ana bilgisayar köküne yönlendirmeyin (404 yanıtı verir) veya bu ana bilgisayarın /register veya /.well-known/oauth-authorization-server adreslerine yönlendirmeyin.

Perplexity (özel uzak bağlayıcı)

Perplexity Pro, Max ve Enterprise kullanıcıları, barındırılan sunucuyu özel bir uzak bağlayıcı olarak ekleyebilir. Bu, Perplexity'nin herkese açık seçilmiş dizininde bir liste değil, hesap başına bir kurulumdur.

1. Perplexity'de Hesap ayarları → Bağlayıcılar → + Özel bağlayıcı seçeneğini açın ve Uzak seçeneğini belirleyin. Enterprise'da, bir yöneticinin önce özel bağlayıcılara izin vermesi gerekebilir.
2. Ad alanını Twelve Data ve MCP Sunucu URL'si alanını https://mcp.twelvedata.com/mcp olarak ayarlayın.
3. Kimlik doğrulama için OAuth ve aktarım için Akışkan HTTP seçin. İstemci Kimliği ve İstemci Sırrı alanlarını boş bırakın, böylece Perplexity, sunucunun korunan kaynak meta verilerinde adı geçen yetkilendirme sunucusunda dinamik istemci kaydını kullanabilir.
4. Perplexity'nin özel bağlayıcı onayını kabul edin ve Ekle'ye tıklayın. Ardından kimlik doğrulamayı başlatmak için Twelve Data bağlayıcı kartına tıklayın, Twelve Data hesabınıza giriş yapın ve erişime izin verin.
5. Bağlayıcı etkinleştirildikten sonra şu istemleri deneyin:
   • "AAPL sembolünü bulmak için Twelve Data'yı kullan."
   • "AAPL için fiyat ve hacim dahil en son kote bilgisini almak için Twelve Data'yı kullan."
   • "AAPL için son beş günlük kapanış fiyatını göstermek için Twelve Data'yı kullan."
   • "AAPL RSI'sını göstermek için Twelve Data'yı kullan."

Her kişi kendi Twelve Data hesabıyla giriş yapar. Bir Enterprise yöneticisi bağlayıcıyı paylaşırsa, her üye için bireysel kimlik doğrulama isteyin. Bağlayıcının API Anahtarı kimlik doğrulama alanına bir Twelve Data API anahtarı yapıştırmayın.

OAuth penceresi engellenirse, giriş başarısız olursa veya araçlar boşta kalma süresinden sonra durursa, Twelve Data bağlayıcısını açın, devre dışı bırakın, yeniden etkinleştirin ve giriş yapın. Bağlayıcıyı API Anahtarı kimlik doğrulamasına geçirmek yerine bu şekilde yeniden bağlanın. URL'nin tam olarak https://mcp.twelvedata.com/mcp olduğunu ve sondaki eğik çizgi olmadığını ve Twelve Data planının istenen verileri içerdiğini doğrulayın. Güncel ayar ekranları için Perplexity'nin özel uzak bağlayıcı kılavuzuna bakın.

Codex (CLI, masaüstü ve IDE)

Bu depoyu kurmadan veya bir API anahtarı kopyalamadan barındırılan MCP sunucusunu Codex'e ekleyin:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add komutu OAuth'u başlatır: tarayıcınızda Twelve Data girişini tamamlayın. Daha sonra tekrar yetkilendirmeniz gerekirse codex mcp login twelvedata komutunu çalıştırın. Codex'te bağlantıyı kontrol etmek için /mcp kullanın, ardından şunu sorun: "AAPL için en son kote bilgisini almak için Twelve Data'yı kullan." ve "AAPL RSI'sını göstermek için Twelve Data'yı kullan." Bağlantıyı kesmek için codex mcp remove twelvedata komutunu çalıştırın.

Genel eklenti deposu https://github.com/MazeBraker/twelvedata-skills.'dir. Becerileri ve aynı barındırılan MCP'yi kurar:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Seçenek 2 — Bir API anahtarıyla kendiniz çalıştırın

Sunucuyu kendi makinenizde çalıştırmayı mı tercih edersiniz? Yalnızca Twelve Data API anahtarınıza ihtiyacınız var — OAuth kurulumu yok. twelvedata.com adresinden → kontrol paneliniz → API Anahtarları bölümünden alın.

1. Kurulum

Python 3.10+ gerektirir (3.12 önerilir; macOS'ta brew install python@3.12 veya make python-install).

make install

2. API anahtarınızı ekleyin

Proje kökünde, yalnızca sizin okuyabileceğiniz anahtarınızla bir .env dosyası oluşturun:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Sunucu anahtarı .env dosyasından okur ve her istekte kullanır. Giriş adımı gerekmez.

3. stdio üzerinden bağlanın

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

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/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.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. HTTP üzerinden bağlanın

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Docker'da çalıştırın

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file anahtarı kabuk geçmişinizden uzak tutar. 4. adımdaki gibi http://localhost:8000/mcp adresine bağlanın. OAuth girişi Docker'da desteklenmez.

6. Güvenlik

• make run ve Docker, /mcp adresini kimlik doğrulama olmadan, varsayılan olarak 0.0.0.0 üzerinde sunar.
• Her çağrı sizin kimlik bilginizle sunulur.
• Bağlantı noktasına erişen herkes auth_status ve oauth_configure çağrılarını yapabilir. Bu, varsayılan bağlamanın ne Host ne de Origin başlığını kontrol etmemesi nedeniyle DNS yeniden bağlama yoluyla açtığınız bir web sayfasını da içerir.
• MCP_HOST=127.0.0.1 make run sunucuyu yerel tutar ve MCP SDK'sının Host ve Origin kontrolünü etkinleştirir.
• MCP_HOST=127.0.0.1 ile ngrok yalnızca --host-header=rewrite ile başlatıldığında çalışır.

7. Sorun giderme

Önce istemcinizden auth_status çağrısını yapın. Bir API anahtarının yapılandırılıp yapılandırılmadığını, saklanan belirteci, algılanan ana bilgisayarı ve yeniden yönlendirme URI'sini gösterir — genellikle neyin eksik olduğunu görmek için yeterlidir.

---

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+ daha fazlası
• Temel veriler — finansal tablolar, kazançlar, temettüler, hisse bölünmeleri, şirket profilleri, piyasa değeri, temel istatistikler, IPO takvimi
• Fonlar — ETF ve yatırım fonu profilleri, performans, holdingler, risk
• Haberler — şirket haberleri ve basın bültenleri
• Piyasa istihbaratı — hareketliler, döviz kurları, analist derecelendirmeleri, fiyat hedefleri
• Düzenleyici — SEC/EDGAR dosyaları, içeriden öğrenen işlemleri, kurumsal holdingler

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.