# Yerel bir indeksleyici olmadan bir yapay zeka ajanına büyük bir reponun bağlamını verme

Canonical source: https://maguyva.ai/tr/blog/large-repo-context-without-a-local-indexer

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Date: 2026-08-14 · Author: Maguyva Team

> Dizüstü bilgisayarınızda yerel bir indeksleyici çalıştırmadan, buluttan bir kodlama ajanına büyük bir reponun sorgulanabilir bir haritasını nasıl verirsiniz.

Büyük bir repo bir bağlam penceresine sığmaz ve eğer dizüstü bilgisayar indeksleyicisini gerçek bir monorepoya yönelttiyseniz, oraya da rahatça sığmadığını bilirsiniz — RAM fırlar, ilk indeksleme bir saat sürer ve ajanınız yine de bir sonraki oturuma hangi dosyaların önemli olduğunu tahmin ederek başlar.

Olağan cevap, editörün yanında bir indeksleyici çalıştırmaktır ve bir makineye rahatça sığan bir repo için bu iyi bir cevaptır. Monoreponuz Cursor'da zaten hızlıca indeksleniyorsa ve haritaya ihtiyaç duyduğunuz tek yer orasıysa, bu yazının ekleyecek bir şeyi yok — atlayın.

Bu yazı diğer durumla ilgili — bir ajanın büyük bir reponun sorgulanabilir bir haritasına ihtiyaç duyduğu ve bunu elde etmek için yerel bir indeksleyici çalıştırmak istemediğiniz zaman.

## Yerel bir indeksleyicinin yanlış araç olduğu durumlar

Yerel bir indeks, kodun onu sorgulayan makinede yaşadığını varsayar ve gerçek monorepo ölçeğinde bu varsayım tek bir editör içinde bile gerilir. Repo, dizüstü bilgisayarda 'sıcak' tutmak istediğinizden basitçe daha büyüktür: etki yarıçapı üç dizin ötedeyken bir paket üzerinde çalışıyorsunuzdur ve iki milyon satırlık bir ağacın ilk soğuk indekslemesi iki kez katlanmak isteyeceğiniz bir şey değildir — ne kendi makinenizde, ne de o ağacı daha önce hiç klonlamamış bir CI çalıştırıcısında. Ya da bir takım arkadaşının, kendi makinesinin aynı indeksten geçmesini beklemeden sizinle aynı haritayı sorgulayabilmesi gerekir.

Bunların hiçbiri iyi bir editör indeksleyicisini çöpe atmak için bir neden değil. Bu, herhangi bir ajanınızın MCP üzerinden sorgulayabileceği barındırılan bir haritaya da sahip olmak için bir neden.

Ve ölçek sorunu 'yapıştırmak için çok fazla dosya' olmasından daha derine iner. Büyük bir ağaçta ilginç soru neredeyse hiçbir zaman 'bana bu dosyayı göster' değildir — hangi dosya, hangi sembol, hangi çağıranlar, hangi testler olduğudur. `src/`'ı listeleyerek başlayan ve ilk üç sonucu okuyan bir ajan, `apps/api`'deki işleyiciyi ve `packages/sdk`'deki oluşturulan istemciyi neşeyle gözden kaçıracaktır. İhtiyacınız olan şey, tüm ağaçtan oluşturulmuş, sonra sıralanmış, sonra alıntılanmış bir getirmedir.

## 'Büyük bir reponun bağlamı' gerçekte ne anlama gelir

Dosyaları prompta boşaltmak bağlam değildir — ağacın daha küçük, daha kötü bir kopyasıdır. Ajanınızın gerçekten ihtiyacı olan şey, sorular sormak ve karşılığında alıntılanmış yanıtlar almaktır: bu sembol nerede tanımlanmış ve onu kim çağırıyor, değiştirmek üzere olduğum modüle ne bağlı, hangi test dosyası bu davranışı kapsıyor ve ağaç geçen çeyrek değil, *şu anda* nasıl görünüyor.

Bu yanıtların, modelin başkalarının reposu hakkındaki hafızasından değil, sizin reponuzdan oluşturulmuş bir indeksten gelmesi gerekir ve indeksin ajanın bağlam penceresi dışında bir yerde yaşaması gerekir. Bu sorun için, dizüstü bilgisayarınızın da dışında bir yerde yaşaması gerekir.

Talimat dosyalarının sizin için yapamayacağı bir şey daha: `CLAUDE.md` ve `AGENTS.md` kurallar ve davranış için doğru yerdir, ancak iki milyon satırlık bir ağacın canlı, sıralanmış, sorgulanabilir bir haritası değildirler. Davranış için kurallar kullanın; gerçekler için repo zekası kullanın.

## Haritayı bulutta inşa ediyoruz, herhangi bir istemciden sorguluyoruz

Maguyva, uzak bir MCP kod tabanı bağlam katmanıdır. GitHub'ı bağlarsınız, repolarınızı seçersiniz ve bulut hatları ağacı ayrıştırırken, sembolleri ve graf kenarlarını oluştururken ve sıralanmış bir haritayı korurken çekip gidebilirsiniz — asla yerel bir indeksleyici olmadan.

