Untuk pengguna Claude Desktop

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

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.

Mula percuma Baca persediaan Claude Desktop

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

Tidak perlu checkout. Tanya indeks.

Apa yang perlu diketahui tentang Claude Desktop

Empat fakta khusus untuk Claude Desktop.

// fail konfigurasi

claude_desktop_config.json

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

// pengangkutan

Jambatan tempatan

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

// kunci

Satu entri env

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

// mula semula

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.

// workflow 01

Terangkan laluan kod semasa semakan

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.

// workflow 02

Ukur saiz perubahan sebelum merancangnya

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.

// step 01

Indeks repo di maguyva.ai

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

// step 02

Tambah Maguyva pada 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 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).