Kullanım KılavuzuUser Guide

Paranın nerede daha çok kazandığını tek ekranda gör. Bu kılavuz ParaAlfa'yı nasıl kullanacağını sade bir dille anlatır. See where your money earns the most, all on one screen. This guide explains how to use ParaAlfa in plain language.

ParaAlfa nedir?What is ParaAlfa?

ParaAlfa, "param nerede daha iyi kazanır?" sorusunu tek yerde cevaplayan bir araçtır. TEFAS yatırım fonlarını, banka mevduat faizlerini ve senin kendi portföyünü aynı ölçüyle karşılaştırır — hepsi güncel, gerçek verilerle. ParaAlfa answers one question in one place: "where does my money earn more?" It compares TEFAS investment funds, bank deposit rates and your own portfolio — side by side, with fresh, real data.

Önemli: ParaAlfa bir bilgilendirme aracıdır — yatırım tavsiyesi veya vergi danışmanlığı değildir. Sana veriyi sade ve karşılaştırılabilir gösterir; kararı sen verirsin. Important: ParaAlfa is an information tool — not investment advice or tax counsel. It shows data clearly and comparably; the decision is yours.

Ne yapabilirsin?What you can do

En çok kazandıran fonlarTop-earning funds

Risk seviyene göre (düşük · orta · yüksek) en çok kazandıran fonları, günlükten yıllığa kadar gör.See the best-performing funds by risk level (low · mid · high), from daily to yearly returns.

Banka faizleriBank rates

Bankaların TL mevduat oranlarını tutar ve vadeye göre karşılaştır — standart ve kampanya oranı ayrı.Compare banks' deposit rates by amount and term — standard and promo rates shown separately.

PortföyümMy portfolio

Yatırımlarını ekle; güncel değerini ve stopaj sonrası net kazancını otomatik takip et.Add your investments; track current value and net gain after tax automatically.

Ne kazandırırdı?What would it earn?

"Geçmişte şu parayı dolara/altına/mevduata/fona koysaydım ne olurdu?" — tek tıkla kıyasla."What if I'd put this money in USD/gold/deposit/a fund back then?" — compare in one click.

Makro göstergelerMacro indicators

Enflasyon, faiz, dolar gibi göstergeler + her biri için sade fon seçim ipuçları.Inflation, rates, FX and more — each with a simple fund-selection hint.

Telegram bildirimleriTelegram alerts

Portföyün güncellenince, bir fon sert hareket edince ya da favorilerin değişince Telegram'dan haber al.Get a Telegram ping when your portfolio updates, a fund moves sharply, or your favorites change.

Enflasyona karşı reel getiriReal return vs inflation

Kazandın mı, yoksa sadece enflasyona mı yetiştin? Fonun getirisi enflasyondan arındırılmış olarak da gösterilir.Did you actually gain, or just keep up with inflation? Returns are also shown adjusted for inflation.

Hesapsız fon sayfalarıFund pages, no account

Her TEFAS fonunun kendi açık sayfası var — link olarak paylaşabilir, giriş yapmadan okuyabilirsin.Every TEFAS fund has its own public page — shareable as a link, readable without logging in.

Nasıl başlarım?Getting started

  1. Kayıt ol. E-posta ve şifrenle bir hesap oluştur (ya da Google ile — açıksa).Sign up. Create an account with your email and password (or with Google — if enabled).
  2. E-postanı doğrula. Gelen kutuna düşen linke tıkla.Confirm your email. Click the link sent to your inbox.
  3. Giriş yap. Artık fonları, faizleri ve portföyünü görebilirsin.Log in. Now you can see funds, rates and your portfolio.
İpucu: Fon listelerine ve banka faizlerine bakmak için giriş gerekmez; yalnız kendi portföyün için hesap lazım.Tip: You don't need an account to browse funds and bank rates; login is only needed for your own portfolio.

Portföyümü takip etTrack your portfolio

