# Cline harekete geçmeden önce plan yapar. Plana bir harita verin.

Canonical source: https://maguyva.ai/tr/for-cline

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

Cline dosyaları okur, komutları çalıştırır ve bir şeyi değiştirmeden önce sorar. Maguyva tüm repoyu dizinler ve MCP üzerinden geri sunar; böylece Plan modu bir dizin listesinden değil, gerçek çağrı noktalarından başlar.

> Nasıl çalışılacağı için .clinerules. Kodun şu an ne dediği için Maguyva.

## Cline hakkında bilmeniz gerekenler

Cline’a özgü dört gerçek.

### cline_mcp_settings.json

Cline panelindeki MCP Servers simgesinden açın: Configure sekmesi, ardından Configure MCP Servers. Sunucular `mcpServers` altında tanımlanır.

### URL ile uzak bağlantı

Cline, Maguyva uç noktasına Streamable HTTP ile bağlanır. Yerel süreç yok, Node.js yok.

### Olduğu gibi bir başlık

Anahtar, Cline’ın kendi örneklerindeki gibi doğrudan `Authorization` başlığına girer. Ayarlar dosyası reponuzda değil, editörünüzün kullanıcı depolama alanında bulunur.

### SSE değil, streamableHttp

Girdide `"type": "streamableHttp"` satırını tutun: tür belirtilmezse Cline eski SSE’yi varsayar. Onay istemini atlamak için güvendiğiniz araçları `autoApprove` altında listeleyin.

## Cline kuralları bir çalışma sözleşmesidir. Kullanın.

```text
# .clinerules/testing.md
- Bir görevi tamamlandı olarak işaretlemeden önce test paketini çalıştır.
- Bir bağımlılık eklemeden önce sor.
```

Çalışma alanı kuralları `.clinerules/` veya `.cline/rules/` içindeki Markdown dosyalarıdır; Cline ayrıca `AGENTS.md`, `.cursorrules` ve `.windsurfrules` dosyalarını da okur. Kurallar şunlar için doğru yerdir:

- Cline’ın çalıştırması gereken komutlar.
- Frontmatter glob’u ile bir yola sınırlanan korkuluklar.
- Tekrarlamaktan bıktığınız ekip kuralları.

Kurallar Cline’a nasıl davranacağını söyler. Taşımak üzere olduğu tabloyu hangi servislerin okuduğunu söylemez.

## Kuralların ve dosya okumanın yetmediği yer

Cline’ın her seferinde bir istekle daha fazla dosya okuyarak doldurduğu üç boşluk.

### // listeden kurulan plan

Plan modu, Cline’ın o ana kadar okuduklarından akıl yürütür. Büyük bir repoda bu bir dizin ağacı ve bir avuç dosyadır; plan da bu boşlukları devralır.

### // her okuma bir gidiş dönüştür

Cline’ın yönünü bulmak için açtığı her dosya token’a ve bir model isteğine mal olur. Tanımadığı bir pakette yön bulmak, ilk düzenlemeden önce bağlam penceresinin büyük kısmını tüketebilir.

### // metin araması çağıranı değil, dizgeyi bulur

“Bunu başka kim çağırıyor?” bir graf sorusudur. Metin araması dizgeyi bulur ama gerçek çağıranları bir yorumdan, bir mock’tan ve aynı adlı bir metottan ayırmaz.

## Cline’da MCP sunucusu olarak Maguyva

Tek bir mcpServers girdisi Cline’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 plan gerçek dosyalara atıf yapar.
- **Yalnızca okuyan araçlar**: Maguyva araçları dizini sorgular. Hiçbiri dosyalarınızı düzenlemez.

> Cline kuralları Cline’a *nasıl çalışacağını* söyler.
> Maguyva Cline’a *plan yapacağı bir harita* verir.

## İki iş akışı

Haritaya göre planlayın, sonra harekete geçin.

### 01. Değişikliği gerçek çağrı noktalarından planlayın

```text
cline plan> oturum yenilemeyi auth paketine taşı

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Act modu başlamadan plan üç çağrı noktasını listeler.
[exit 0]
```

Plan dokunacağı her dosyayı adıyla sayar; siz bir önseziyi değil, bir listeyi onaylarsınız.

### 02. Test fixture’ını değil, gerçek uygulamayı bulun

```text
cline> kıst faturalandırmayı nasıl hesaplıyoruz?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← uygulama
  test/billing/proration.spec.ts:7   ← fixture

→ Cline altı dosya yerine bir dosya okur.
[exit 0]
```

Sıralı sonuçlar uygulamayı, aynı adı taşıyan fixture’ın üstüne koyar.

## Cline’da 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ı Cline MCP ayarlarına ekleyin

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 03. Yer tutucuyu değiştirin ve bir soru sorun

`mgv_xxxx` değerini API anahtarınızla değiştirip dosyayı kaydedin. Yanıtını zaten bildiğiniz bir soru sorun, ardından alıntılanan dosyayı açın.

Cline’ın [MCP belgeleri](https://docs.cline.bot/mcp/mcp-overview) uzak sunucuları, zaman aşımlarını ve otomatik onayı anlatır.

## Zaten bildiğiniz bir reponuzu dizinleyin.

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