Kod push ettiğinizde, değiştirilen dosyalar artımlı olarak ayrıştırılır ve graf ile sıralama katmanları bir programa göre yeniden oluşturulur: ücretsiz planda günlük, ücretli planlarda saatlik. Her anlık görüntü zaman damgalıdır, böylece ajanınız ağacın hangi sürümünü okuduğunu söyleyebilir. Buradaki dürüst sınırlama, senkronize edilmemiş yerel çalışmadır — yalnızca çalışma ağacında var olan, hiç push edilmemiş bir değişiklik henüz barındırılan haritada değildir.

Sonra, zaten kullandığınız herhangi bir istemciye MCP yapılandırmasına bir API anahtarı ekleyerek bağlanırsınız. 24 belgelenmiş MCP istemcisi için kurulum kılavuzları vardır ve standart yapılandırmayı destekleyen başka herhangi bir MCP uyumlu istemci de bağlanabilir. Cursor evinizse, [Cursor sayfası](/tr/for-cursor) o yolu izler; aynı sunucu Claude Code, VS Code, Windsurf, Codex CLI ve diğerlerine yanıt verir.

Editör değiştirmezsiniz. Ajanınıza bir araç yüzeyi verirsiniz — arama, semboller, bağımlılık analizi, dosya getirme ve repo bağlamı genelinde 11 MCP aracı — 279'dan fazla dil ve metin tabanlı teknoloji üzerinde kapsama sahip, ki bu, yıllar önce tek bir dil olmaktan çıkmış bir monorepoda sandığınızdan daha çok şey ifade eder.

Yanıtlar, satır numaralarıyla dosya yolları olarak temellendirilmiş şekilde döner. Semantik, yapısal, graf ve metin araması sıralanmış sonuçlarda birleştirilir, böylece 'parseConfig'e ne bağlı' gibi bir soru size ne bir grep dökümü ne de tek bir semantik parça verir, gerçekten önemli olan o bir avuç yeri verir.

## Somut bir kılavuz

Tüm şirketi indeksleyerek başlamayın. İşe yarayan yol şu:

1. Zaten iyi bildiğiniz bir repo seçin — elle değerlendirebileceğiniz bir paket, sahip olduğunuz en büyük ağaçtan daha değerlidir.
2. Ücretsiz başlayın: 3 repo, 50 bin indekslenen satır, 11 aracın tamamı, aylık sorgu kotası yok. Temsili reponuz bundan büyükse, [fiyat sayfası](/tr/pricing) çalışma alanı katmanlarını (0 $, 19 $, 49 $, 149 $) koltuk sayısına göre değil, indekslenen kapsama göre listeler.
3. GitHub'ı bağlayın ve ilk indekslemenin bitmesini bekleyin. Yerel olarak hiçbir şey derlemiyorsunuz.
4. MCP istemcisini bağlayın — birkaç satır yapılandırma. Maguyva uzak bir MCP sunucusudur, bu yüzden eklenti yok, uzantı yok ve benimsenecek ikinci bir editör yok.
5. Doğrulayabileceğiniz bir soru sorun. 'parseConfig'e ne bağlı?' veya 'Oturum açma oturumunun süresi dolması nerede işleniyor?' Sonra alıntılanan `file.ext:line` sonuçlarını açın ve karşınızdaki ağaçla karşılaştırın.
6. Alıntılar bu temasta hayatta kaldıktan sonra ajanın düzenlemesine izin verin.

İlk repo iyi uyuyorsa ve ağacınız büyükse, çalışma alanını indekslenen satırlarınıza ve yeniden oluşturma sıklığına uyacak şekilde yükseltin. İnsanlar ve ajanlar aynı kullanıcı sayısını paylaşır — Maguyva koltuk başına değil, çalışma alanı başına ücretlendirir — bu yüzden döngüye üçüncü bir ajan eklemek size hiçbir şeye mal olmaz.

Etkinleştirme testi, [belgelerin](/tr/docs) her ilk çalıştırma için önerdiğiyle aynıdır: zaten bildiğiniz bir repoyu indeksleyin, doğrulayabileceğiniz bir soru sorun. Büyük bir repo testi değiştirmez; sadece yanlış bir ilk dosyayı daha maliyetli hale getirir.

## Bağlandıktan sonra dikkat edilmesi gerekenler

Üç şeye dikkat edin. Güncellik: ücretli planlar saatlik, ücretsiz planlar günlük yeniden oluşturulur ve push edilmemiş yerel çalışma haritada olmayacaktır — bu, kabul ettiğiniz ödünleşimdir. Kapsam: arşivlenmiş her fork'u değil, temsili bir repo kümesini indeksleyin; ücretsiz katman, yanıtların saklanmaya değip değmediğini öğrenmek için kasıtlı olarak bu boyuttadır. Ve doğrulama: yolları ve satır numaralarını alıntılayamayan büyük bir repo haritası, sadece daha yavaş bir tahmin motorudur, bu yüzden ajanınızın yamayı teslim etmeden önce yeri göstermesini sağlayın.

Sonra küçük bir repoda çalıştıracağınız aynı testi çalıştırın. Zaten bildiğiniz bir repoyu indeksleyin. Doğrulayabileceğiniz bir soru sorun. Harita gerçekse, ajanınız soğuk bir ağaçtan başlamayı bırakır.

`// no laptop got hot building this map.`