Portföyüm sekmesinde yatırımlarını eklersin ve hepsinin güncel durumunu tek bakışta görürsün.In the My Portfolio tab you add your investments and see everything at a glance.

  1. Fon kodu + tutar gir (örn. TP2, 10.000 ₺).Enter a fund code + amount (e.g. TP2, 10,000 ₺).
  2. İstersen alış tarihini ekle — o günkü fiyattan gerçek getirin hesaplanır.Optionally add the purchase date — your real return is calculated from that day's price.
  3. Net kazancını gör: güncel değer, stopaj ve stopaj sonrası kazanç otomatik gelir.See your net gain: current value, tax and after-tax profit appear automatically.
  4. Aynı fona ekleme yap: bir fondan tekrar alırsan satırdaki + Alım ekle ile hızlıca eklersin. Aynı fonun tüm alımları tek satırda toplanır (ağırlıklı ort. maliyet + birleşik net kazanç); satırı açınca alımları tek tek görürsün.Add to the same fund: buying more? Use + Add buy on the row. All buys of a fund fold into one row (weighted average cost + combined net gain); expand it to see each buy.
  5. Sattığında çıkış gir: fonun tamamından ya da bir kısmından çıkabilirsin. Çıkış anındaki fiyattan gerçekleşen net kazancın hesaplanır ve kayda geçer; kalan kısım portföyünde durmaya devam eder.Record an exit when you sell: exit a position fully or partially. Your realized net gain is computed at the exit price and recorded; whatever is left stays in your portfolio.

Ayrıca değer geçmişi grafiği, aylık kazanç ve "aynı para mevduatta/dolarda olsaydı" kıyası da burada. Yaptığın her alım, çıkış ve silme İşlem geçmişinde tutulur — istersen tek tuşla temizlersin.You also get a value-history chart, monthly gains, and a "what if it were in a deposit/USD instead" comparison. Every buy, exit and deletion is kept in your activity history — which you can clear whenever you like.

Sepetler: Portföyünü adlandırılmış sepetlere (örn. "Emeklilik", "Acil Fon") bölebilirsin. Üstteki sekmelerden yeni sepet oluştur, adını kendin koy; her fon tek bir sepette durur, sepetler arası taşıyabilirsin. Her sepetin kendi kâr/zararını ayrı görürsün. Sepeti silersen fonlar silinmez — Ana Sepet'e döner.Baskets: Split your portfolio into named baskets (e.g. "Retirement", "Emergency"). Create one from the top tabs and name it yourself; each fund lives in a single basket and can be moved between them. You see each basket's own profit/loss. Deleting a basket never deletes funds — they move back to the Main Basket.

Hazır Sepetler: "🧩 Hazır sepet" ile 20 hazır arketip açılır (Rahat, Orta Riskli, Emeklilik, Katılım, Hisse Ağırlık…). Tercihine Göre sekmesinde 5 kısa soruyu (amaç, vade, düşüşte tepkin, deneyim, katılım fonu) yanıtla → tercihlerinle eşleşen sepetler, hangi kritere göre eşleştikleriyle birlikte listelenir. Tavsiye değildir. Fonlar güven skoruyla seçilir (deterministik), her karta güncel bir piyasa notu eklenir. Tutarı sen belirle → oranlara göre otomatik kurulur.Ready-made baskets: "🧩 Ready basket" opens 20 archetypes (Relaxed, Medium Risk, Retirement, Participation, Equity-heavy…). In the By Preference tab, answer 5 short questions (goal, horizon, reaction to a drop, experience, participation funds) → baskets matching your selection are listed, each showing which criterion it matched. Not advice. Funds are picked by confidence score (deterministic), each card carries a current market note. You set the amount → it's built automatically by ratio.

Stopaj hakkında: Vergi yalnız kazançtan kesilir; oran fon türüne göre otomatik uygulanır ve yaklaşıktır — kesin tutar için bankana/aracına danış.About tax: Tax applies only to gains; the rate is applied automatically by fund type and is approximate — check with your bank/broker for the exact figure.

Fonları inceleExplore funds

Ana ekran fonları risk grubuna göre sıralar: Düşük (1–2), Orta (3–4), Yüksek (5–6–7). Üstteki sekmelerden zaman aralığını (günlük → yıllık) seçersin.The main screen ranks funds by risk group: Low (1–2), Mid (3–4), High (5–6–7). Pick the time window (daily → yearly) from the top tabs.

Bir fona tıkla → sağdan açılan panelde: getiri grafiği, fonun neye yatırdığı (portföy dağılımı) ve BİST/altın/dolar/mevduat ile kıyas.Tap a fund → a side panel opens with its return chart, what it invests in (allocation), and a comparison vs stocks/gold/USD/deposits.

Beğendiğin fonları ★ favorilere ekle; Favoriler sekmesinden ya da Telegram'dan takip et.Add funds you like to ★ favorites and follow them from the Favorites tab or Telegram.

Kategoriler sekmesi aynı veriye başka açıdan bakar: fonları TEFAS kategorisine göre (hisse, borçlanma araçları, katılım, kıymetli maden…) gruplar ve her kategorinin ortalama getirisini gösterir. Bir fonun iyi mi kötü mü gittiğini kendi kategorisiyle kıyaslamak için buraya bak.The Categories tab looks at the same data from another angle: it groups funds by TEFAS category (equity, debt instruments, participation, precious metals…) and shows each category's average return. Use it to judge a fund against its own peer group rather than the whole market.

