Untuk pengguna Claude Desktop

Claude Desktop tidak bisa melihat repo Anda. Berikan satu.

Claude Desktop adalah tempat banyak orang bertanya soal kode yang sedang tidak mereka edit: review, onboarding, panggilan insiden. Maguyva mengindeks repo dan menyajikannya lewat MCP, jadi jawabannya mengutip berkas dan baris, bukan ingatan.

Mulai gratis Baca setup Claude Desktop-nya

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

Tidak perlu checkout. Tanyakan ke index.

Yang perlu diketahui soal Claude Desktop

Empat fakta khusus Claude Desktop.

// berkas konfigurasi

claude_desktop_config.json

Settings → Developer → Edit Config membukanya. Di macOS letaknya di ~/Library/Application Support/Claude/; di Windows, di %APPDATA%\Claude\.

// transport

Bridge lokal

Berkas ini menjalankan proses lokal, jadi panduan ini menjalankan @maguyva/mcp lewat npx. Node.js harus terpasang.

// kunci

Satu entri env

Bridge membaca MAGUYVA_API_KEY dari blok env milik server di berkas yang sama.

// restart

Tutup, lalu buka lagi

Claude Desktop membaca berkas ini saat dijalankan. Tutup aplikasinya sepenuhnya setelah mengedit; server mulai berjalan saat aplikasi dibuka berikutnya.

Instruksi proyek menetapkan arahannya. Pakai itu.

Claude Projects menyimpan instruksi dan berkas yang menjadi titik awal setiap chat di proyek tersebut. Projects adalah tempat yang tepat untuk:

Untuk siapa jawabannya: reviewer, karyawan baru, engineer yang sedang on-call.
Gaya penulisan untuk penjelasan dan ringkasan.
Beberapa dokumen yang ingin dikutip, seperti gambaran umum arsitektur.

Berkas yang diunggah adalah snapshot. Sehari setelah Anda mengunggahnya, repo sudah bergerak.

Saat kode yang ditempel tidak cukup

Tiga cara obrolan soal kode melenceng tanpa kodenya.

// potongan yang ditempel jadi basi

Berkas yang ditempel ke chat minggu lalu menggambarkan kode minggu lalu. Claude menjawab dengan yakin dari versi yang diberikan kepadanya.

// potongan bukan sistemnya

Satu berkas jarang menjawab “apa yang terjadi kalau ini gagal?” Handler, retry, dan alert biasanya berada di tiga package berbeda.

// tanpa checkout, tanpa grep

Claude Desktop tidak punya working copy repo Anda. Tanpa alat, setiap jawaban soal struktur bergantung pada apa yang Anda ingat untuk ditempel.

Maguyva sebagai server MCP di Claude Desktop

Satu entri mcpServers memberi Claude:

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 Anda bisa memeriksa setiap klaim.
Hasil yang memperhitungkan branch jadi Claude menjawab soal branch yang Anda sebut, bukan berkas yang diunggah seseorang bulan lalu.

Instruksi proyek memberi tahu Claude cara menjawab.
Maguyva memberi Claude kode sebagai dasar jawaban.

Dua alur kerja

Pertanyaan yang biasanya Anda jawab dengan membuka IDE.

// workflow 01

Jelaskan alur kode saat review

claude> apa yang terjadi setelah webhook pembayaran gagal di pemeriksaan signature?

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

→ Claude menjawab dengan mengutip kedua baris.
[exit 0]

Setiap langkah jawaban menunjuk ke berkas dan baris yang bisa Anda buka.

// workflow 02

Ukur besar perubahan sebelum merencanakannya

claude> ada berapa tempat yang membaca field lama plan_code?

text_pattern_search("plan_code")
  14 kecocokan di 9 berkas
dependency_search("getPlanCode", dependents)
  6 pemanggil

→ Estimasi berangkat dari hitungan, bukan tebakan.
[exit 0]

Berguna di rapat perencanaan, saat tidak ada yang membuka repo.

Setup di Claude Desktop

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 claude_desktop_config.json

claude_desktop_config.json

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

// step 03

Ganti placeholder, restart, dan ajukan satu pertanyaan

Ganti mgv_xxxx dengan kunci API Anda, tutup Claude Desktop sepenuhnya, lalu buka kembali. Jika server tidak muncul, baca mcp-server-maguyva.log di folder log Claude (~/Library/Logs/Claude di macOS).