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

Canonical source: https://maguyva.ai/tr/for-claude-desktop

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

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.

> Checkout gerekmez. Dizine sorun.

## Claude Desktop hakkında bilmeniz gerekenler

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

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

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

### Bir env girdisi

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

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

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

```text
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.

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

```text
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.

### 01. maguyva.ai’de bir repo dizinleyin

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

### 02. Maguyva’yı claude_desktop_config.json dosyasına ekleyin

`claude_desktop_config.json`

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

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

[Yerel sunucular için MCP kılavuzu](https://modelcontextprotocol.io/docs/develop/connect-local-servers) yapılandırma dosyasını ve günlüklerini daha ayrıntılı anlatır.

## Zaten bildiğiniz bir reponuzu dizinleyin.

Claude Desktop’ı MCP üzerinden bağlayın, ardından doğrulayabileceğiniz bir soru sorun.