http://localhost:3444/ adresindeki pano, her şeyin yönetildiği yerdir. Düz bir web sayfasıdır — hiç build adımı yoktur, ve indekslemenin olurken izleyebilmeniz için yoklama yapar. Önce oturum açmanızı ister, ve sonrasında ne gördüğünüz hesabınıza bağlıdır.
Oturum açmak
/’i açmak, o tarayıcıda zaten bir oturumunuz olmadıkça sizi /login’e gönderir. Operatörün size
verdiği hesapla oturum açın; yepyeni bir örnekte henüz bir hesap yoktur ve bunun yerine, sunucu
logundaki kodla ilkini oluşturmak için /setup’a gönderilirsiniz. İkisi de
Hesaplar ve İzinler’de anlatılır.
Parolanız geçiciyse, pano sizi /change-password’e gönderir ve onu değiştirene kadar başka hiçbir şey
çalışmaz.
İçeri girdiğinizde ne gördüğünüz rolünüzü izler: bir root ya da admin hesabı her projeyi ve
Users sayfasını görür, bir member hesabı yalnızca eklendiği projeleri görür, ve basamayacağı
düğmeler devre dışı gösterilir (örneğin Re-index ve Force re-index), gizlenmez.
Hesap menüsü
Sağ üstte, adınızı ve rolünüzle bir hap göstererek:
| Öğe | Ne yapar |
|---|---|
| Change password | Mevcut parolanızı, sonra yeniyi iki kez ister. Kaydetmek diğer oturumlarınızı çıkarır |
| API tokens | Admin API için kendi token’larınız (#/~tokens) |
| Users | Hesap listesi — yalnızca root ve admin. Bkz. Users sayfası |
| Audit log | Kimin ne yaptığının örnek geneli kaydı (#/~audit) — yalnızca root ve admin. Bkz. Admin API |
| Sign out | Bu oturumu yalnızca bu tarayıcıda değil, sunucuda sonlandırır |
Üst çubuk
Durum hapları, başka bir şeye bakmadan önce sunucunun sağlıklı olup olmadığını söyler:
| Hap | Anlamı |
|---|---|
| Database up / down | Veritabanına ulaşılabiliyor — gömülü PostgreSQL ya da DATABASE_URL’in adlandırdığı harici olan |
| Model ready / loading | Gömme modeli yüklendi. İlk başlatmada, model indirilirken loading der — hazır olana kadar indeksleme ve arama çalışmaz |
local · Xenova/multilingual-e5-small · 384d |
Şu anda kullanılan gömme sağlayıcısı, modeli ve vektör boyutları |
n open sessions |
Şu anda bağlı MCP istemcileri |
v1.0.0 |
Çalışan sürüm |
Proje listesi (sol)
Canlı durumuyla birlikte her proje: idle, indexing, queued ya da error. Her satır, kaynak
sayısını, doküman ve parça sayılarını ve en son ne zaman indekslendiğini gösterir. Bir proje
indekslenirken, satır geçerli aşamayla, biten dosyalarla ve gömülen parçalarla bir ilerleme çubuğu
büyütür. Kuyrukta bekleyen bir proje, hangi projeyi beklediğini söyler.
- Filter projects — listeyi daraltmak için yazın.
- New project (ya da
n’ye basın) — oluşturma diyaloğunu açar.
Proje ayrıntısı (sağ)
Header
Proje adı, durumu, ve kopyalama düğmeli MCP URL — bu, agent’ınızın yapılandırmasına yapıştırdığınız dizedir. Yanında, projenin kaynaklarının adları.
Üç eylem:
| Düğme | Ne yapar |
|---|---|
| Re-index | Artımlı bir çalışmayı kuyruğa alır: her kaynağı senkronize et, yalnızca değişeni yeniden göm |
| Force re-index | Projenin her parçasını düşürür ve sıfırdan yeniden kurar |
| Delete | Projeyi, dokümanlarını, parçalarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın (ikinci tık Confirm delete yazar). Yalnızca root ve admin hesapları için çizilir, ve proje indekslenirken reddedilir |
Bir çalışma sürerken, bir bilgi kutusu aşamayı, ilerleme çubuğunu, kaç dosyanın değişmediğini ve kaç parçanın gömüldüğünü gösterir. Son çalışma başarısız olduysa, kırmızı bir bilgi kutusu hatayı olduğu gibi gösterir.
İstatistikler
Dokümanlar (ve kaç kaynak boyunca), parçalar, en son ne zaman indekslendiği (o çalışmanın neyi
değiştirdiğiyle birlikte), ve gömme modeli. Proje, sunucunun şu anda çalıştırdığından farklı bir modelle
indekslendiyse, burada bir uyarı görünür ve siz yeniden indeksleyene kadar arama reddedilir. Uyarı, içinde bir Re-index now düğmesi olan ve başlığı Indexed with a different embedding model olan bir bilgi kutusudur, çünkü hiçbir şey projeyi kendiliğinden yeniden indekslemez. İkinci bir bilgi kutusu, Chunks are larger than the model reads, CHUNK_MAX_TOKENS modelin temsil ettiğinin üzerindeyse görünür ve yeniden indekslemeden önce ayarlanacak değeri adlandırır. Parçalar kutucuğu embedded, HNSW cosine index yazar.
Arama
İstatistiklerin altında, projeye bir agent’ın soracağı şekilde soran bir arama kutusu. İsteğe bağlı source, path prefix ve version filtreleri search_docs argümanlarını yansıtır, ve sınır 5, 10 ya da 20 isabettir. Her isabet dosyasını, başlığını, soluk renkli komşu metniyle alıntıyı, cosine skorunu ve D ile L sıralarını gösterir — vektör yarısının (D) ve anahtar sözcük yarısının (L) ona verdiği konum. En iyi skor relevance floor’un altındaysa, Below the relevance floor başlıklı bir bilgi kutusu search_docs’un “no good match” yanıtlayacağını söyler, ve floor’un doğru olup olmadığına siz karar verebilesiniz diye alıntılar yine de gösterilir.
Agent’ların ne sorduğu
Sorgular paneli agent’ların neyi aradığını geri okur, böylece dokümantasyonun neyi yanıtsız bıraktığını görebilirsiniz. Pencereyi (24 saatten 90 güne) ve kimin aramalarının sayılacağını seçin — agent’lar (MCP), bu pano, ya da ikisi. Dört sekme: Questions (bir sorunun ne sıklıkla sorulduğuna ve en iyi skorunun ne kadar düşük kaldığına göre sıralı, sormanın kaç token ve güne yayıldığıyla birlikte), Never returned (hiçbir aramanın döndürmediği dokümanlar, indeksliyken kaç arama çalıştığıyla birlikte), Most returned ve Volume (UTC günü başına aramalar). Hiçbir şey “yanıtsız” diye etiketlenmez: dokümante etmediğiniz bir şey hakkındaki bir soru, dokümante ettiğiniz bir soru kadar iyi skor alabilir, bu yüzden sayı ve skor gösterilir ve yargı sizindir. Export questions onları değerlendirme harness’inin biçiminde JSONL olarak indirir.
Questions tablosunun altında Reported by agents, agent’ların report_gap ile gönderdiklerini listeler: bir agent’ın
aradığı, bulduklarını okuduğu ve dokümantasyonun cevaplamadığını söylediği sorular; soruya göre gruplanır ve
agent’ların kendi sözleriyle, düz metin olarak gösterilir. Üstlerindeki sorularla birlikte sıralanmazlar. Bkz.
MCP Araçları.
Her rakam bir gömme modelini, bir indeks neslini ve bir relevance floor’u tanımlar; bunlar tablonun üstündeki seçicide adlandırılır. Floor, o aramalar karara bağlandıktan sonra değiştirildiyse panel bunu işaretler: rakamlar eski floor’a göre karara bağlanmıştı, bu yüzden projenin bundan sonra reddettiği şey onların gösterdiği şey değildir, ve mevcut floor altında karara bağlanan aramalar sizin seçmeniz için ayrı tutulur. Panelin altı mevcut relevance floor’u ve nereden geldiğini gösterir — sunucunun SEARCH_SCORE_FLOOR’u ya da bu projenin kendi değeri. Bir manager, 0,01’lik adımlarla on değerlik bir listeden başka bir değer seçebilir (en düşüğü 0,75, en yükseği 0,84), Off (0), ya da bu projenin kendi değerini bırakmak için Server default; birini seçmek onu uygulamaz, önce fiyatlandırır — penceredeki reddedilen aramalardan kaçını yanıtlayacaktı ve yanıtlanan aramalardan kaçını reddedecekti, üst sınırlar olarak — ve yalnızca Set the floor to… onu kaydeder. Manager’lar ayrıca Stop recording ya da Clear the log yapabilir; saklama süresinden eski satırlar otomatik olarak silinir.
Eval runs
Projenin golden question’larının (her biri bir soru ve ona cevap vermesi beklenen dosya) altında, Eval runs paneli sunucunun bunlara verdiği kendi cevapları tutar. İndeks değiştikten sonra — bir yeniden kurma, chunk yazan, dosya kaldıran ya da doküman değişikliği kaydeden artımlı bir çalışma — ya da küme düzenlendikten sonra sunucu her golden question’ı canlı indekse sorar ve çalışmayı kaydeder. Panel, recall@5 ve MRR geçmişini bir grafik olarak çizer, çalışmaları her birinin neyi kaybettiği ya da atladığıyla listeler ve en yeni iyi çalışma, daha önce ilk beşte olan bir soruyu kaybettiğinde bunu sorulara adını vererek uyarır (ayrıca bir soru, beklediği dosya artık indekste olmadığı için ilk kez atlandığında). Sunucunun kendi başlattığı bir çalışma, açık bir sayfada yenileme gerekmeden saniyeler içinde görünür. Bir manager Run now’a basabilir. Panel sunucunun kaydettiği rakamları çizer ve kendisi hiçbir şeyi puanlamaz. Aynı çalışmalar API üzerinden okunur: bkz. Admin API.
Belge kaynakları
Kaynak başına bir satır: bağlama adı, nereden geldiği, içerik türü, doküman sayısı, en son ne zaman senkronize olduğu, ve kendi durumu. Her satır şunu taşır:
| Eylem | Kimin için var | Ne yapar |
|---|---|---|
| Test | git, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues | Hiçbir şeyi indekslemeden bağlantıyı denetler |
| Sync | tümü | Bir indeksleme çalışmasını kuyruğa alır (her kaynak bir çalışmanın başında senkronize olur) |
| Edit / Files | tümü | Kaynak diyaloğunu açar; yüklemeler için saklanan dosyaları listeler ve yönetir |
| Delete | tümü | Kaynağı, dokümanlarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın |
Bir viewer, eylem düğmelerinin yerine View görür.
Add source, tür başına bir sekmeyle bir diyalog açar — Local directory, Git repository, Upload files, Obsidian vault, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues. Bkz. Belge Kaynakları.
Secret’lar ve kişisel veriler
Bir editor ve üstü için proje sayfasındaki bir bölüm, PII taramasının bulduklarını belge yoluna göre listeler: kural, konum ve
maskelenmiş bir önizleme, kurala göre daraltılabilir. Hiçbir zaman bir değer göstermez ve taramanın kapalı olduğunu (PII_SCAN=0),
bulguların gruplanmadığını (SECRET_KEY yok), belgelerin belge başına tavana ulaştığını ve belgelerin indekslenirken kesildiğini ayrı
ayrı söyler. Tarama yalnızca raporlar; hiçbir şey maskelenmez ya da atlanmaz. Bir viewer bölümü görmez. Bkz.
Yapılandırma.
Üyeler
Her projeye ulaşan ve bu yüzden listelenmeyen root ve admin hesaplarının ötesinde, bu projeye kim
ulaşır. Her satır, proje rolünü tutan bir açılır menüyle birlikte bir member hesabıdır — viewer
okur, editor kaynakları değiştirir, dosya yükler ve yeniden indeksler — ve bir Remove düğmesi.
Add member, henüz projede olmayan aktif member hesaplarını sunar; hiç yoksa sizi Users sayfasına
yönlendirir. Yalnızca root ve admin bunun herhangi bir şeyini değiştirebilir; başka herkes listeyi
salt okunur görür. Panelin altındaki not projenin MCP moduna göre değişir: endpoint herkese açıkken üyeliğin panoyu
yönettiğini, MCP endpoint’ini değil, söyler; bir token zorunlu olduğunda endpoint’in yalnızca projenin
token’larından birini tutan bir istemciye yanıt verdiğini söyler; hesap zorunlu modunda ise yalnızca burada listelenen hesapların ve yöneticilerin MCP endpoint’ine ulaşabildiğini söyler. Bkz. Hesaplar ve İzinler.
MCP erişimi
Bir hap, bu projenin endpoint’inin üç moddan hangisinde olduğunu söyler — open, URL’ye ulaşabilen
herkes tarafından okunabilir; token required, yeni oluşturulan bir proje için varsayılan; ya da
account required, yalnızca projenin bir üyesi olan bir hesabın, OAuth 2.1 üzerinden ve her istekte
yeniden denetlenerek yanıtlandığı mod. Panel aralarında geçiş yapar; New token bir tane üretir ve secret’ını bir kez gösterir, ve
Revoke istemcisini oturum ortasında keser. Üretirken token’ı bağlayacağınız kaynakları seçebilirsiniz; kapsamı olan bir token bir rozet gösterir — kaynaklarının hiçbiri kalmadıysa kırmızı — ve open projelerde, kapsamın bir sınır olmadığını söyleyen bir not görünür. Her satır bir token’ın adını, önde gelen karakterlerini,
ve en son ne zaman kullanıldığını gösterir. Basmanıza izin verilmeyen düğmeler çizilmez: modu çevirmek
proje üzerinde manager haklarını gerektirir, üretmek ve iptal etmek bir editor’ünkini. Bkz.
Projeler.
Bir agent bağlamak
Bu projenin gerçek URL’siyle doldurulmuş, Claude Code, Cursor, Claude Desktop ve eski SSE istemcileri
için kopyala-yapıştır parçacıkları — ve proje bir token gerektirdiğinde Authorization başlığı zaten
yerinde. Bkz. Yapay Zekâ İstemcilerini Bağlamak.
Agent’a açılan araçlar
Her projenin yayımladığı beş aracın bir hatırlatıcısı: search_docs, list_topics, read_document, whats_new
ve report_gap; sonuncusu projenin sorgu logu açıkken bulunur.
Bkz. MCP Araçları.
İndeksleme çalışmaları
En yeniden en eskiye son çalışma geçmişi: ne zaman, artımlı mı zorlanmış mı, ne değişti
(12 unchanged · 3 updated · 1 removed), ve ne kadar sürdü. Başarısız çalışmalar hatalarını gösterir.
Bu, canlı ilerleme görünümünün aksine, yeniden başlatmaları atlatır.
Klavye ve küçük kolaylıklar
n, New project’i açar (hiçbir diyalog açık değilken).Escbir diyaloğu kapatır.- Seçili proje URL hash’indedir (
#/my-project), bu yüzden ona bir yer imi koyabilir ya da bir bağlantı paylaşabilirsiniz. - Yıkıcı düğmeler ikinci bir tıklama gerektirir, ve onayın süresi birkaç saniye sonra dolar.
- Kopyalama düğmeleri, tarayıcı düz-HTTP bir LAN adresinde panoyu engelliyorsa manuel bir seçime düşer.
Footer
Panonun her sayfası aynı iki parçalı footer ile biter. Solda, çalışan sürümle birlikte telif hakkı satırı: Copyright © 2026 Contextator v1.0.0 is a Tunedness production. Sağda, sıradan URL’ler olarak açılan ve hesap gerektirmeyen beş sayfa:
| Sayfa | Ne olduğu |
|---|---|
/about |
Contextator’ın ne olduğu, nasıl çalıştığı, ve kimin yaptığı |
/privacy |
Kurulumunuzun ne sakladığı, ve yazılımın yapabileceği giden çağrılar |
/cookies |
Var olan tek çerez — sizi oturumda tutan oturum — ve ne olmadığı |
/terms |
Garanti reddi ve bir örnek çalıştırmanın sizi nelerden sorumlu tuttuğu |
/license |
Kısaca AGPL, /license.txt’teki tam metin, ve üçüncü taraf bileşenler |
Bilerek herkese açıktırlar: yalnızca operatörün okuyabildiği bir yasal bildirim, bir bildirim değildir. Hiçbir proje verisi açığa çıkarmazlar ve ne veritabanına ne de API’ye ulaşırlar.
Users sayfası
Hesap menüsü → Users (#/~users), yalnızca root ve admin hesapları için. Hesap başına bir
satır: kullanıcı adı ve görünen adı, rolü, active, disabled olup olmadığı ya da password
change pending durumu, kaç projeye ulaştığı, ve en son ne zaman oturum açtığı.
| Düğme | Ne yapar |
|---|---|
| New user | Oluşturma diyaloğunu açar |
| Edit | Görünen ad, e-posta, rol, ve active anahtarı |
| Reset password | Bir kez gösterilen yeni bir geçici parola verir, ve o hesabı her yerde oturumdan çıkarır |
| Disable / Enable | Devre dışı bir hesap oturum açamaz ve açık oturumları hemen sona erer |
| Delete | Hesabı, oturumlarını ve üyeliklerini kaldırır. Onaylamak için iki kez tıklayın |
| SSO group mappings | OIDC_GROUPS_CLAIM kullanılıyorsa kimlik sağlayıcı gruplarını projelere ve bir role eşler. Bkz. Tek Oturum Açma |
New user, bir kullanıcı adı (küçük harf, kalıcı), opsiyonel bir görünen ad ve e-posta, bir rol —
yalnızca bir root hesabına sunulan root ile birlikte member ya da admin — ve bir parola ister.
Parolayı boş bırakın, ya da Generate’e basın, ve sunucu bir tane üretsin. Her iki durumda da bir
kez, kopyalama düğmeli bir diyalogda gösterilir, ve Must change password at first sign-in varsayılan
olarak işaretlidir.
Birinin oturumlarını sonlandırmak için ayrı bir düğme yoktur: Reset password, Disable ve Delete’in her biri, oldukları şeyin bir parçası olarak bunu yapar.
Basmanıza izin verilmeyen bir düğme grileşir ve üzerine geldiğinizde nedenini söyler — son aktif root hesabı, kendi satırınız, ya da siz bir admin iken bir root hesabı. Kuralların tamamı Hesaplar ve İzinler’dedir.