Fon Taraması — kriter bazlı listeFund screen — criteria-based list

Fon Taraması, her gün her risk grubunda (düşük · orta · yüksek) fonları önceden ilan edilmiş, değişmez kriterlerden geçirir ve filtreye uyanları listeler. Bu bir tavsiye veya sıralama önerisi değil, algoritmik bir veri taramasıdır; kriterler herkese açıktır ve sonuç gelecek performans hakkında bilgi vermez.Fund Screen runs every fund in each risk group (low · mid · high) through pre-published, fixed criteria and lists those that pass. This is not advice or a recommendation — it is an algorithmic data screen; the criteria are public and the result says nothing about future performance.

Güven filtresi tek bir getiri sayısına bakmaz; fon büyüklüğü, yatırımcı sayısı, para akışı ve getiri istikrarını birlikte değerlendirir — böylece "bir günlük parlayan" fonlar değil, tutarlı olanlar öne çıkar.The filter doesn't look at a single return figure; it weighs fund size, investor count, money flow and return stability together — so it's the consistent funds that rise to the top, not one-day flashes.

Her satır, yapay zekâ destekli sade bir açıklama ile anlatılır: fon ne yapıyor, hangi kriterle filtreye girdi, hangi risk grubunda. Sayılar deterministik kod ile hesaplanır (uydurma yok); yapay zekâ yalnızca bu analizi okunaklı bir dille yazar.Each row comes with an AI-assisted plain-language note: what the fund does, which criterion it passed, which risk group it is in. The numbers are computed deterministically (nothing invented); AI only writes that analysis in readable prose.

Neden güvenilir? Seçim kuralları herkes için aynı, önceden ilan edilmiş ve tekrarlanabilir — kişiye göre değişen, "kara kutu" bir tahmin değil. Tarama hiçbir fonu tavsiye etmez; kriterlere uyanları listeler, kararı sen verirsin.Why trust it? The selection rules are identical for everyone, published in advance and repeatable — not a personalized "black-box" prediction. The screen recommends no fund; it lists what matches the criteria, and the decision is yours.

Banka faizleriBank rates

Banka Faizleri sekmesinde bankaların TL mevduat oranlarını görürsün. Tutar ve vade girersen o kademedeki gerçek oran hesaplanır (çünkü oran tutara ve vadeye göre değişir).In the Bank Rates tab you see banks' deposit rates. Enter an amount and term to get the real rate for that tier (rates change by amount and term).

İki oran ayrı gösterilir: standart (tabela) ve varsa kampanya (yeni müşteri/yeni para, koşullu). Resmî bankasından çekilen oranlar "resmî" rozetiyle işaretlidir.Two rates are shown separately: standard and, if any, promo (new customer/new money, conditional). Rates pulled from the bank's own site carry an "official" badge.

Ne kazandırırdı?What would it have earned?

Hesapla sekmesi geçmişe bakar: bir tutar + bir tarih gir, araçları seç (dolar, euro, altın, mevduat, BİST, enflasyon, kripto, fon…) → bugüne kadar ne kazandırırdı, tek grafikte.The Calculate tab looks back in time: enter an amount + a date, pick instruments (USD, EUR, gold, deposit, BIST, inflation, crypto, a fund…) → see what each would have earned until today, in one chart.

Geçmiş performans gelecek getiriyi göstermez; bu bir "olsaydı" kıyasıdır.Past performance doesn't predict future returns; this is a "what-if" comparison.

Makro & taramaMacro & screen

Makro sekmesi enflasyon, faiz, dolar gibi göstergeleri ve dünya merkez bankalarının duruşunu gösterir — her göstergenin altında sade bir fon seçim ipucu vardır.The Macro tab shows indicators like inflation, rates and FX plus global central-bank stances — each with a simple fund-selection hint.

Günün Taraması ise her risk grubunda (düşük/orta/yüksek) kriterlerden geçen fonları gün gün listeler. Otomatik ve tarafsızdır; tavsiye değildir.Daily Screen lists the funds that pass the criteria in each risk group (low/mid/high), day by day. Automatic and neutral; not advice.

Fonu nereden alırım?Where do I buy a fund?

ParaAlfa alım-satım yapmaz — bir karşılaştırma ve takip aracıdır. Beğendiğin fonu incelerken "peki bunu nereden alırım?" diye düşünürsen, seçenekler şunlar:ParaAlfa doesn't trade — it's a compare-and-track tool. When you like a fund and wonder "where do I actually buy it?", here are your options:

