Teknik Tarifler

Günlük Maguyva MCP işleri için pratik tarifler. Her tarif araçları ve sıralamayı verir; eksiksiz bir parametre başvurusu değildir. Araç parametreleri için MCP API Başvurusu, ilk kurulum için Hızlı Başlangıç bağlantısını kullanın.

JSON blokları, MCP tools/call girdileridir. owner/repo, dal ve sembol adlarını kendi reponuzdaki değerlerle değiştirin.

Çoğu soru tek bir çağrıyla başlar. Yalnızca ilk yanıt fazla geniş veya yetersizse daha ayrıntılı bir araca geçin.

• intelligent_search — kod tabanı hakkında doğal dille sorulan bir soru için buradan başlayın. Varsayılan auto/balanced, tanım aradığı yüksek güvenle belirlenen sorguları yapısal aramaya, referans veya etki sorgularını grafa, tam eşleşme sorgularını ise metin aramasına yönlendirir. Diğer sorgular anlamsal anlamı ve dizinlenmiş metni kullanır. Dört arama yönteminin tümünü istemek için mode=hybrid veya quality=thorough ile auto kullanın; açıkça belirtilen mod, quality ayarından önce gelir.
• find_symbol — işlev, sınıf veya değişken adını zaten biliyorsanız kullanın.
• dependency_search — düzenlemeden önce ve sonra etki yarıçapını görmek için çağıranları, bağımlıları ve değişiklik etkisini bulun.
• get_task_context — tanımadığınız bir alan için görev açıklamasına bağlı, boyutu sınırlı tek bir dosya, sembol ve bağımlılık paketi alın.
• repository_context — erişilebilir repoları listeleyin veya bir repo adının nasıl çözümlendiğini inceleyin.
• operation="guidance" ile ask_maguyva — araç seçimi ve Maguyva kullanımı için yerel yardım alın; repoda değişiklik yapmaz.

Maguyva'yı MCP istemcinize ekleyin ve gerçek repo listesiyle bağlantıyı doğrulayın.

1. app.maguyva.ai içinde bir API anahtarı oluşturun (anahtarlar mgv_ ile başlar).
2. İyi bildiğiniz en az bir GitHub reposunu bağlayıp dizinleyin.
3. İstemcinizi Kurulum Kılavuzu ile yapılandırın (Claude Code eklentisi veya Cursor, VS Code, Devin Desktop, Zed ve diğerleri için doğrudan uzak sunucu bağlantısı ayarı).
4. Ajanınıza "Hangi repoları bağladım?" diye sorun; bu, kimlik doğrulamayı ve repository_context aracını uçtan uca sınar.
5. Yanıtını değerlendirebileceğiniz gerçek bir repo sorusu sorun. Dizinlenmiş ağaçtan dosya yolları ve satır numaraları görmelisiniz.

{
  "name": "repository_context",
  "arguments": {
    "action": "list"
  }
}

Anahtarlar, köprüler veya eksik repolarda mı takıldınız? Sorun Giderme.

Paylaşılan kodu değiştirmeden önce symbol haritasını ve etki yarıçapını çıkarın. Maguyva araçları repolarınızı değiştirmez; istemcinizin yerelde uygulayacağı düzenlemeyi kanıtla besler.

1. Symbol adını biliyorsanız tanımları ve kullanımları bulmak için find_symbol aracını çağırın.
2. Yalnızca görev açıklamanız varsa ("SSO ekle", "faturalandırma webhook’unu düzelt"), get_task_context veya intelligent_search ile başlayın.
3. Paylaşılan bir symbol üzerinde değişiklik yapmadan önce, bağımlı/etki analiziyle dependency_search aracını çağırın (PR tarzı etki için değişen yolları da iletebilirsiniz); böylece etki yarıçapını görürsünüz.
4. Atıf yapılan dosyaları açın (diskteki dosyalar için yerel okuma, uzak veya çapraz repo yolları için get_file) ve planı gerçek kodla doğrulayın.
5. Düzenlemeden sonra aynı sembolleri dependency_search ile verify_after_edit=true ve targets veya changed_paths kullanarak yeniden denetleyin. Bu işlem commit edilmemiş yerel değişiklikleri değil, dizine alınmış grafı okur: sonucu yeni revizyon için kanıt saymadan önce indexed_commit_sha değerini ve dizinin güncelliğini kontrol edin, ayrıca yerel testleri çalıştırın.

