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.
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
- 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).
- E-postanı doğrula. Gelen kutuna düşen linke tıkla.Confirm your email. Click the link sent to your inbox.
- Giriş yap. Artık fonları, faizleri ve portföyünü görebilirsin.Log in. Now you can see funds, rates and your 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.
- Fon kodu + tutar gir (örn. TP2, 10.000 ₺).Enter a fund code + amount (e.g. TP2, 10,000 ₺).
- İ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.
- 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.
- 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.
- 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.
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.
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:
tefas.gov.tr/FonAnaliz.aspx?FonKod=KOD — resmî getiri, dağılım ve künye.Each fund's TEFAS record: tefas.gov.tr/FonAnaliz.aspx?FonKod=CODE — official return, allocation and profile.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.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örünen adın ve kişisel varsayılan stopaj oranın — yeni eklediğin pozisyonlarda bu oran kullanılır.Your display name and personal default tax rate — applied to positions you add from then on.
- Değerleri gizle: tutarları bulanıklaştırır — ekran görüntüsü alırken ya da ekranını paylaşırken.Hide values: blurs amounts — for screenshots or when sharing your screen.
GüvenlikSecurity
- İki adımlı doğrulama (2FA): telefonundaki doğrulayıcı uygulamayla (QR okutarak) kurarsın — şifren ele geçse bile hesabına girilemez.Two-factor authentication (2FA): set it up by scanning a QR with your authenticator app — even a stolen password won't get someone in.
- Son girişler: hesabına ne zaman, nereden girildiğini görürsün.Recent logins: see when and from where your account was accessed.
- Tüm cihazlardan çıkış: tek tuşla her oturumu kapatır.Sign out everywhere: ends every active session at once.
VerinYour data
- Dışa aktar: pozisyonlarını CSV, hesabının tamamını JSON olarak indir.Export: download your positions as CSV and your whole account as JSON.
- Hesabı sil: hesabın ve tüm verin kalıcı olarak silinir (çift onaylı).Delete account: your account and all data are permanently removed (double-confirmed).
- API anahtarları: kod veya yapay zekâ asistanı bağlamak için — Geliştirici bölümüne bak.API keys: for connecting code or an AI assistant — see the Developers section.
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.
- 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.
- Bağlantıya dokun — bot @paraalfabot açılır ve
/start <kod>otomatik gider. Botu elle açtıysan aynı kodu kendin yaz:/start 3xK9x2Qagibi.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. - Bot "✅ Bağlandın!" der ve hangi hesaba bağlandığını gösterir. Artık
/portfoy,/ayarlargibi komutlar bu hesabına çalışır.The bot replies "✅ Connected!" and shows which account it linked. From now on commands like/portfoy,/ayarlaract on this account. - Hangi bildirimleri istediğini aç/kapa ile seç — panelden ya da botta
/ayarlarile.Choose which alerts you want with simple on/off toggles — from the panel or with/ayarlarin the bot.
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?
- Günlük özet — her gün veri gelince portföyünün durumu (grafik + kart).Daily summary — your portfolio when new data lands (chart + card).
- Hareket uyarısı — bir fon belirlediğin eşiğin üstünde oynayınca.Movement alert — when a fund moves beyond your chosen threshold.
- Favori takibi — favori fonlarının günlük getirisi.Favorites — the daily return of your favorite funds.
- Fon–mevduat kesişimi — elindeki bir fonun yıllık getirisi en iyi mevduat oranını geçtiğinde ya da altına düştüğünde haber verir. Aynı fon için ayda en fazla bir kez gelir; panelden Ayarlar → Bildirimler'den açılır.Fund–deposit crossover — pings you when a fund you hold crosses above or falls below the best deposit rate. At most once a month per fund; enable it in Settings → Notifications in the panel.
- Hazır sepet değişikliği — kurduğun hazır sepetin fon listesi güncellenince (giren/çıkan fonlarla birlikte) bilgilendirilirsin.Ready-basket changes — when the fund list of a ready-made basket you set up is updated, you're told what came in and what went out.
/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 Desktop — Ayarlar → Connectors → Add custom connector, adres olarak anahtarını gömdüğün URL'yi ver:Claude Desktop — Settings → 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=.
1. Panelde Ayarlar → API anahtarları → yeni anahtar üret (
pa_…, yalnız bir kez gösterilir).2. ChatGPT → Ayarlar → Connectors → Developer Mode → Yeni 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 Mode → New 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
- Portföyün ve verilerin sana özeldir — başka kullanıcılar göremez.Your portfolio and data are private — other users can't see them.
- Değerleri gizle modu: ekran görüntüsü/paylaşım için tutarları bulanıklaştırır.Hide values mode: blurs amounts for screenshots/sharing.
- Verini istediğin an CSV/JSON olarak indirebilir, hesabını silebilirsin.Export your data as CSV/JSON anytime, or delete your account.
- Hesabını iki adımlı doğrulama ile koruyabilir, son girişlerini görebilir ve tüm cihazlardan çıkış yapabilirsin — Ayarlar & güvenlik.Protect your account with 2FA, review recent logins and sign out everywhere — see Settings & security.
- Sitede yalnız anonim ziyaret istatistiği için çerez kullanılır; reklam çerezi yoktur ve ilk girişte reddedebilirsin.Cookies are used only for anonymous visit statistics; there are no advertising cookies and you can decline on first visit.
- ParaAlfa yatırım tavsiyesi vermez; tüm sayılar bilgilendirme amaçlıdır. Komisyon, affiliate geliri ve reklam yoktur — ayrıntısı Hakkında sayfasında.ParaAlfa gives no investment advice; all figures are informational. No commissions, affiliate revenue or ads — details on the About page.
SSS / FAQ
/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./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.