Kısacası: Fon kodunu ParaAlfa'da bulur, kararını verirsin; alımı kendi bankanın mobil/internet şubesindeki Yatırım/Fon bölümünden ya da aracı kurumundan yaparsın. ParaAlfa hiçbir kuruluşu önermez, komisyon almaz.In short: find the fund code in ParaAlfa and decide; you make the purchase from the Investments/Funds section of your own bank's app or your brokerage. ParaAlfa endorses no institution and takes no commission.

Herkese açık sayfalar — hesapsızPublic pages — no account

ParaAlfa'nın büyük bir kısmı giriş yapmadan açıktır. Bu sayfalar arama motorlarına da açıktır; bir fon kodunu Google'da arattığında karşına çıkan sayfa genelde bunlardan biridir. Paylaşmak için link vermen yeterli — karşı tarafın hesabı olması gerekmez.A large part of ParaAlfa works without logging in. These pages are open to search engines too — when you google a fund code, this is usually the page you land on. Sharing is just sending the link; the other person needs no account.

/fon/KODFonun kendi sayfası. Fiyat ve getiri grafiği, risk metrikleri, portföy dağılımı, BİST/altın/dolar kıyası ve enflasyondan arındırılmış reel getiri. Sadece havuzdaki değil, tüm TEFAS fonları için var. Örn. /fon/PRYThe fund's own page. Price and return chart, risk metrics, allocation, comparison vs stocks/gold/USD and inflation-adjusted real return. Available for every TEFAS fund, not just the tracked pool. E.g. /fon/PRY
/kiyas/KOD1-KOD2Fonları yan yana kıyasla. İki ya da daha fazla fonu 1 ay / 3 ay / 6 ay / 1 yıl pencerelerinde karşılaştırır, her pencerede öne çıkanı işaretler.Compare funds side by side. Two or more funds across 1M / 3M / 6M / 1Y windows, with the leader marked in each window.
/fonlarTüm fonlar dizini — baş harfe (/fonlar/a) ya da kategoriye göre gözat.Full fund directory — browse by first letter (/fonlar/a) or by category.
/kategori/...Bir TEFAS kategorisindeki fonlar tek listede (hisse, katılım, kıymetli maden…).All funds in one TEFAS category (equity, participation, precious metals…).
/haberFonlardaki gelişmeler. KAP'ta yayımlanan fon belgeleri (izahname, içtüzük, bilgi formu) her gün otomatik izlenir; bir belge değiştiğinde konu buraya düşer ve hangi fonu nasıl ilgilendirdiği yazılır. Akışı /haber/rss.xml ile takip edebilirsin. Yayın kararını insan verir.What changed in the funds. Fund documents published on KAP (prospectus, bylaws, key investor information) are tracked daily; when one changes it becomes a story here explaining which fund it affects and how. Follow the feed at /haber/rss.xml. A human approves every publication.
/blogGünlük fon analizleri. Her gün bir fon derinlemesine incelenir: getiri, risk, portföy dağılımı ve kurucunun KAP kaydı doğrulaması.Daily fund analyses. One fund in depth each day: return, risk, allocation and a KAP registry check on the founder.
/metodolojiTarama kriterlerinin tam metni. Fon Taraması'nın hangi kurallarla çalıştığı — önceden ilan edilmiş ve herkes için aynı.The screening criteria in full. Exactly how Fund Screen works — published in advance, identical for everyone.
/hakkindaKim yapıyor, veri nereden geliyor. Bağımsızlık (komisyon/affiliate/reklam yok), neyi yapmadığımız ve bilinen eksikler açıkça yazılı.Who builds this and where data comes from. Independence (no commission/affiliate/ads), what we deliberately don't do, and known gaps — stated openly.
Hesap ne için gerekli? Yalnız sana ait olan şeyler için: portföyün, sepetlerin, favorilerin, bildirimlerin ve API anahtarların. Fon verisine bakmak için hiçbir zaman giriş gerekmez.So what needs an account? Only the things that are yours: portfolio, baskets, favorites, alerts and API keys. Browsing fund data never requires a login.

Ayarlar & güvenlikSettings & security

Panelde Ayarlar sekmesi hesabınla ilgili her şeyi tek yerde toplar.The Settings tab in the panel gathers everything about your account in one place.

HesapAccount

GüvenlikSecurity

VerinYour data

Telegram botu & bildirimlerTelegram bot & alerts

