# Kod zekası MCP sunucusu nasıl seçilir

Canonical source: https://maguyva.ai/tr/guides/choosing-a-code-intelligence-mcp-server

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).

Ajanınızın kendi kodunuz hakkında sorduğu gerçek sorulara yanıt veren sunucuyu seçin: bir sembol nerede tanımlanmış, onu kim çağırıyor, değişirse ne bozulur ve adını artık kimsenin hatırlamadığı bir kavram nerede duruyor.

Bunun için birkaç farklı arama türü, ürününüzde kullandığınız diller için gerçek ayrıştırma, commit'lerinize yetişen bir indeks ve istemcinizin birkaç dakikada tamamlayabileceği bir kurulum gerekir. Aşağıdaki 15 dakikalık testi iyi bildiğiniz bir repoda yapın: bu liste dahil, her özellik listesinden daha değerlidir.

## Neleri karşılaştırmalı

Her adaya aynı soruları sorun, sonra yanıtları kendi kodunuzda doğrulayın. Özellik listesi bir iddiadır; reponuzda verilen doğru yanıt ise kanıttır.

| Ölçüt | Ne sormalı | Nasıl doğrulanır |
|---|---|---|
| **Arama modları** | Anlamsal, yapısal (AST), graf ve tam metin aramayı bir araya getiriyor ve her soruyu doğru moda yönlendiriyor mu? Tek bir mod, bütün soru sınıflarını yanıtsız bırakır. | Her türden bir soru sorun: bir kavram, bir kod biçimi, bir çağıran listesi ve birebir bir hata mesajı. |
| **Dil desteğinin derinliği** | Ürününüzde kullandığınız her dilde kod, semboller ve ilişkilerle birlikte bir AST'ye mi ayrıştırılıyor, yoksa yalnızca metin olarak mı indeksleniyor? Uzun bir dil listesi yüzeysel desteği gizleyebilir. | Dilleriniz için yayımlanmış yetenek işaretlerini bulun, sonra her birinde bir sembol arayın. |
| **Repo ölçeği** | En büyük reponuzu ve aynı anda birkaç repoyu kaldırabiliyor mu? Sonuçlar sıralı ve sınırlı mı kalıyor, yoksa tek bir büyük dosya yanıtı mı dolduruyor? | Bir demo projesini değil, gerçek en büyük reponuzu indeksleyin ve ilk işe yarar yanıta kadar geçen süreyi ölçün. |
| **Güncellik ve eşitleme** | İndeks yeni commit'lerden nasıl haberdar oluyor ve bir değişikliğin aranabilir hâle gelmesi ne kadar sürüyor? Eski bir indeks, artık var olmayan kod hakkında kendinden emin yanıtlar verir. | Bir yeniden adlandırmayı commit'leyin, sonra hem yeni hem eski adı arayın. |
| **Güvenlik ve veri işleme** | Kaynak kodunuz nerede saklanıyor, üçüncü taraflara ne gönderiliyor, eğitim için kullanılıyor mu ve bağlantıyı kestiğinizde ne siliniyor? | Veri işleme sayfasını okuyun. Rozetlere değil, adı verilen sağlayıcılara ve somut silme kurallarına bakın. |
| **İstemci başına kurulum** | Ekibinizin kullandığı her istemci için belgelenmiş bir yapılandırma var mı ve tek bir uç nokta hepsine hizmet veriyor mu? | Ekibinizin zaten kullandığı iki istemciyi bağlayın ve ikisinin süresini de ölçün. |
| **Fiyatlandırma modeli** | Fiyat herkese açık mı? Koltuk, ajan ya da çalışma alanı başına mı ödüyorsunuz ve ücretsiz katman gerçek bir deneme için yeterli mi? | Gerçek kurulumunuzu fiyatlandırın: gerçekten çalıştıracağınız ajanlar, repolar ve indekslenmiş satırlar. |
| **Kendi kodunuzda kanıt** | Bugün, satış görüşmesi yapmadan kendi reponuzda test edebiliyor musunuz? | Deneme için önce toplantı gerekiyorsa, bu da bir yanıttır. |

### İndeksin nerede durduğu

İndeksin nerede durduğu, neyi yanıtlayabildiğinden daha az önemlidir. Ajanınız bir düzenlemeyi planladığı anda doğru dosyaya, sembole ve çağıran listesine ihtiyaç duyar; bu yüzden her adayı yukarıdaki sorularla, kendi kodunuz üzerinde değerlendirin.

## 15 dakikada kendi reponuzda test edin

Her yanıtı bir bakışta puanlayabilmek için iyi bildiğiniz bir repo kullanın. Düzeltmek zorunda kaldığınız yanıtları sayın.