{
  "name": "dependency_search",
  "arguments": {
    "repository": "owner/repo",
    "target": "getCurrentUser",
    "exact_match": true,
    "analysis_type": "impact",
    "depth": "shallow",
    "include_metrics": true,
    "limit": 10
  }
}

Tüm parametreler: MCP API Başvurusu.

Varsayılan ajan döngüsü: keşfet → symbol’leri sabitle → kanıta dayanarak düzenle.

1. intelligent_search ve doğal dilli bir sorguyla başlayın ("oturum süresi nasıl doluyor", "yeniden deneme mantığı nerede").
2. İlk sonuç penceresinde çok sayıda ilgisiz sonuç varsa dil veya yol filtreleriyle daraltın. language_filter, grafı auto/hybrid kapsamından çıkarır; yalnızca grafa yönlendirilmiş bir auto sorgusu anlamsal aramaya ve metin aramasına döner. Açıkça belirtilmiş graf modu ile language_filter birlikte kullanılırsa istek reddedilir. Seçilen arama planını görmek için routing_decision.modalities_used alanını inceleyin; warnings yalnızca sunucu bir uyarı ürettiğinde bulunur.
3. Aynı belirsiz soruyu tekrar sormak yerine umut veren sonuçları find_symbol veya dependency_search ile derinleştirin.
4. get_file aracını yalnızca diskte bulunmayan belirli bir dizinlenmiş yola ihtiyacınız olduğunda kullanın.
5. Düzenlemeyi normal istemci araçlarınızda yapın. Maguyva keşif ve doğrulama içindir; yazma aracı değildir.

{
  "name": "intelligent_search",
  "arguments": {
    "repository": "owner/repo",
    "query": "How does session expiry work?",
    "limit": 5
  }
}

Bu döngünün neden çalıştığı: Nasıl Çalışır.

Araçlar işe yarar sonuç vermiyorsa sorguyu sonsuza dek yeniden yazmadan önce repo çözümleme ve dizinleme sorunlarını giderin.

1. Reponun app.maguyva.ai içinde bağlı olduğunu ve dizinlemenin tamamlandığını doğrulayın.
2. Repo dizesini kontrol edin: "owner/repo" varsayılan dalı kullanır; "owner/repo:branch" belirli bir dalı sabitler. Eşleştirme büyük/küçük harfe duyarsızdır ama fuzzy değildir; yazım hataları otomatik düzeltilmez.
3. repository_context aracını action="info" ile çağırın ve çözümleme meta verilerini (örneğin metadata.resolution_reason) inceleyin.
4. repository değerini yalnızca MCP istemciniz istek varsayılanı sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa atlayın; aksi hâlde açıkça iletin.
5. Daha belirgin bir sorguyla, find_symbol üzerinden bilinen bir symbol adıyla veya dil/yol filtresiyle yeniden deneyin. Bağlantı bozuksa Sorun Giderme bağlantısını kullanın.

{
  "name": "repository_context",
  "arguments": {
    "action": "info",
    "repository": "owner/repo:main"
  }
}

Kurulum sorunları: Sorun Giderme.

Bir anahtar birden fazla repoyu görebildiğinde doğru dizinlenmiş repoyu hedefleyin.

1. Anahtarınızın arayabildiği tam slug’ları öğrenmek için repository_context aracını action="list" ile bir kez çağırın.
2. Varsayılan olmayan bir repoya ihtiyacınızda repository değerini arama ve symbol araçlarına açıkça iletin (örneğin "owner/other-repo" veya "owner/other-repo:develop").
3. Ayrı çağrılarda repoları özellikle karşılaştırmıyorsanız bir soru = bir repo kuralını koruyun.
4. Dosya, geçerli çalışma ağacınız olmayan dizinlenmiş bir repodaysa get_file aracını kullanın.
5. Unutmayın: araçlar GitHub’a geri yazmaz; çoklu repo bağlamı yalnızca okuma ve planlama içindir.

Repo biçimi ayrıntıları: MCP API Başvurusu.

• Hızlı Başlangıç — anahtar, dizin, bağlantı ve değerlendirebileceğiniz ilk yanıt
• Kurulum Kılavuzu — istemciye özel MCP yapılandırması
• MCP API Başvurusu — her araç ve her parametre
• Sorun Giderme — API anahtarı, köprü ve repo sorunları