Untuk pengguna Cline

Cline merencanakan sebelum bertindak. Beri rencananya sebuah peta.

Cline membaca berkas, menjalankan perintah, dan bertanya sebelum mengubah apa pun. Maguyva mengindeks seluruh repo dan menyajikannya kembali lewat MCP, jadi Plan mode berangkat dari call site nyata, bukan dari daftar direktori.

Mulai gratis Baca setup Cline-nya

Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.

Pakai .clinerules untuk cara bekerja. Pakai Maguyva untuk isi kode saat ini.

Yang perlu diketahui soal Cline

Empat fakta khusus Cline.

// berkas konfigurasi

cline_mcp_settings.json

Buka dari ikon MCP Servers di panel Cline: tab Configure, lalu Configure MCP Servers. Server ditaruh di bawah mcpServers.

// transport

Jarak jauh, lewat URL

Cline terhubung ke endpoint Maguyva lewat Streamable HTTP. Tanpa proses lokal, tanpa Node.js.

// kunci

Header apa adanya

Kunci langsung masuk ke header Authorization, seperti di contoh Cline sendiri. Berkas pengaturannya ada di penyimpanan pengguna editor Anda, bukan di repo Anda.

// tipe

streamableHttp, bukan SSE

Pertahankan "type": "streamableHttp" di entri: tanpa tipe, Cline menganggapnya SSE lama. Daftarkan alat yang Anda percayai di autoApprove untuk melewati prompt persetujuannya.

Aturan Cline adalah kesepakatan kerja. Pakai itu.

# .clinerules/testing.md
- Jalankan test suite sebelum menandai tugas selesai.
- Tanya dulu sebelum menambah dependensi.

Aturan workspace adalah berkas Markdown di .clinerules/ atau .cline/rules/; Cline juga membaca AGENTS.md, .cursorrules, dan .windsurfrules. Aturan adalah tempat yang tepat untuk:

Perintah yang harus dijalankan Cline.
Pagar pembatas yang dicakup ke satu path lewat glob di frontmatter.
Konvensi tim yang sudah bosan Anda ulangi.

Aturan memberi tahu Cline cara berperilaku. Aturan tidak memberi tahu layanan mana saja yang membaca tabel yang akan dipindahkannya.

Saat aturan dan pembacaan berkas tidak cukup

Tiga celah yang diisi Cline dengan membaca lebih banyak berkas, satu permintaan per kali.

// rencana dari sebuah daftar

Plan mode bernalar dari apa yang sudah dibaca Cline sejauh ini. Di repo besar itu berarti pohon direktori dan segelintir berkas, dan rencananya mewarisi celah tersebut.

// setiap pembacaan adalah satu perjalanan bolak-balik

Setiap berkas yang dibuka Cline untuk orientasi menghabiskan token dan satu permintaan model. Orientasi di package yang belum dikenal bisa memakan sebagian besar jendela konteks sebelum edit pertama.

// pencarian teks menemukan string, bukan pemanggil

“Siapa lagi yang memanggil ini?” adalah pertanyaan graf. Pencarian teks menemukan string-nya; ia tidak memisahkan pemanggil sungguhan dari komentar, mock, dan method bernama sama.

Maguyva sebagai server MCP di Cline

Satu entri mcpServers memberi Cline:

11 alat di atas repo yang terindeks pencarian semantik, struktural (AST), graf, dan teks, ditambah pencarian simbol, dependen, dan pengambilan berkas.
Jawaban dengan jalur berkas dan nomor baris di 285+ bahasa, jadi rencana mengutip berkas nyata.
Alat yang hanya membaca Alat Maguyva menanyai index. Tidak satu pun mengedit berkas Anda.

Aturan Cline memberi tahu Cline cara bekerja.
Maguyva memberi Cline peta untuk menyusun rencana.

Dua alur kerja

Rencanakan berdasarkan peta, lalu bertindak.

// workflow 01

Rencanakan perubahan dari call site nyata

cline plan> pindahkan session refresh ke package auth

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

→ Rencana mendaftar tiga call site sebelum Act mode dimulai.
[exit 0]

Rencana menyebut setiap berkas yang akan disentuhnya, jadi yang Anda setujui adalah daftar, bukan firasat.

// workflow 02

Temukan implementasi sungguhan, bukan test fixture

cline> bagaimana kita menghitung proration?

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

→ Cline membaca satu berkas, bukan enam.
[exit 0]

Hasil berperingkat menaruh implementasi di atas fixture yang bernama sama.

Setup di Cline

Tiga langkah. Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.

// step 01

Indeks repo di maguyva.ai

Pilih yang sudah Anda kenal, agar Anda dapat menilai jawabannya.

// step 02

Tambahkan Maguyva ke setting MCP Cline

cline_mcp_settings.json

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

// step 03

Ganti placeholder dan ajukan satu pertanyaan

Ganti mgv_xxxx dengan kunci API Anda lalu simpan berkasnya. Ajukan satu pertanyaan yang jawabannya sudah Anda ketahui, lalu buka berkas yang dikutip.