1. Repoyu bağlayın ve ilk aramanın sonuç döndürmesinin ne kadar sürdüğünü not edin.
2. Kodla hiçbir anahtar kelimeyi paylaşmayan kavramsal bir soru sorun; örneğin "süresi dolmuş oturumları nerede ele alıyoruz?" Alıntılanan her dosyayı ve satırı açın.
3. Bir sembolü adıyla arayın, sonra onu çağıranları sorun. Listeyi bildiklerinizle karşılaştırın.
4. Değiştirmeyi planladığınız bir fonksiyon seçin ve ona neyin bağımlı olduğunu sorun. Bu liste onun etki yarıçapıdır: bir bozulmayı yakalayacak testlerle karşılaştırın.
5. Ad yerine bir kod biçimi sorun; örneğin tüm rota işleyicileri ya da belirli bir arayüzü uygulayan tüm sınıflar.
6. Bir hata mesajı gibi birebir bir dizgeyi arayın ve her eşleşmenin gerçek olduğunu doğrulayın.
7. Küçük bir yeniden adlandırmayı commit'leyin, indeksin yetişmesini bekleyin ve iki adı da arayın.
8. Düzeltmeleri sayın. Özellik listesi ne derse desin, en az düzeltme gerektiren sunucu kazanır.

## Terimler ve tanımları

- **Kod zekası MCP sunucusu**: Kaynak kodu indeksleyen ve yapay zeka ajanlarına araç olarak sunan bir MCP sunucusu. Ajan, dosyaların tamamını isteme yapıştırmak yerine bir soru sorar ve dosya yolları ile satır numaraları içeren sıralı sonuçlar alır.
- **Kod grafı**: Sembollerin, dosyaların ve modüllerin nasıl bağlandığını gösteren bir harita: tanımlar, referanslar, çağrılar, içe aktarmalar ve kalıtım. Her dosyayı okumadan "bunu kim kullanıyor?" sorusunu yanıtlar.
- **Etki yarıçapı**: Bir sembol değiştiğinde etkilenebilecek kod: onu çağıranlar, ona bağımlı olanlar ve bunları kapsayan testler. Bunu bir düzenlemeden önce bilmek, graf aramanın tam olarak amacıdır.
- **AST araması**: Soyut sözdizimi ağacı, yani kodun ayrıştırılmış yapısı üzerinde arama. Kodu biçimine göre bulur; örneğin belirli bir dekoratöre sahip tüm fonksiyonlar. Düz metin araması bunu güvenilir biçimde yapamaz.
- **Anlamsal arama**: Embedding'ler kullanarak anlama göre arama. Kod ile soru tek bir kelimeyi bile paylaşmasa da bir açıklamaya uyan kodu bulur.
- **Tam metin araması**: Değişmez değer ya da düzenli ifade ile eşleştirme. Hata mesajları, yapılandırma anahtarları ve zaten bildiğiniz tanımlayıcılar için doğru araçtır.

## Maguyva nereye oturuyor

Maguyva, barındırılan bir kod zekası MCP sunucusudur. Bağladığınız GitHub repolarını indeksler ve ajanınıza 11 MCP aracı sunar; her sonuç dosya yoluyla birlikte gelir.

- **Arama**: Anlamsal, yapısal, graf ve tam metin araması; ayrıca sembol arama ve her soru için doğru modu seçen bir yönlendirici araç. (`intelligent_search`, `semantic_search`, `structural_search`, `text_pattern_search`, `find_symbol`, `dependency_search`, `analyze_dependencies`)
- **Diller**: 285 dil ve metin biçimi indeksleniyor: 247 tanesinde AST tabanlı yapısal arama, 282 tanesinde sembol çıkarma ve 151 tanesinde graf ilişkileri var. Derinlik dile göre değişir, kendi dillerinizi kontrol edin.
- **Güncellik**: Kod değiştikçe indeksler GitHub eşitleme işleriyle yenilenir.
- **Kurulum**: Tek bir uzak MCP uç noktası ve belgelenmiş 23 istemci için adım adım yapılandırmalar.
- **Fiyatlandırma**: Herkese açık; koltuk başına değil, çalışma alanı başına. Free planı 3 repo ve 50.000 indekslenmiş satırı kapsar; 15 dakikalık test için yeterlidir.
- **Veri işleme**: Neyin nerede saklandığı, embedding için neyin gönderildiği ve bağlantıyı kestiğinizde neyin silindiği güvenlik sayfasında yazıyor.

Repolar şu anda GitHub üzerinden bağlanıyor. Kodunuz başka bir yerdeyse, başlamadan önce uyumluluk sayfasına bakın.

- [Hızlı başlangıcı açın](https://maguyva.ai/tr/docs/quickstart)
- [Fiyatları görün](https://maguyva.ai/tr/pricing)
- [Dil yeteneklerini kontrol edin](https://maguyva.ai/tr/docs/compatibility)
- [Veri işleme ayrıntılarını okuyun](https://maguyva.ai/tr/security)