# Claude Desktop tidak dapat melihat repo anda. Beri ia satu.

Canonical source: https://maguyva.ai/ms/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 ialah tempat ramai orang bertanya tentang kod yang tidak sedang mereka sunting: semakan, orientasi pekerja baharu, panggilan insiden. Maguyva mengindeks repo dan menyajikannya melalui MCP, jadi jawapan merujuk fail dan baris, bukan ingatan.

> Tidak perlu checkout. Tanya indeks.

## Apa yang perlu diketahui tentang Claude Desktop

Empat fakta khusus untuk Claude Desktop.

### claude_desktop_config.json

Settings → Developer → Edit Config membukanya. Pada macOS ia terletak dalam `~/Library/Application Support/Claude/`; pada Windows, dalam `%APPDATA%\Claude\`.

### Jambatan tempatan

Fail ini memulakan proses tempatan, jadi panduan ini menjalankan `@maguyva/mcp` melalui `npx`. Node.js mesti dipasang.

### Satu entri env

Jambatan membaca `MAGUYVA_API_KEY` daripada blok `env` pelayan dalam fail yang sama.

### Keluar, kemudian buka semula

Claude Desktop membaca fail ini semasa dilancarkan. Keluar sepenuhnya daripada aplikasi selepas menyunting; pelayan bermula pada pelancaran seterusnya.

## Arahan projek menetapkan hala tuju. Gunakannya.

Claude Projects menyimpan arahan dan fail yang menjadi titik permulaan setiap sembang dalam projek itu. Ia tempat yang sesuai untuk:

- Untuk siapa jawapan itu: penyemak, pekerja baharu, jurutera atas panggilan.
- Gaya rumah untuk penerangan dan ringkasan.
- Beberapa dokumen yang anda mahu dipetik, seperti gambaran keseluruhan seni bina.

Fail yang dimuat naik ialah gambaran sekejap. Sehari selepas anda memuat naiknya, repo sudah bergerak.

## Apabila kod yang ditampal tidak mencukupi

Tiga cara sembang tentang kod tersasar tanpa kod itu sendiri.

### // petikan yang ditampal menjadi lapuk

Fail yang ditampal dalam sembang minggu lalu menggambarkan kod minggu lalu. Claude menjawab dengan yakin daripada versi yang diberikan kepadanya.

### // petikan bukan sistemnya

Satu fail jarang menjawab “apa yang berlaku apabila ini gagal?” Pengendali, cubaan semula dan amaran biasanya berada dalam tiga pakej berbeza.

### // tiada checkout, tiada grep

Claude Desktop tiada salinan kerja repo anda. Tanpa alat, setiap jawapan tentang struktur bergantung pada apa yang anda ingat untuk ditampal.

## Maguyva sebagai pelayan MCP dalam Claude Desktop

Satu entri mcpServers memberi Claude:

- **11 alat merentasi repo anda yang diindeks**: carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
- **Jawapan dengan laluan fail dan nombor baris**: merentasi 285+ bahasa, jadi anda boleh menyemak setiap dakwaan.
- **Keputusan yang peka cabang**: jadi Claude menjawab tentang cabang yang anda namakan, bukan fail yang dimuat naik seseorang bulan lalu.

> Arahan projek memberitahu Claude *cara menjawab*.
> Maguyva memberi Claude *kod sebagai asas jawapan*.

## Dua aliran kerja

Soalan yang biasanya anda jawab dengan membuka IDE.

### 01. Terangkan laluan kod semasa semakan

```text
claude> apa yang berlaku selepas webhook pembayaran gagal semakan tandatangan?

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

→ Claude menjawab dengan merujuk kedua-dua baris.
[exit 0]
```

Setiap langkah jawapan menunjuk pada fail dan baris yang boleh anda buka.

### 02. Ukur saiz perubahan sebelum merancangnya

```text
claude> berapa banyak tempat yang membaca medan lama plan_code?

text_pattern_search("plan_code")
  14 padanan dalam 9 fail
dependency_search("getPlanCode", dependents)
  6 pemanggil

→ Anggaran bermula daripada kiraan, bukan tekaan.
[exit 0]
```

Berguna dalam mesyuarat perancangan, apabila tiada siapa yang membuka repo.

## Sediakan Claude Desktop

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

### 01. Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

### 02. Tambah Maguyva pada 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 pemegang tempat, mula semula dan tanya satu soalan

Tukar `mgv_xxxx` kepada kunci API anda, keluar sepenuhnya daripada Claude Desktop dan buka semula. Jika pelayan tidak muncul, baca `mcp-server-maguyva.log` dalam folder log Claude (`~/Library/Logs/Claude` pada macOS).

[Panduan MCP untuk pelayan tempatan](https://modelcontextprotocol.io/docs/develop/connect-local-servers) menerangkan fail konfigurasi dan lognya dengan lebih terperinci.

## Indeks satu repo yang anda sudah kenali.

Sambung Claude Desktop melalui MCP, kemudian tanya satu soalan yang boleh anda semak.