# Claude Desktop tidak bisa melihat repo Anda. Berikan satu.

Canonical source: https://maguyva.ai/id/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 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.

> Tidak perlu checkout. Tanyakan ke index.

## Yang perlu diketahui soal Claude Desktop

Empat fakta khusus Claude Desktop.

### claude_desktop_config.json

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

### Bridge lokal

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

### Satu entri env

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

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

### 01. Jelaskan alur kode saat review

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

### 02. Ukur besar perubahan sebelum merencanakannya

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

### 01. Indeks repo di maguyva.ai

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

### 02. Tambahkan Maguyva ke claude_desktop_config.json

`claude_desktop_config.json`

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

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

[Panduan MCP untuk server lokal](https://modelcontextprotocol.io/docs/develop/connect-local-servers) membahas berkas konfigurasi dan log-nya lebih rinci.

## Indeks satu repo yang sudah Anda kenal.

Hubungkan Claude Desktop lewat MCP, lalu ajukan satu pertanyaan yang bisa Anda periksa.