Portföyünü Telegram'a bağlarsan, botla her şeyi telefonundan yapabilirsin.Link your portfolio to Telegram and do everything from your phone with the bot.

  1. Panelde Ayarlar → Bildirimler → Telegram'a Bağla de. ParaAlfa sana tek kullanımlık bir kod ve hazır bir bağlantı üretir; kod 15 dakika geçerlidir.In the panel go to Settings → Notifications → Connect Telegram. ParaAlfa generates a one-time code and a ready link; the code is valid for 15 minutes.
  2. Bağlantıya dokun — bot @paraalfabot açılır ve /start <kod> otomatik gider. Botu elle açtıysan aynı kodu kendin yaz: /start 3xK9x2Qa gibi.Tap the link — the bot @paraalfabot opens and /start <code> is sent automatically. If you opened the bot by hand, type the code yourself, e.g. /start 3xK9x2Qa.
  3. Bot "✅ Bağlandın!" der ve hangi hesaba bağlandığını gösterir. Artık /portfoy, /ayarlar gibi komutlar bu hesabına çalışır.The bot replies "✅ Connected!" and shows which account it linked. From now on commands like /portfoy, /ayarlar act on this account.
  4. Hangi bildirimleri istediğini aç/kapa ile seç — panelden ya da botta /ayarlar ile.Choose which alerts you want with simple on/off toggles — from the panel or with /ayarlar in the bot.
Güvenlik: Bağlama yalnız botla özel sohbette yapılır — botu bir gruba eklersen orada bağlanamazsın, yani gruptaki kimse portföyünü göremez. Kod tek kullanımlıktır ve 15 dakikada düşer. Bağlantıyı istediğin an Ayarlar → Bildirimler → Bağlantıyı kaldır ile kesersin; bir hesap aynı anda tek Telegram sohbetine bağlıdır.Security: Linking happens only in a private chat with the bot — adding it to a group won't let you connect there, so nobody in a group can see your portfolio. The code is one-time and expires in 15 minutes. Unlink anytime via Settings → Notifications → Unlink; one account is linked to a single Telegram chat at a time.

Bot komutlarıBot commands

/portfoyPortföy özetin (resimli kart)Your portfolio summary (image card)
/fonlarFonların tek tek — bugün & toplam kazançYour funds one by one — today & total gain
/sepetSepet sepet kârın — her sepet ayrı + genel toplamProfit by basket — each basket plus the grand total
/karKazancın (haftalık/aylık) — paylaşılabilir kartYour return (weekly/monthly) — shareable card
/eklePortföye fon ekle (listeden seç ya da yaz)Add a fund (pick from a list or type it)
/silPortföyden fon çıkar (listeden seç)Remove a fund (pick from a list)
/oneriRisk grubuna göre tarama sonuçlarıScreen results by risk group
/feedbackGörüş & öneri gönderSend feedback & suggestions
/ayarlarBildirim tercihleriNotification preferences
/esik 2Hareket uyarısı eşiğini ayarla (%0,1–50) — yazdığın anda uyarı da açılırSet the movement-alert threshold (0.1–50%) — sending it also turns the alert on
/durdurTüm bildirimleri sustur (tek anahtar)Mute all alerts (master switch)
/baslatBildirimleri yeniden açTurn alerts back on
/iptalYarım kalan bir işlemi (fon ekleme gibi) iptal etCancel a half-finished step (like adding a fund)
/yardimKomut listesi (/help de olur)Command list (/help works too)

Bazı komutların kısayolu vardır: /kazanc=/kar · /sepetler=/sepet · /tavsiye=/oneri · /geri=/feedback.Some commands have aliases: /kazanc=/kar · /sepetler=/sepet · /tavsiye=/oneri · /geri=/feedback.

Hangi bildirimler var?What alerts are there?

Hepsini birden susturmak: /durdur yaz — tek tek kapatmana gerek yok. /baslat ile eski tercihlerin geri gelir.To silence everything at once: send /durdur — no need to toggle each one. /baslat restores your previous preferences.

Geliştiriciler için: REST API & MCPFor developers: REST API & MCP

Paneldeki her sayı aynı zamanda koddan ve yapay zekâ asistanlarından erişilebilir — hepsi aynı günlük veriden. Bu bölüm isteğe bağlıdır; ParaAlfa'yı kullanmak için gerekmez.Every number in the panel is also reachable from code and from AI assistants — all from the same daily data. This section is optional; you don't need it to use ParaAlfa.

REST APIREST API

Fon sıralamaları, fon detayı, banka faizleri ve makro veriler herkese açık, salt-okunur uçlardan JSON olarak gelir (anahtar gerekmez). Canlı, denenebilir dokümantasyon: Swagger arayüzü.Fund rankings, fund detail, bank rates and macro data come as JSON from public, read-only endpoints (no key needed). Live, try-it docs: Swagger UI.

