Langkau ke kandungan

Mula Pantas

Laluan terpantas dari sifar kepada jawapan yang disahkan: dapatkan kunci API, indeks satu repositori yang anda sudah kenali, sambungkan klien anda, dan tanya satu soalan yang anda sudah tahu jawapannya.

1. Dapatkan kunci API

#

Mula percuma — tiada kad kredit diperlukan. Kunci API anda (bermula dengan mgv_) disimpan di app.maguyva.ai.

2. Indeks repositori yang anda sudah kenali

#

Sambungkan repositori GitHub dari portal dan biarkan ia diindeks. Pilih repo kecil yang boleh anda semak dengan pantas — ini memudahkan anda nampak sama ada Maguyva benar-benar menjadikan jawapan berasaskan kod sebenar, bukannya terus cuba mengindeks seluruh kod syarikat anda pada hari pertama.

3. Sambungkan klien anda

#

Untuk Claude Code, pasang plugin Maguyva dari marketplace — jalankan setiap arahan ini di dalam Claude Code: 

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

Plugin ini mengesahkan diri menggunakan kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya dalam shell anda (direnv per-projek disyorkan, kerana kunci bersifat khusus repositori):

export MAGUYVA_API_KEY=mgv_xxxx

Bekerja dalam pasukan? Pilih skop project dalam panel yang dibuka oleh /plugin install maguyva@maguyva. Ini merekodkan plugin dalam .claude/settings.json repositori, yang anda commit; setiap rakan sepasukan masih menjalankan pemasangan sekali. Arahan /plugin dalam sesi tiada bendera --scope, jadi untuk menskripkannya, jalankan bentuk shell dari akar repositori:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

Kebanyakan klien lain (Cursor, VS Code, Devin Desktop, Zed, dan seangkatan) menyambung terus ke pelayan jarak jauh — arahkan mereka ke endpoint dengan header Bearer, tanpa memerlukan jambatan. Contohnya, .cursor/mcp.json milik Cursor:

.cursor/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Bentuk konfigurasi berbeza sedikit mengikut klien (VS Code bersarang di bawah servers dengan type: "http", Antigravity menggunakan serverUrl, Zed menggunakan context_servers). Contoh Cursor ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY yang ditunjukkan di atas; jika konfigurasi sesuatu klien memaparkan pemegang tempat mgv_xxxx sebaliknya, gantikan dengan kunci API anda. Kemudian mulakan semula klien anda. Konfigurasi tepat untuk semua 23 klien yang didokumentasikan ada dalam Panduan Pemasangan.

4. Tanya satu soalan yang anda sudah tahu jawapannya

#

Mulakan dengan "Repositori manakah yang telah saya sambungkan?" untuk sahkan sambungan, kemudian tanya satu soalan sebenar tentang repo anda yang jawapannya anda sudah tahu — seperti "Bagaimana pengesahan (authentication) dikendalikan dalam pangkalan kod ini?"

Anda sepatutnya mendapat jawapan lengkap dengan laluan fail dan nombor baris. Buka fail yang disebut dan semak sama ada jawapan itu benar-benar tepat apabila dibandingkan dengan repo sebenar. Satu jawapan teruji itu memberitahu anda lebih banyak daripada mana-mana senarai ciri — biarkan alat ini buktikan kebolehpercayaannya dahulu sebelum ia menyertai aliran kerja lalai anda.

Tiada hasil carian atau sambungan bermasalah? Semak kunci API, konfigurasi klien dan status pengindeksan repositori dalam Penyelesaian Masalah. Jika persediaan anda menggunakan jambatan, semak juga bahawa npx tersedia.

Langkah seterusnya

#

Berkaitan

Baca seterusnya