Cline kullanıcıları için

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

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.

Ücretsiz başlayın Cline kurulumunu okuyun

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

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.

// yapılandırma dosyası

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.

// aktarım

URL ile uzak bağlantı

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

// anahtar

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.

// tür

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.

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

// workflow 01

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

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.

// workflow 02

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

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.

// step 01

maguyva.ai’de bir repo dizinleyin

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

// step 02

Maguyva’yı Cline MCP ayarlarına ekleyin

cline_mcp_settings.json

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

// step 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.