# En çok kazandıran düşük riskli fonlar (haftalık)
GET /api/rankings?group=12&window=7&limit=10

# 100.000 ₺, 92 gün için en iyi banka faizi
GET /api/bank-rate?amount=100000&maturity=92

# Fon detayı — getiri + dağılım + kıyas
GET /api/funds/PRY
# Top low-risk funds (weekly)
GET /api/rankings?group=12&window=7&limit=10

# Best bank rate for 100,000 ₺, 92 days
GET /api/bank-rate?amount=100000&maturity=92

# Fund detail — return + allocation + benchmark
GET /api/funds/PRY

Portföy uçları (pozisyonlar, sepetler, favoriler, bildirimler) kişiseldir ve ayrı bir serviste durur — kendi referansı: budget.paraalfa.com/docs. Kod içinden erişmek için Ayarlar → API anahtarları'ndan kendine özel bir anahtar üretirsin (anahtar yalnız üretildiği an bir kez gösterilir), sonra her isteğe X-API-Key başlığı olarak eklersin.Portfolio endpoints (positions, baskets, favorites, alerts) are personal and live in a separate service with its own reference: budget.paraalfa.com/docs. To reach them from code, create your own key in Settings → API keys (shown only once, at creation) and send it as an X-API-Key header.

# Portföy özetin — kişisel, anahtar zorunlu
GET https://budget.paraalfa.com/api/portfolio
  X-API-Key: pa_ANAHTARIN
# Your portfolio summary — personal, key required
GET https://budget.paraalfa.com/api/portfolio
  X-API-Key: pa_YOURKEY

MCP — Claude & ChatGPT entegrasyonuMCP — Claude & ChatGPT integration

MCP (Model Context Protocol) ile ParaAlfa'yı bir yapay zekâ asistanına araç olarak takarsın; portföyünü ve fonları konuşarak yönetirsin — asistan doğru aracı kendi seçer. 20 araç vardır: sıralama, fon detayı, banka faizi, merkez bankası duruşu, TR makro, "ne kazandırırdı" hesabı, portföy ekle/çıkar/güncelle ve daha fazlası.With MCP (Model Context Protocol) you plug ParaAlfa into an AI assistant as tools and manage your portfolio and funds by chatting — the assistant picks the right tool itself. There are 20 tools: rankings, fund detail, bank rates, central-bank stance, TR macro, the "what-if" calculator, add/remove/update positions and more.

Adım 1 — API anahtarı üret. Panelde Ayarlar → API anahtarları → yeni anahtar. Anahtar pa_ ile başlar ve yalnız üretildiği an bir kez gösterilir; bir yere kaydet. Piyasa araçları (12 tanesi) anahtarsız da çalışır, ama portföy araçları için anahtar şarttır — ve anahtar seni doğrular, yani asistan hep senin hesabına bağlanır.Step 1 — Create an API key. In the panel: Settings → API keys → new key. It starts with pa_ and is shown only once, at creation — save it somewhere. The 12 market tools work without a key, but portfolio tools require one — and the key identifies you, so the assistant always binds to your account.

Anahtarı sunucuya üç yoldan verebilirsin (hangisi kolaysa): Authorization: Bearer pa_… başlığı, X-API-Key: pa_… başlığı ya da URL'de ?key=pa_…. Anahtarsız istek 401 döner.You can pass the key in three ways (whichever is easiest): an Authorization: Bearer pa_… header, an X-API-Key: pa_… header, or ?key=pa_… in the URL. A keyless request returns 401.

Adım 2 — Asistanı bağla. Çoğu kişi için doğru yol uzak bağlantı: sunucu adresi https://mcp.paraalfa.com/mcp (streamable-http). Claude Desktop, Claude Code, ChatGPT ve Cursor hepsi bu adrese bağlanır.Step 2 — Connect the assistant. For most people the right path is the remote connection: server URL https://mcp.paraalfa.com/mcp (streamable-http). Claude Desktop, Claude Code, ChatGPT and Cursor all connect to it.

Claude DesktopAyarlar → Connectors → Add custom connector, adres olarak anahtarını gömdüğün URL'yi ver:Claude DesktopSettings → Connectors → Add custom connector, and give the URL with your key embedded:

https://mcp.paraalfa.com/mcp?key=pa_ANAHTARIN

Config dosyasını elle düzenlemeyi seversen (claude_desktop_config.json):If you prefer editing the config file (claude_desktop_config.json):

