Claude Desktop kullanıcıları için

Claude Desktop reponuzu göremez. Ona bir tane verin.

Claude Desktop, birçok kişinin o an düzenlemediği kod hakkında soru sorduğu yerdir: incelemeler, işe alıştırma, olay görüşmeleri. Maguyva repoyu dizinler ve MCP üzerinden sunar; böylece yanıtlar hafızaya değil, dosyalara ve satırlara atıf yapar.

Ücretsiz başlayın Claude Desktop kurulumunu okuyun

Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

Checkout gerekmez. Dizine sorun.

Claude Desktop hakkında bilmeniz gerekenler

Claude Desktop’a özgü dört gerçek.

// yapılandırma dosyası

claude_desktop_config.json

Settings → Developer → Edit Config ile açılır. macOS’ta ~/Library/Application Support/Claude/ içinde, Windows’ta %APPDATA%\Claude\ içinde bulunur.

// aktarım

Yerel köprü

Bu dosya yerel süreçleri başlatır, bu yüzden kılavuz @maguyva/mcp paketini npx ile çalıştırır. Node.js kurulu olmalıdır.

// anahtar

Bir env girdisi

Köprü MAGUYVA_API_KEY değerini aynı dosyadaki sunucunun env bloğundan okur.

// yeniden başlatma

Kapatın, sonra yeniden açın

Claude Desktop dosyayı açılışta okur. Düzenledikten sonra uygulamayı tamamen kapatın; sunucu bir sonraki açılışta başlar.

Proje talimatları çerçeveyi belirler. Kullanın.

Claude Projects, projedeki her sohbetin başlangıçta aldığı talimatları ve dosyaları tutar. Şunlar için doğru yerdir:

Yanıtların kime yönelik olduğu: bir gözden geçiren, yeni bir ekip üyesi, nöbetçi bir mühendis.
Açıklamalar ve özetler için kurum içi üslup.
Alıntılanmasını istediğiniz birkaç belge, örneğin bir mimari genel bakış.

Yüklenen dosyalar bir anlık görüntüdür. Siz yükledikten bir gün sonra repo çoktan ilerlemiştir.

Yapıştırılan kodun yetmediği yer

Kod olmadan kod hakkındaki bir sohbetin ters gitmesinin üç yolu.

// yapıştırılan parçalar bayatlar

Geçen hafta sohbete yapıştırılan bir dosya geçen haftanın kodunu anlatır. Claude kendisine verilen sürümden kendinden emin bir şekilde yanıt verir.

// parça sistemin kendisi değildir

Tek bir dosya “bu başarısız olursa ne olur?” sorusunu nadiren yanıtlar. Handler, yeniden deneme ve uyarı genellikle üç farklı pakette bulunur.

// checkout yoksa grep de yok

Claude Desktop’ın reponuzun bir çalışma kopyası yoktur. Bir araç olmadan yapıyla ilgili her yanıt, yapıştırmayı hatırladıklarınıza bağlıdır.

Claude Desktop’ta MCP sunucusu olarak Maguyva

Tek bir mcpServers girdisi Claude’a şunları verir:

Dizinlenmiş reponuz üzerinde 11 araç anlamsal, yapısal (AST), graf ve metin araması; ayrıca sembol arama, bağımlılar ve dosya alma.
Dosya yolları ve satır numaralarıyla yanıtlar 285+ dilde; böylece her iddiayı kontrol edebilirsiniz.
Dal farkında sonuçlar böylece Claude, geçen ay birinin yüklediği bir dosya hakkında değil, sizin belirttiğiniz dal hakkında yanıt verir.

Proje talimatları Claude’a nasıl yanıt vereceğini söyler.
Maguyva Claude’a yanıtını dayandıracağı kodu verir.

İki iş akışı

Normalde bir IDE açarak yanıtlayacağınız sorular.

// workflow 01

Bir inceleme sırasında kod yolunu açıklayın

claude> bir ödeme webhook’u imza kontrolünden geçemezse sonra ne olur?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude iki satırı da alıntılayarak yanıt verir.
[exit 0]

Yanıtın her adımı, açabileceğiniz bir dosyayı ve satırı gösterir.

// workflow 02

Planlamadan önce bir değişikliğin boyutunu ölçün

claude> eski plan_code alanını kaç yer okuyor?

text_pattern_search("plan_code")
  9 dosyada 14 eşleşme
dependency_search("getPlanCode", dependents)
  6 çağıran

→ Tahmin bir sezgiyle değil, bir sayıyla başlar.
[exit 0]

Kimsenin repoyu açık tutmadığı bir planlama toplantısında işe yarar.

Claude Desktop’ta kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

// step 01

maguyva.ai’de bir repo dizinleyin

Yanıtları değerlendirebilmek için zaten bildiğiniz birini seçin.

// step 02

Maguyva’yı claude_desktop_config.json dosyasına ekleyin

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

Yer tutucuyu değiştirin, yeniden başlatın ve bir soru sorun

mgv_xxxx değerini API anahtarınızla değiştirin, Claude Desktop’ı tamamen kapatıp yeniden açın. Sunucu görünmezse Claude’un günlük klasöründeki (macOS’ta ~/Library/Logs/Claude) mcp-server-maguyva.log dosyasını okuyun.