{
  "mcpServers": {
    "paraalfa": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
               "https://mcp.paraalfa.com/mcp",
               "--header", "Authorization: Bearer pa_ANAHTARIN"]
    }
  }
}

Claude Code — terminalde tek komut:Claude Code — one command in the terminal:

claude mcp add --transport http paraalfa \
  https://mcp.paraalfa.com/mcp \
  --header "Authorization: Bearer pa_ANAHTARIN"

Cursor ve diğer istemciler — HTTP/streamable-http MCP destekleyen her istemci aynı adrese bağlanır; anahtarı Authorization başlığı ya da ?key= ile ver.Cursor and other clients — any client that supports HTTP/streamable-http MCP connects to the same URL; pass the key via the Authorization header or ?key=.

ChatGPT'ye bağlama — 3 adım:
1. Panelde Ayarlar → API anahtarları → yeni anahtar üret (pa_…, yalnız bir kez gösterilir).
2. ChatGPT → Ayarlar → Connectors → Developer ModeYeni Eklenti.
3. Sunucu URL'si: https://mcp.paraalfa.com/mcp?key=pa_ANAHTARIN  ·  Kimlik Doğrulama: Yetkilendirme Yok → Oluştur.
ChatGPT'de ayrı API-key alanı yok — anahtar URL'ye eklenir. OAuth seçme.
Connect to ChatGPT — 3 steps:
1. In the panel: Settings → API keys → create a key (pa_…, shown only once).
2. ChatGPT → Settings → Connectors → Developer ModeNew connector.
3. Server URL: https://mcp.paraalfa.com/mcp?key=pa_YOURKEY  ·  Authentication: No auth → Create.
ChatGPT has no separate API-key field — the key goes in the URL. Don't pick OAuth.

Yerel bağlantı (geliştirici / self-host). ParaAlfa'yı kendi makinende çalıştırıyorsan asistanı doğrudan stdio ile bağlayabilirsin — uzak sunucuya, hatta API anahtarına gerek yok; portföy PARAALFA_USER ortam değişkeniyle seçilir. Claude Desktop config:Local connection (developer / self-host). If you run ParaAlfa on your own machine you can connect the assistant directly over stdio — no remote server, not even an API key; the portfolio is chosen with the PARAALFA_USER env var. Claude Desktop config:

{
  "mcpServers": {
    "paraalfa-local": {
      "command": "python",
      "args": ["/yol/tefas-fon-radar/mcp_server.py"],
      "env": { "PARAALFA_USER": "senin-kullanici-id" }
    }
  }
}

Kurulum: python3.12 -m venv .venv-mcp && .venv-mcp/bin/pip install mcp. Uzak uç ise sunucuyu PARAALFA_MCP_TRANSPORT=streamable-http ile çalıştırır (Docker imajında hazır gelir).Setup: python3.12 -m venv .venv-mcp && .venv-mcp/bin/pip install mcp. The remote endpoint runs the server with PARAALFA_MCP_TRANSPORT=streamable-http (ships ready in the Docker image).

// Asistana sor — o doğru aracı çağırır:
"En çok kazandıran düşük riskli 5 fon?"
 → tefas_top(group="12", window=7)

"200 bin ₺'yi 6 ay bağlasam hangi banka?"
 → tefas_bank_rates(amount=200000, maturity=181)

"Portföyüme 15.000 ₺ TP2 ekle."
 → tefas_add_investment(fon="TP2", tutar=15000)
// Ask the assistant — it calls the right tool:
"Top 5 low-risk funds this week?"
 → tefas_top(group="12", window=7)

"Which bank for 200k ₺ locked 6 months?"
 → tefas_bank_rates(amount=200000, maturity=181)

"Add 15,000 ₺ of TP2 to my portfolio."
 → tefas_add_investment(fon="TP2", tutar=15000)

Tam araç listesiFull tool list

Piyasa verisi — anahtarsız da çalışır (12):Market data — works without a key (12):

tefas_metaVeri tarihi + kapsam: kaç fon var, en son ne zaman güncellendi.Data date + coverage: how many funds, when it was last updated.
tefas_topRisk grubuna ve zaman penceresine göre en çok kazandıran fonlar.Top-performing funds by risk group and time window.
tefas_fundTek fonun detayı — getiri, risk, büyüklük, yatırımcı sayısı.One fund's detail — return, risk, size, investor count.
tefas_allocationFonun portföy dağılımı (hisse/tahvil/döviz… kırılımı).The fund's portfolio allocation (equity/bond/FX… breakdown).
tefas_categoriesFon kategorilerinin ortalama getirileri.Average returns of fund categories.
tefas_benchmarksKıyas ölçütleri — enflasyon, mevduat, dolar, altın.Benchmarks — inflation, deposit, USD, gold.
tefas_searchKoda ya da isme göre fon ara.Search funds by code or name.
tefas_bank_ratesTutar + vade için en iyi mevduat faizi (net kazanç dahil).Best deposit rate for an amount + maturity (net gain included).
tefas_bank_gridBanka × vade faiz tablosu.Bank × maturity rate grid.
tefas_cb_stanceTCMB faiz duruşu — son karar ve yön.Central-bank rate stance — last decision and direction.
tefas_compareİki ya da daha çok fonu yan yana kıyasla.Compare two or more funds side by side.
tefas_macroTR makro göstergeleri — enflasyon, faiz, kur.TR macro indicators — inflation, rates, FX.

Portföyün — kişisel, API anahtarı gerekir (5):Your portfolio — personal, needs an API key (5):

tefas_portfolioPortföy özetin — toplam değer, kâr/zarar, dağılım.Your portfolio summary — total value, P/L, allocation.
tefas_positionsPozisyonların tek tek — her fon ayrı satır.Your positions one by one — each fund on its own row.
tefas_add_investmentPortföye fon ekle (tutar ya da adet).Add a position (by amount or units).
tefas_update_investmentVar olan pozisyonu güncelle.Update an existing position.
tefas_delete_investmentPozisyonu portföyden çıkar.Remove a position from the portfolio.

İçerik — yalnız yöneticiler (3):Content — admins only (3):

tefas_fon_analiziFon analizi taslağı üret (yönetici).Generate a fund-analysis draft (admin).
tefas_publish_postBlog/analiz yazısı yayınla (yönetici).Publish a blog/analysis post (admin).
tefas_delete_postYayını sil (yönetici).Delete a post (admin).

Anahtarla bağlandığında portföy araçları senin hesabına bağlanır; kullanıcı kimliğini parametre olarak vermezsin, veremezsin de — başkasının portföyüne erişim mümkün değildir.When you connect with a key, the portfolio tools bind to your account; you don't pass a user id as a parameter — and can't — so reaching someone else's portfolio isn't possible.

Gizlilik & güvenPrivacy & safety

SSS / FAQ

Veriler ne kadar güncel?How fresh is the data?
Fon fiyatları ve banka oranları her gün otomatik yenilenir (TEFAS T+1 yayınlar).Fund prices and bank rates refresh automatically every day (TEFAS publishes T+1).
Hesap açmadan kullanabilir miyim?Can I use it without an account?
Büyük ölçüde evet. Fon sayfaları, fon dizini, kıyas, blog ve metodoloji herkese açıktır; hesap yalnız portföy, sepet, favori ve bildirimler için gerekir — Herkese açık sayfalar.Mostly yes. Fund pages, the directory, comparisons, the blog and the methodology are all public; an account is needed only for your portfolio, baskets, favorites and alerts — see Public pages.
İki fonu nasıl karşılaştırırım?How do I compare two funds?
Fon kodlarını araya tire koyarak adrese yaz: /kiyas/PRY-TP2 — 1 ay, 3 ay, 6 ay ve 1 yıl pencerelerinde yan yana gelir.Put the fund codes in the URL separated by a dash: /kiyas/PRY-TP2 — they line up across 1M, 3M, 6M and 1Y windows.
Fonu buradan satın alabilir miyim?Can I buy a fund here?
Hayır. ParaAlfa alım-satım yapmaz; karşılaştırma ve takip aracıdır. Alımı bankan/aracı kurumun üzerinden yaparsın — ayrıntı: Fonu nereden alırım?No. ParaAlfa doesn't trade; it's a compare-and-track tool. You buy via your bank/broker — see Where do I buy a fund?
Stopaj kesin mi?Is the tax figure exact?
Yaklaşıktır ve mevzuata göre değişebilir. Kesin tutar için kurumuna danış.It's approximate and can change by regulation. Ask your institution for the exact amount.
Telefonda çalışır mı?Does it work on mobile?
Evet — panel mobil uyumludur, ayrıca Telegram üzerinden de kullanabilirsin.Yes — the panel is mobile-friendly, and you can also use it via Telegram.
Bir sorun/önerim var, nasıl iletirim?I have a problem/idea — how do I reach you?
Telegram botunda /feedback yaz — doğrudan bize ulaşır.Type /feedback in the Telegram bot — it reaches us directly.

Kod ve yapay zekâ ile entegrasyon mu istiyorsun? REST API & MCP bölümüne bak; canlı uç referansı Swagger'da. Want to integrate with code or AI? See the REST API & MCP section; the live endpoint reference is in Swagger.